ドキュメントAdobe PassAdobe Pass 認証

認証トークンの取得 retrieve-authentication-token

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。
NOTE
REST API の実装には、 スロットルメカニズムという制限があります。

REST API エンドポイント clientless-endpoints

< レジストリ_FQDN>:

<SP_FQDN>:

説明 description

認証（AuthN） トークンを取得します。

エンドポイント
呼び出
元
入力
パラメーター
HTTP
メソッド
応答
HTTP
Response
<SP_FQDN>/api/v1/tokens/authn

例：

<SP_FQDN>/api/v1/tokens/authn
ストリーミングアプリ

プログラマ

サービス
1. リクエスター（必須）
2. deviceId （必須）
3. device_info/X-Device-Info （必須）
4. deviceType （非推奨）
5. deviceUser （非推奨）
6. appId （非推奨）
GET
失敗した場合に認証情報またはエラーの詳細を含む XML または JSON。
200 – 成功。
404 - トークンが見つかりません
410 - トークンの有効期限が切れています
入力パラメーター
説明
要求者
この操作が有効なプログラマ requestorId です。
deviceId
デバイス ID のバイト。
device_info/

X-Device-Info
ストリーミングデバイス情報。

注意：これは device_info を URL パラメーターとして渡す場合がありますが、このパラメーターの潜在的なサイズとGET URL の長さに関する制限により、http ヘッダーで X-Device-Info として渡す必要があります。

詳しくは、「デバイスと接続情報の受け渡し を参照してください。
deviceType
デバイスタイプ（Roku、PC など）。

注意：このパラメーターは device_info に置き換えられます。
deviceUser
デバイスユーザー識別子。

注意：使用する場合、deviceUser は 登録コードの作成リクエストと同じ値を持つ必要があります。
appId
アプリケーション ID/名前。

注意：このパラメーターは device_info に置き換えられます。 appId を使用する場合は、 登録コードの作成リクエストと同じ値を指定する必要があります。

応答のサンプル response

成功

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authentication>
         <expires>1601114932000</expires>
         <userId>sampleUserId</userId>
         <mvpd>sampleMvpdId</mvpd>
         <requestor>sampleRequestor</requestor>
    </authentication>

JSON:

    {
         "requestor": "sampleRequestor",
         "mvpd": "sampleMvpdId",
         "userId": "sampleUserId",
         "expires": "1601114932000"
    }

認証トークンが見つかりません：

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>404</status>
        <message>Not found</message>
    </error>

JSON:

    {
        "status": 404,
        "message": "Not Found"
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b