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. |