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

NOTE
このページのコンテンツは、情報提供のみを目的として提供されています。 このAPIを使用するには、Adobeの現在のライセンスが必要です。 無断使用は認められません。
IMPORTANT
製品のお知らせ ページに集計されている最新のAdobe Pass認証製品のお知らせと廃止予定について、常に情報を得てください。
NOTE
REST APIの実装は​ スロットル メカニズム ​によって制限されています

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

<REGGIE_FQDN>:

<SP_FQDN>:

説明 description

認証(AuthZ)トークンを取得します。

エンドポイント
様に呼び出されました
入力
パラメーター
HTTP
メソッド
応答
HTTP
応答
<SP_FQDN>/api/v1/tokens/authz

例:

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

または

プログラマーサービス
​1. 依頼者(必須)
2。 deviceId (必須)
3。 リソース (必須)
4。 device_info/X-Device-Info (必須)
5. deviceType
6. deviceUser (非推奨)
7。 appId (非推奨)
GET
​1. 成功
2。 認証トークン
が見つからないか、有効期限が切れています:
XMLが説明している理由
が見つかりません
3。 認証トークン
が見つかりません:
XML説明
4。 承認トークン
の有効期限:
XML説明
200 – 成功
412 - AuthNなし

404 - AuthZなし

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

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

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

詳細については、​ デバイスと接続情報の受け渡しを参照してください。
deviceType
デバイスの種類(Roku、PCなど)。

このパラメーターが正しく設定されている場合、ESMはClientlessを使用する場合に​ デバイスの種類ごとに分類される指標を提供するため、様々なタイプの分析を実行できます(Roku、AppleTV、Xboxなど)。

参照、​ パス指標でクライアントレスのデバイスの種類のパラメーターを使用する利点​

注:device_infoは、このパラメーターにを置置換じます。
deviceUser
デバイスユーザーID。
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
pass-help-authentication