ドキュメントAdobe PassAdobe Pass 認証

（レガシー）認証トークンの取得 retrieve-authorization-token

Last update: Sat Dec 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。
IMPORTANT
製品のお知らせページに集約された最新のAdobe Pass認証製品のお知らせや廃止予定タイムラインについて、常に情報を提供するようにします。
NOTE
REST API の実装には、 スロットルメカニズムという制限があります。

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

< レジストリ_FQDN>:

<SP_FQDN>:

説明 description

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

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

例：

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

プログラマ

サービス
1. リクエスター（必須）
2. deviceId （必須）
3. resource （必須）
4. device_info/X-Device-Info （必須）
5. deviceType
6. deviceUser （非推奨）
7. appId （非推奨）
GET
1.成功
2. 認証トークン
見つからないか、期限切れです：
XML による理由
説明 authn トークン用が見つかりません
3. 認証トークン
見つかりません：
XML 説明
4. 認証トークン
期限切れ：
XML の説明
200 - Success
412 - No AuthN

404 - No AuthZ

410 - AuthZ Expired
入力パラメーター
説明
要求者
この操作が有効なプログラマ requestorId です。
deviceId
デバイス ID のバイト。
resource
resourceId （または MRSS フラグメント）を含む文字列は、ユーザーからリクエストされたコンテンツを識別し、MVPD認証エンドポイントによって認識されます。
device_info/

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

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

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

このパラメーターを正しく設定すると、ESM では、クライアントレスの使用時に デバイスタイプごとに分類される指標を提供するので、Roku、AppleTV、Xbox など、様々なタイプの分析を実行できます。

参照 パス指標でクライアントレスデバイスタイプパラメーターを使用するメリット

注意:device_info はこのパラメーターを置き換えます。
deviceUser
デバイスユーザー識別子。
appId
アプリケーション ID/名前。

注意：このパラメーターは device_info に置き換えられます。

応答のサンプル response

成功

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
        <expires>1348148289000</expires>
        <mvpd>sampleMvpdId</mvpd>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <proxyMvpd>sampleProxyMvpdId</proxyMvpd>
    </authorization>

JSON:

    {
        "mvpd": "sampleMvpdId",
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348148289000",
        "proxyMvpd": "sampleProxyMvpdId"
    }

認証トークンが見つからないか、期限切れです：

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>412</status>
        <message>User not authenticated</message>
    </error>

JSON:

    {
        "status": 412,
        "message": "User not authenticated",
        "details": null
    }

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

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",
        "details": null
    }

認証トークンの有効期限が切れました：

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>410</status>
        <message>Gone</message>
    </error>

JSON:

    {
        "status": 410,
        "message": "Gone",
        "details": null
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b