Connect/v2/oauth/token

Connect v2 OAuth Token

Endpoint Description

Retrieve an OAuth authentication token that grants access to the Takeuchi API(s) using valid client credentials. This endpoint and parameters maybe updated to be more compliant. Insert the authentication token into the header of other API requests.

Request Information

URI

POSThttps://auth.takeuchi-us.com/Connect/v2/oauth/token

URI Parameters

None (Empty)

Header Parameters

No additional headers required.

Body Parameters

Client identification credentials.

Client v2

Name	Description	Type	Additional Information
grant_type	Grant type must be "client_credentials" in order to access resources under the control of the client.	string	Required
client_id	Client identifier is a unique string representing the client. Both the client ID & secret are used for client authentication.	string	Required
client_secret	Client secret is unique string paired with the identifier. Both the client ID & secret are used for client authentication.	string	Required
scope	The scope of access request, it can be a space delimited value. Using "any" will grant all available permissions to token.	string	Required

Request Formats

{
  "grant_type": "sample string 1",
  "client_id": "sample string 2",
  "client_secret": "sample string 3",
  "scope": "sample string 4"
}

<Client xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="Takeuchi.Connect.v2">
  <client_id>sample string 2</client_id>
  <client_secret>sample string 3</client_secret>
  <grant_type>sample string 1</grant_type>
  <scope>sample string 4</scope>
</Client>

grant_type=value&client_id=value&client_secret=value&scope=value

Response Information

Resource Description

A time limited authentication token for client use.

Token v2

Name	Information	Type
token_type	The type of the access token.	string
expires_in	The lifespan of the token to access resources.	integer
access_token	The token that is the credentials to access protected resources.	string

Response Formats

{
  "token_type": "sample string 1",
  "expires_in": 2,
  "access_token": "sample string 3"
}

<Token xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="Takeuchi.Connect.v2">
  <access_token>sample string 3</access_token>
  <expires_in>2</expires_in>
  <token_type>sample string 1</token_type>
</Token>

Return