Oauth2 API › OAuth 2

Issues an access token to access the resources of a user. The access token is valid for 25 hours. The "client_credentials" and “refresh_token” grant types are currently supported. The client makes a request by adding the following parameters using the "application/x-www-form-urlencoded" content type. The request-body is using parameters, but the HTTP response is using the "application/json" media type.

Resource URL

https://api.toornament.com/oauth/v2/token

Query Parameters

This endpoint does not have any query parameters.

Request Body

User application credentials.

Example

grant_type=client_credentials&client_id=s6BhdRkqt3&client_secret=7Fjfp0ZBr1KtDRbnfVdmIw

Structure

• grant_type

  string

  The OAuth 2 grant type requested.

  Possible values: client_credentials, refresh_token

• client_id

  string

  The client ID of the application.

  Example: "s6BhdRkqt3"

• client_secret

  string

  The client secret of the application.

  Example: "7Fjfp0ZBr1KtDRbnfVdmIw"

• scope

  string|null

  Optional

  The scopes that the token has access to.

Response

[200] An access token is issued.

Example

{
    "access_token": "TUzZDcxYWQxZmYNTU.0ZTg2M2My...",
    "expires_in": 90000,
    "token_type": "bearer",
    "scope": null,
    "refresh_token": "OWIwmug9m_kJyXDqgFP3ufBHdpp..."
}

Structure (object)

• access_token

  string

  The requested access token.

  Example: "TUzZDcxYWQxZmYNTU.0ZTg2M2My..."

• expires_in

  integer

  The number of seconds before the access token expires.

  Example: 90000

• token_type

  string

  The type of access token returned. For the moment, limited to "bearer".

  Possible values: bearer

• scope

  string|null

  The scopes that the token has access to.

• refresh_token

  string

  Optional

  The requested refresh token.

  Example: "OWIwmug9m_kJyXDqgFP3ufBHdpp..."