🔒 Generate Token

POST

/authorization/sessiontoken

Generate a session token for the account associated with the login link obtained through the authorization link.

Caution

502 response codes should be treated with caution! It means something went wrong while trying to authenticate with Nintendo.
Please read the section handling 502 responses for more information.

Authorization

API Key string required

Request

Body required

Requires the login link obtained through the /authorization/link endpoint and the verifier associated with the login link

Example

{
  "loginLink": "",
  "verifier": ""
}

Schema

Object

• loginLink*stringLogin link obtained from the authorization link
• verifier*stringVerifier associated with the login link

Test

Fill Example

Reset

Response

200

Success

Example

{
  "error": false,
  "data": {
    "sessionToken": "eyJhbGciOiJIUzI1NiJ9..."
  }
}

Schema

Object

• errorboolean
• object

  • sessionTokenstringSession token used to make queries

400

Bad Request

Example

{
  "error": true,
  "message": "Missing required body field"
}

Schema

Object

• errorboolean
• messagestring

401

Unauthorized

Example

{
  "error": true,
  "message": "Invalid authorization"
}

Schema

Object

• errorboolean
• messagestring

502

Bad Gateway

Example

{
  "error": true,
  "message": {
    "nintendoResponse": {
      "error_description": "The provided session_token_code is expired",
      "error": "invalid_request"
    }
  }
}

Schema

Object

• errorboolean
• object

  • object

    • error_descriptionstring
    • errorstring

Handling 502 Responses

When something goes wrong while trying to authenticate with Nintendo, you will receive a 502 response code, alongside a JSON object with information about where the process failed. It is important to understand how to handle these responses correctly.

Caution

Refrain from repeating the request with the same data until the issue is resolved!

The JSON object you receive will contain a nintendoResponse field inside of the message object, which will tell you why the process failed.

• The provided session_token_code is expired

  The login link has expired. You will have to generate a new login link and verifier to generate a new session token.

• The provided session_token_code is invalid

  The session token code inside the login link has been modified or the verifier does not belong to the login link. Make sure you are using the correct verifier and associated login link.

• The request does not satisfy the schema

  The verifier has been modified. Make sure you are using the original verifier.

Aditional Notes

• Session tokens are valid for two years. After that, a new session token will have to be generated.

• Session tokens can be revoked from the login history on the Nintendo Account website.