アクセストークンの取得 retrieve-access-token

IMPORTANT
このページのコンテンツは、情報提供のみを目的として提供されています。 このAPIを使用するには、Adobeの現在のライセンスが必要です。 無断使用は認められません。
IMPORTANT
動的クライアント登録APIの実装は、​ スロットル メカニズム ​のドキュメントによって制限されています。

リクエスト request

HTTP
パス
/o/client/token
メソッド
投稿する
Body パラメーター
client_id
クライアントアプリケーションのID文字列。

クライアント ID文字列の取得方法について詳しくは、 クライアント資格情報の取得 API ドキュメントを参照してください。
必須
client_secret
クライアントアプリケーションの秘密文字列。

クライアント秘密文字列の取得方法について詳しくは、 クライアント資格情報の取得 API ドキュメントを参照してください。
必須
grant_type
クライアントアプリケーションがクライアントトークンエンドポイントに使用できる付与タイプ文字列(例:「client_credentials」)。

付与タイプ文字列の取得方法について詳しくは、 クライアント資格情報の取得 API ドキュメントを参照してください。
必須
ヘッダー
コンテンツタイプ
送信されるリソースの許可されたメディアタイプ。

application/x-www-form-urlencodedである必要があります。
必須
X-Device-Info
デバイス情報ペイロードの生成については、X-Device-Info ドキュメントを参照してください。

アプリケーションのデバイスプラットフォームで有効な値の明示的なプロビジョニングが可能な場合は、必ず使用することを強くお勧めします。

指定すると、Adobe Pass認証バックエンドは、明示的に設定された値と抽出された値を暗黙的に(デフォルトで)マージします。

指定しない場合、Adobe Pass認証バックエンドは、抽出された値を暗黙的に(デフォルトで)使用します。
必須
承認
クライアントアプリケーションが受け入れたメディアタイプ。

指定する場合は、application/json;charset=utf-8である必要があります。
オプション
User-Agent
クライアントアプリケーションのユーザーエージェント。
オプション

応答 response

成功 success

ヘッダー
ステータス
201
必須
コンテンツタイプ
アプリケーション/json
必須
本文

次の属性を持つJSON オブジェクト:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 1-bgcolor-#eff2f7 2-bgcolor-#eff2f7 3-bgcolor-#eff2f7 5-bgcolor-#deebff 9-bgcolor-#deebff 13-bgcolor-#deebff 17-bgcolor-#deebff 21-bgcolor-#deebff layout-auto html-authored
属性
id ユーザー活動の追跡に使用できる不透明な識別子。 必須
access_token クライアントアプリケーションが認証ヘッダーに使用する必要があるアクセストークン値。 必須
created_at アクセストークンが発行された時間(ミリ秒単位)。 必須
expires_in アクセストークンの有効期限が切れるまでの時間(秒)。 必須
token_type トークンタイプ(例:「ベアラー」)。 必須
必須

エラー error

ヘッダー
ステータス
400
必須
コンテンツタイプ
アプリケーション/json
必須
本文
エラー

使用可能な値は次のとおりです。

table 0-row-3 1-row-2 2-row-2 3-row-2 4-row-2 1-bgcolor-#eff2f7 2-bgcolor-#eff2f7 3-bgcolor-#eff2f7 5-bgcolor-#deebff 8-bgcolor-#deebff 11-bgcolor-#deebff 14-bgcolor-#deebff layout-auto html-authored
値
invalid_request

次のいずれかの理由により、リクエストは無効です:

  • リクエストに必要なパラメーターが不足しています。
  • リクエストには、サポートされていないパラメーター値(付与タイプ以外)が含まれています。
  • リクエストはパラメーターを繰り返します。
  • リクエストには複数の資格情報が含まれています。
  • リクエストは、クライアントの認証に複数のメカニズムを使用します。
  • リクエストの形式が正しくありません。
invalid_client クライアントの資格情報が無効です。クライアントは新しいクライアント資格情報を取得し、再試行する必要があります。 詳しくは、 クライアント資格情報の取得 API ドキュメントを参照してください。
unauthorized_client クライアントアプリケーションは、この承認付与タイプを使用する権限がありません。
unsupported_grant_type 認証の付与タイプは、認証サーバーでサポートされていません。
必須

サンプル samples

アクセストークンの取得 samples-retrieve-access-token

リクエスト
code language-https
POST /o/client/token HTTP/1.1

    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Content-Type: application/x-www-form-urlencoded
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

Body:

client_id=s6BhdRkqt3&client_secret=t7AkePiru4&grant_type=client_credentials
応答 – 成功
code language-https
HTTP/1.1 201 Created

Content-Type: application/json;charset=UTF-8

{
  "id": "a932f8f0-210a-41a4-b2a8-377751f6b76f",
  "access_token": "2YotnFZFEjr1zCsicMWpAA",
  "created_at": 1752148106221,
  "expires_in": 21600,
  "token_type": "bearer"
}
応答 – エラー
code language-https
HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

{ "error": "invalid_request" }
recommendation-more-help
pass-help-authentication