kamu

Polling to obtain a token for the device

post/platform/token/device

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Request body application/x-www-form-urlencoded

client_idstring required

REQUIRED. The device verification code, "device_code" from the device authorization response, defined in Section 3.2.

device_codestring required

REQUIRED if the client is not authenticating with the authorization server as described in Section 3.2.1. of RFC6749. The client identifier as described in Section 2.2 of RFC6749.

grant_typestring required

REQUIRED. Value MUST be set to "urn:ietf:params:oauth:grant-type:device_code".

Response

access token issued

access_tokenstring required

REQUIRED. The access token issued by the authorization server.

expires_ininteger required

RECOMMENDED. The lifetime in seconds of the access token. For example, the value "3600" denotes that the access token will expire in one hour from the time the response was generated. If omitted, the authorization server SHOULD provide the expiration time via other means or document the default value.

refresh_tokenstring nullable

OPTIONAL. The refresh token, which can be used to obtain new access tokens using the same authorization grant as described in Section 6.

scorestring nullable

OPTIONAL. The scope of the access request as described by Section 3.3. The requested scope MUST NOT include any scope not originally granted by the resource owner, and if omitted is treated as equal to the scope originally granted by the resource owner.

token_typestring required

REQUIRED. The type of the token issued as described in Section 7.1. Value is case insensitive.

Example response

{
  "expires_in": 3600
}

Changes

No recorded changes to this operation across all 62 revisions of this API.