クライアント資格情報の取得 retrieve-client-credentials

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

リクエスト request

HTTP
パス
/o/client/register
メソッド
投稿する
Body パラメーター
software_statement
登録済みアプリケーションに関連付けられているソフトウェアステートメントが、Adobe Pass TVE Dashboardから作成およびダウンロードされました。

登録アプリケーションの管理については、動的クライアント登録の概要のドキュメントを参照してください。
必須
redirect_uri
認証フローが完了したときにユーザーエージェントが移動する場所に関連付けられたリダイレクト URI。
オプション
ヘッダー
コンテンツタイプ
送信されるリソースの許可されたメディアタイプ。

application/json;charset=utf-8である必要があります。
必須
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 6-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 25-bgcolor-#deebff layout-auto html-authored
属性
client_id クライアントアプリケーションのID文字列。 必須
client_secret クライアントアプリケーションの秘密文字列。 必須
client_id_issued_at クライアント アプリケーション IDが発行された時刻。 必須
redirect_uris クライアントアプリケーションがリダイレクトベースのフローで使用できるリダイレクト URI文字列の配列。 必須
grant_types クライアントアプリケーションがクライアントトークンエンドポイントに使用できる付与タイプ文字列。 必須
範囲 クライアントアプリケーションが使用できるAdobe Pass認証APIを定義するスコープ文字列。 必須
必須

エラー 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_redirect_uri リクエストには、無効なリダイレクト URIの値が含まれています。
invalid_software_statement リクエストには、無効なソフトウェアステートメントの値が含まれています。
unapproved_software_statement このリクエストには、Adobe Pass Authentication Serverによる使用が承認されていないソフトウェアステートメントの値が含まれています。
必須

サンプル samples

クライアント資格情報の取得 samples-retrieve-client-credentials

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

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

{
    "software_statement": "eyJhbGciOiJSUzI1NiJ9.
        eyJzb2Z0d2FyZV9pZCI6IjROUkIxLTBYWkFCWkk5RTYtNVNNM1IiLCJjbGll
        bnRfbmFtZSI6IkV4YW1wbGUgU3RhdGVtZW50LWJhc2VkIENsaWVudCIsImNs
        aWVudF91cmkiOiJodHRwczovL2NsaWVudC5leGFtcGxlLm5ldC8ifQ.
        GHfL4QNIrQwL18BSRdE595T9jbzqa06R9BT8w409x9oIcKaZo_mt15riEXHa
        zdISUvDIZhtiyNrSHQ8K4TvqWxH6uJgcmoodZdPwmWRIEYbQDLqPNxREtYn0
        5X3AR7ia4FRjQ2ojZjk5fJqJdQ-JcfxyhK-P8BAWBd6I2LLA77IG32xtbhxY
        fHX7VhuU5ProJO8uvu3Ayv4XRhLZJY4yKfmyjiiKiPNe-Ia4SMy_d_QSWxsk
        U5XIQl5Sa2YRPMbDRXttm2TfnZM1xx70DoYi8g6czz-CPGRi4SW_S2RKHIJf
        IjoI3zTJ0Y2oe0_EJAiXbL6OyF9S5tKxDXV8JIndSA",
    "redirect_uri": "adobepass://com.programmer"
 }
応答 – 成功
code language-https
HTTP/1.1 201 Created

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

{
    "client_id": "s6BhdRkqt3",
    "client_secret": "t7AkePiru4",
    "redirect_uris": [
        "app://com.programmer.adobe#sdasdsadas"
    ],
    "grant_types": [
        "client_credentials"
    ],
    "scopes": [
        "api:client:v2"
    ],
    "client_id_issued_at": 1723227212
}
応答 – エラー
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