アクセストークンの取得
このメソッドは、アクセストークンをリクエストします。
URL
http[s]://<host>:<port>/configapi/v2/oauth/token
パラメータ
| パラメータ | 必須? | 説明 |
| grant_type | 必須 | 値は client_credentials である必要があります。 |
| client_id | 必須 | ログイン ID |
| client_secret | 必須 | ユーザー API シークレット |
リクエストの例
以下の HTTP POST リクエストは、https://example.com Web サービスに対するアクセストークンをリクエストするものです。client_id は、アクセストークンを要求するアプリケーションに代わってユーザーを識別します。
POST /configapi/v2/oauth/token HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials&client_id=client-id&client_secret=qkDwDJlDfig2IpeuUZYKH1Wb8q1V0ju6sILxQQqhJ&tenant=example.com
アクセストークンのレスポンス
アクセストークンのリクエストが成功した場合のレスポンスには、以下のパラメータを含む JSON OAuth 2.0 レスポンスが含まれます。
パラメータ
| パラメータ | 説明 |
| access_token | 要求されたアクセストークンです。呼び出し元アプリケーションは、このトークンを使用して受信サービスへの認証を行うことができます。 |
| token_type | トークンのタイプの値を示します。サポートされているタイプは Bearer のみです。ベアラートークンの詳細については、The OAuth 2.0 Authorization Framework: Bearer Token Usage（RFC 6750）を参照してください。 |
| expires_in | アクセストークンの有効期間（秒単位）です。 |
応答の例
以下の例は、Web サービスへのアクセストークン取得リクエストに対する成功レスポンスを示しています。
{
"access_token":"eyJhbGciOiJSUzI1NiI5q9Jgt...6HznsvPWy7UP3MINA",
"token_type":"Bearer",
"expires_in":"3599",
}
アクセストークンを使用してリソースにアクセスする
access_token の取得に成功したら、そのトークンを Authorization ヘッダーに含めることで、Web API へのリクエストに使用することができます。RFC 6750 では、保護されたリソースにアクセスするための HTTP リクエストにおいて、ベアラートークンを使用する方法について説明されています。
リクエストの例
GET /data HTTP/1.1
Host: example.com
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbW4t