ドキュメントAdobe PassAdobe Pass 認証

ショートメディアトークンの取得 obtain-short-media-token

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

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

< レジストリ_FQDN>:

<SP_FQDN>:

説明 description

ショートメディアトークンを取得します。

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

または

<SP_FQDN>/api/v1/tokens/media

例：

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

プログラマ

サービス
1. リクエスター（必須）
2. deviceId （必須）
3. resource （必須）
4. device_info/X-Device-Info （必須）
5. deviceType
6. deviceUser （非推奨）
7. appId （非推奨）
GET
Base64 でエンコードされたメディアトークンを含む XML または JSON。失敗した場合は、エラーの詳細。
200 – 成功
403 – 成功なし
入力パラメーター
説明
要求者
この操作が有効なプログラマ 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 はクライアントレスの使用時に [ デバイスタイプごとに分類 ]/（help/authentication/entitlement-service-monitoring-overview.md#clientless_device_type）される指標を提供し、に対して様々なタイプの分析を実行できるようになります。 例えば、Roku、AppleTV、Xbox などです。

clientless devicetype パラメーターを使用するメリット

注意 を参照してください。device_info はこのパラメーターを置き換えます。
deviceUser
デバイスユーザー識別子。

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

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

応答のサンプル response

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <play>
        <expires>1348649569000</expires>
        <mvpdId>sampleMvpdId</mvpdId>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <serializedToken>PHNpZ25hdH[...]</serializedToken>
        <userId>sampleScrambledUserId</userId>
    </play>

JSON:

    {
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348649614000",
        "serializedToken": "PHNpZ25hdH[...]",
        "userId": "sampleScrambledUserId",
        "mvpdId": "sampleMvpdId"
    }

Media Verification Library の互換性

「短いメディアトークンの取得」呼び出しから serializedToken まるフィールドは、Base64 でエンコードされたトークンで、Adobe Medium検証ライブラリに対して検証できます。

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b