ドキュメントAdobe PassAdobe Pass 認証

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

Last update: Mon Aug 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。
IMPORTANT
動的なクライアント登録 API の実装については、 スロットルメカニズムに関するドキュメントに限られています。

リクエスト request

HTTP
パス
/o/client/token
メソッド
POST
本文パラメーター
client_id
クライアントアプリケーション識別子の文字列。

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

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

付与タイプ文字列の取得方法について詳しくは、 クライアント資格情報の取得API ドキュメントを参照してください。
必須
ヘッダー
Content-Type
送信するリソースに使用できるメディアタイプ。

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

アプリケーションのデバイスプラットフォームで有効な値を明示的に指定できる場合は、常に使用することを強くお勧めします。

指定した場合、Adobe Pass認証バックエンドは、明示的に設定された値を、抽出された値と暗黙的に（デフォルトで）結合します。

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

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

応答 response

成功 success

ヘッダー
ステータス
201
必須
Content-Type
application/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 クライアントアプリケーションが Authorization ヘッダーに使用する必要があるアクセストークン値。 必須
created_at アクセストークンが発行された時間。 必須
expires_in アクセストークンの有効期限が切れるまでの時間（秒）。 必須
token_type トークンタイプ（例：「bearer」）。 必須
必須

エラー error

ヘッダー
ステータス
400
必須
Content-Type
application/json
必須
本文
エラー

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

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

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

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

サンプル 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": 1723227212,
  "expires_in": 86400,
  "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
3f5e655c-af63-48cc-9769-2b6803cc5f4b