Network - Revision history

Yellows8: /* transfer */

2026-05-12T21:37:50Z

transfer

← Older revision		Revision as of 01:37, 13 May 2026
Line 296:		Line 296:
	** The json response is parsed as the following (HTTP status must be 200):		** The json response is parsed as the following (HTTP status must be 200):
	*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.		*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.

			* "/%lld/save_datas/%lld/generate_key_seed_package" / "/%lld/generate_key_seed_package":
			** The json POST data contains the following:
			*** <code>{"challenge":"%s"}</code>
			*** Where %s is the 0x10-byte challenge ([[Filesystem_services#ISaveDataTransferManagerWithDivision\|ISaveDataTransferManagerWithDivision GetChallenge]]) printed with "%02x" for each byte.
			** The response is parsed as follows (HTTP status must be 200):
			*** This is base64 decoded. The output is then later used with [[Filesystem_services#ISaveDataTransferManagerWithDivision\|ISaveDataTransferManagerWithDivision SetKeySeedPackage]].

	== Others ==		== Others ==

Yellows8: /* transfer */

2026-05-12T21:01:21Z

transfer

← Older revision		Revision as of 01:01, 13 May 2026
Line 289:		Line 289:
	*** This is parsed similar to /start above. The minimum required fields are the same as /start.		*** This is parsed similar to /start above. The minimum required fields are the same as /start.
	*** Most usage of this will return 0 instead of the Result from the request which failed, when status is the expected value and expires_at>0.		*** Most usage of this will return 0 instead of the Result from the request which failed, when status is the expected value and expires_at>0.

			* "/%lld/register_destination":
			** The json POST data contains the following:
			*** <code>{"dst_device_appearance_main":"<str0>","dst_device_appearance_controller":"<str1>"}</code>
			*** <str0>/<str1> are the same as with "/start".
			** The json response is parsed as the following (HTTP status must be 200):
			*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.

	== Others ==		== Others ==

Yellows8: /* transfer */

2026-05-12T20:02:26Z

transfer

← Older revision		Revision as of 00:02, 13 May 2026
Line 282:		Line 282:
	** The json response is parsed as the following (HTTP status must be 200):		** The json response is parsed as the following (HTTP status must be 200):
	*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.		*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.

			* "/%lld":
			** This is used following certain network requests which failed, depending on the Result. In one case it's used without a prior network request.
			** No POST data (?).
			** The json response is parsed as the following (HTTP status must be 200):
			*** This is parsed similar to /start above. The minimum required fields are the same as /start.
			*** Most usage of this will return 0 instead of the Result from the request which failed, when status is the expected value and expires_at>0.

	== Others ==		== Others ==

Yellows8: /* transfer */

2026-05-12T16:54:10Z

transfer

← Older revision		Revision as of 20:54, 12 May 2026
Line 274:		Line 274:
	** The json response is parsed as the following (HTTP status must be 201):		** The json response is parsed as the following (HTTP status must be 201):
	*** <code>{"transfer_event":{"transfer_event_id":<number>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>		*** <code>{"transfer_event":{"transfer_event_id":<number>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>
	*** The minimum required fields are status and ~~created_at~~. <status_str> must match one of various strings, such as "started".		*** The minimum required fields are status and expires_at. <status_str> must match one of various strings, such as "started".
	*** The output transfer_event_id is then used as the first "%lld" in the above URIs.		*** The output transfer_event_id is then used as the first "%lld" in the above URIs.
	*** The rest of the fields are likely only used with "nn::migration::device::*" (?).		*** The rest of the fields are likely only used with "nn::migration::device::*" (?).
Line 281:		Line 281:
	** The POST data is empty.		** The POST data is empty.
	** The json response is parsed as the following (HTTP status must be 200):		** The json response is parsed as the following (HTTP status must be 200):
	*** {...}		*** This is parsed similar to /start above. The minimum required fields are the same as /start. The rest of the output is unused.

	== Others ==		== Others ==

Yellows8: /* transfer */

2026-05-12T15:07:46Z

transfer

← Older revision		Revision as of 19:07, 12 May 2026
Line 276:		Line 276:
	*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".		*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".
	*** The output transfer_event_id is then used as the first "%lld" in the above URIs.		*** The output transfer_event_id is then used as the first "%lld" in the above URIs.
			*** The rest of the fields are likely only used with "nn::migration::device::*" (?).

	* "/%lld/%s":		* "/%lld/%s":

Yellows8: /* transfer */

2026-05-09T03:26:47Z

transfer

← Older revision		Revision as of 07:26, 9 May 2026
Line 276:		Line 276:
	*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".		*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".
	*** The output transfer_event_id is then used as the first "%lld" in the above URIs.		*** The output transfer_event_id is then used as the first "%lld" in the above URIs.

			* "/%lld/%s":
			** The POST data is empty.
			** The json response is parsed as the following (HTTP status must be 200):
			*** {...}

	== Others ==		== Others ==

Yellows8: /* transfer */

2026-05-04T21:55:15Z

transfer

← Older revision		Revision as of 01:55, 5 May 2026
Line 273:		Line 273:
	*** <str0> is the output from [[NS_services\|ns]] IApplicationManagerInterface cmd4063, <str1> is from cmd4064.		*** <str0> is the output from [[NS_services\|ns]] IApplicationManagerInterface cmd4063, <str1> is from cmd4064.
	** The json response is parsed as the following (HTTP status must be 201):		** The json response is parsed as the following (HTTP status must be 201):
	*** <code>{"transfer_event":{"transfer_event_id":<~~unknown~~>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>		*** <code>{"transfer_event":{"transfer_event_id":<number>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>
	*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".		*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".
			*** The output transfer_event_id is then used as the first "%lld" in the above URIs.

	== Others ==		== Others ==

Yellows8: /* transfer */

2025-10-07T22:16:54Z

transfer

← Older revision		Revision as of 02:16, 8 October 2025
Line 268:		Line 268:
	* "/start":		* "/start":
	** The json POST data contains the following:		** The json POST data contains the following:
	** <code>{"type":<type>,"scope":<scope>,"src_device_appearance_main":"<str0>","src_device_appearance_controller":"<str1>"}</code>		*** <code>{"type":<type>,"scope":<scope>,"src_device_appearance_main":"<str0>","src_device_appearance_controller":"<str1>"}</code>
	** <type> is 0 for local (nn::migration::device::IServer and nn::migration::savedata::IServer), 1 for Uploader (nn::migration::device::IUploader).		*** <type> is 0 for local (nn::migration::device::IServer and nn::migration::savedata::IServer), 1 for Uploader (nn::migration::device::IUploader).
	** <scope> is 0 for device (nn::migration::device::IServer and nn::migration::device::IUploader), 1 for savedata (nn::migration::savedata::IServer).		*** <scope> is 0 for device (nn::migration::device::IServer and nn::migration::device::IUploader), 1 for savedata (nn::migration::savedata::IServer).
	** <str0> is the output from [[NS_services\|ns]] IApplicationManagerInterface cmd4063, <str1> is from cmd4064.		*** <str0> is the output from [[NS_services\|ns]] IApplicationManagerInterface cmd4063, <str1> is from cmd4064.
			** The json response is parsed as the following (HTTP status must be 201):
			*** <code>{"transfer_event":{"transfer_event_id":<unknown>,"status":<status_str>,"error":<str>,"src_device_serial":<str>,"src_device_appearance_main":<str>,"dst_device_serial":<str>,"src_device_type":<unknown>,"created_at":<timestamp>,"expires_at":<timestamp>}}</code>
			*** The minimum required fields are status and created_at. <status_str> must match one of various strings, such as "started".

	== Others ==		== Others ==

Yellows8: /* transfer */

2025-10-06T16:36:21Z

transfer

← Older revision		Revision as of 20:36, 6 October 2025
Line 265:		Line 265:

	The above token is from using [[Account_services\|IManagerForSystemService EnsureIdTokenCacheAsync]], with the output from [[Account_services\|IManagerForSystemService LoadIdTokenCache]] being used as the token.		The above token is from using [[Account_services\|IManagerForSystemService EnsureIdTokenCacheAsync]], with the output from [[Account_services\|IManagerForSystemService LoadIdTokenCache]] being used as the token.

			* "/start":
			** The json POST data contains the following:
			** <code>{"type":<type>,"scope":<scope>,"src_device_appearance_main":"<str0>","src_device_appearance_controller":"<str1>"}</code>
			** <type> is 0 for local (nn::migration::device::IServer and nn::migration::savedata::IServer), 1 for Uploader (nn::migration::device::IUploader).
			** <scope> is 0 for device (nn::migration::device::IServer and nn::migration::device::IUploader), 1 for savedata (nn::migration::savedata::IServer).
			** <str0> is the output from [[NS_services\|ns]] IApplicationManagerInterface cmd4063, <str1> is from cmd4064.

	== Others ==		== Others ==

Yellows8: /* transfer */

2025-10-06T15:39:46Z

transfer

← Older revision		Revision as of 19:39, 6 October 2025
Line 256:		Line 256:
	/%lld/album_data_archives/%lld/finish_download		/%lld/album_data_archives/%lld/finish_download
	/%lld/album_data_archives		/%lld/album_data_archives

			These use the following request headers:
			User-Agent: libcurl (nnHttp; {...})
			Accept: /
			Content-Type: application/json
			Authorization: Bearer {token}
			{Content-Length as needed}

			The above token is from using [[Account_services\|IManagerForSystemService EnsureIdTokenCacheAsync]], with the output from [[Account_services\|IManagerForSystemService LoadIdTokenCache]] being used as the token.

	== Others ==		== Others ==