NTT Com Service OAuth API

Overview

We require applications to authenticate all of NTT Com API requests via API Gateway with OAuth2.0.

• OAuth

Resource URL

Please use use of global common domain , or the individual region domain .
If you want to use the global common domain , depending on the circumstances of your available points , and then connect to the nearest API gateway .¹

1.Base Path(Global Load Balance)

https://api.ntt.com/v1/oauth/accesstokens

2.Base Path(Region)

https://{region}.api.ntt.com/v1/oauth/accesstokens

• region is jp|us|uk
• e.g. https://us.api.ntt.com/v1/oauth/accesstokens

Resource Information

• #1 appropriate flow restriction

Get OAuth AccessToken

POST /v1/oauth/accesstokens

Request Parmeters

• NOTE: You should set Content-Type: application/json HTTP header with OAuth API Call

Example Request

Content-Type: application/json; charset=utf-8
Host: api.ntt.com

POST /v1/oauth/accesstokens
{
  "grantType":"client_credentials",
  "clientId":"*************",
  "clientSecret":"*************"
}

Response Parameters

Example Result

 {
   "accessToken": "[YOUR_ACCESS_TOKEN]",
   "tokenType": "BearerToken",
   "expiresIn": "3599" ,
   "scope": "READ WRITE" ,
   "issuedAt": "1407483969339"
 }

Note: Consumer Key, Consumer Secret and accessToken values SHOULD be considered as sensitive as passwords and MUST not be shared or distributed to untrusted parties in accordance with API gateway Terms of Use.

AccessToken

Set the accessToken in the Authorization request header field based on the OAuth specification.

 Authorization: Bearer [YOUR_ACCESS_TOKEN]