Nintendo Switch
POST/external/switchauth
Request an access token on behalf of a Nintendo Switch user. To use this endpoint you will need to setup some additional settings prior to being able to authenticate Nintendo Switch users. Head here for these instructions. A Successful request will return an Access Token Object.
Request
Error Codes
Status Code | Error Ref | Description |
---|---|---|
401 | 11035 | The NSA ID token was invalid/malformed. |
401 | 11036 | The NSA ID token is not valid yet. |
401 | 11037 | The NSA ID token has expired. You should request another token from the Switch SDK and ensure it is delivered to mod.io before it expires. |
401 | 11039 | mod.io was unable to validate the credentials with Nintendo Servers. |
403 | 11040 | The application ID for the Nintendo Switch title has not been configured, this can be setup in the 'Options' tab within your game profile. |
403 | 11041 | The application ID of the originating Switch title is not permitted to authenticate users. Please check the Switch application id submitted on your games' 'Options' tab and ensure it is the same application id of the Switch title making the authentication request. |
403 | 11074 | The user has not agreed to the mod.io Terms of Use. Please see terms_agreed parameter description and the [Terms](/restapi/docs/terms) endpoint for more information. |
Responses
- 200
- 401
- 403
Successful Request
The NSA ID token was invalid/malformed.
The application ID for the Nintendo Switch title has not been configured, this can be setup in the 'Options' tab within your game profile.