Token Endpoint

The App's Server fetches tokens.

NOTE

  1. Content-Type MUST be application/x-www-form-urlencoded;
  2. The App MUST authenticate itself, via either Secret Basic or Secret Post method;
  3. access_token is JSON Web Token;
  4. When the grant type is client_credentials, the sub payload claim of access_token is client:{client_id};
  5. Content-Type of the response is application/json;charset=UTF-8;
  6. For explanation of errors, please refer to Section 5.2 of RFC6749.

Example

Authorization Code Grant Type

grant_type: authorization_code
code: yfz_7OBH9Eektoyb70GKcRTqmnshAQuolLqNzr63Vgs.z4591d8Yg9m7-KcygngZ9kO38rpGvdde7jjHKhLDM08
redirect_uri: 'http://localhost:3846/callback'

Refresh Token Grant Type

grant_type: refresh_token
refresh_token: YU7w7bnP9dfp5-TBKTXRaPPT0BvkgSag5xHyGVVMo80.UL6_E30Zxk1F5GwQT2VzQLKr19c1HobG9MkdBDdi4LM

Client Credentials Grant Type

grant_type: client_credentials
scope: api.users:write
audience: openapi
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Form Data
string
enum
required

Grant type,
see RFC6749

ValueDescription
authorization_codeAuthorization Code
refresh_tokenRefresh Token
client_credentialsClient Credentials
Allowed:
string

The authorization code that the App received at the Authorization Endpoint, required when grant_type=authorization_code

uri

When grant_type=authorization_code, required if the redirection URL was included in the initial authorization request. The redirection URL in the token request must EXACTLY match the redirection URL that was used when generating the Authorization Code.

string

Refresh Token, required when grant_type=refresh_token.

string

Indicating accesses requested by the App, concatenate multiple scopes with ' '. Required when grant_type=client_credentials, otherwise ignored.

string

Indicating audiences requested by the App, concatenate multiple audiences with ' '. Required when grant_type=client_credentials, otherwise ignored.

string

Used by Secret Post authentication method

string

Used by Secret Post authentication method

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json