EShop: Difference between revisions
Begin overhaul |
→samurai: list most important URLs |
||
| Line 166: | Line 166: | ||
|- | |- | ||
| shop_id | | shop_id | ||
| no | | depends on the URL, usually no | ||
| Describes which eShop instance should be used. 1 indicates the 3DS eShop, 2 indicates the Wii U eShop. 3 seems to yield the same results as 2. Values greater than 3 or less than 1 are invalid. Defaults to 2 or 3 if not given. | | Describes which eShop instance should be used. 1 indicates the 3DS eShop, 2 indicates the Wii U eShop. 3 seems to yield the same results as 2. Values greater than 3 or less than 1 are invalid. Defaults to 2 or 3 if not given. | ||
| unsigned integer | | unsigned integer | ||
| Line 187: | Line 187: | ||
samurai.ctr.shop.nintendo.net (samurai) provides metadata about titles. The samurai server provides the backend for the eShop title search. | samurai.ctr.shop.nintendo.net (samurai) provides metadata about titles. The samurai server provides the backend for the eShop title search. | ||
Common parameters described above can always be sent. | |||
{| class="wikitable" border="1" | |||
|- | |||
! Path | |||
! Description | |||
! Parameters | |||
|- | |||
| /samurai/ws/'''region'''/titles | |||
| Fetches the title list, containing the content id (not the 3DS title id), the product code and the localized title name | |||
| All of these are optional. | |||
* genre[]: genre ID (unsigned int) | |||
* publisher[]: publisher ID (unsigned int) | |||
* price_min: minimum price in region currency (signed int) | |||
* price_max: maximum price in region currency (signed int) | |||
* video_format: "moflex" | |||
* freeword: keyword(s?) to look for (string) | |||
* limit: maximum results | |||
* offset: results to skip | |||
* sort: one of "new", "popular" or "score" | |||
* release_date_before: date/time title must have been released before (UNIX timestamp prefixed by +) | |||
* release_date_after: date/time title must have been released after (UNIX timestamp prefixed by -) | |||
|- | |||
| /samurai/ws/'''region'''/news | |||
| eShop news section | |||
| (none) | |||
|- | |||
| /samurai/ws/'''region'''/telops | |||
| Some kind of news? | |||
| shop_id is required | |||
|- | |||
| /samurai/ws/'''region'''/directory/'''(long long unsigned int)''' and /samurai/ws/'''region'''/directory/~'''(string)''' | |||
| (unknown) | |||
| (unknown) | |||
|- | |||
| /samurai/ws/'''region'''/title/'''content id''' | |||
| Returns information about the title, more verbose than /titles. | |||
| (none) | |||
|- | |||
| /samurai/ws/'''region'''/contents | |||
| Seems identical to /titles. | |||
| see /titles | |||
|- | |||
| /samurai/ws/'''region'''/genres | |||
| Returns a list of human-readable genre names and their corresponding genre id. | |||
| (none) | |||
|- | |||
| /samurai/ws/'''region'''/publishers | |||
| Returns a list of human-readable publisher names and their corresponding publisher id. | |||
| (none) | |||
|- | |||
| /samurai/ws/'''region'''/title/'''content id'''/aocs | |||
| Returns a list of add-on contents/downloadable content and prices in eShop region currency. | |||
| (none) | |||
|} | |||
=== ninja === | === ninja === | ||
ninja.ctr.shop.nintendo.net (ninja) contains the seeds for the new 9.6 crypto, pricing information and handles actions that require authentication, such as purchases. Authentication information seems to be obtained from the [[ACT_Services|act:u sysmodule]] and works through OAuth2. | ninja.ctr.shop.nintendo.net (ninja) contains the seeds for the new 9.6 crypto, pricing information and handles actions that require authentication, such as purchases. Authentication information seems to be obtained from the [[ACT_Services|act:u sysmodule]] and works through OAuth2. | ||