ドキュメントAdobe PassAdobe Pass 認証

（レガシー）事前承認済みリソースのリストの取得 retrieve-list-of-preauthorized-resources

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

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

<REGGIE_FQDN>:

<SP_FQDN>:

説明 description

事前承認済みリソースのリストを取得するためのAdobe Pass認証へのリクエスト。

APIには2つのセットがあります。1つはストリーミングアプリまたはプログラマーサービス用、もう1つはSecond Screen Web App用です。 このページでは、ストリーミングアプリまたはプログラマーサービスのAPIについて説明します。

エンドポイント
様に呼び出されました
入力
パラメーター
HTTP
メソッド
応答
HTTP
応答
<SP_FQDN>/api/v1/preauthorize
ストリーミングアプリ

または

プログラマーサービス
​1. 依頼者（必須）
2。 deviceId （必須）
3。 リソース （必須）
4。 device_info/X-Device-Info （必須）
5. deviceType
6. deviceUser （非推奨）
7。 appId （非推奨）
GET
個別の事前認証の決定またはエラーの詳細を含むXMLまたはJSON。 以下のサンプルを参照してください。
200 – 成功

400 – 不正なリクエスト

401 – 許可されていない

405 - メソッドが許可されていません

412 – 前提条件が失敗しました

500 – 内部サーバーエラー
入力パラメーター
説明
依頼者
この操作が有効なプログラマの依頼者Id。
deviceId
デバイス ID バイト。
リソース
ユーザーがアクセスできる可能性のあるコンテンツを識別し、MVPD認証エンドポイントが認識する、resourceIdのコンマ区切りリストを含む文字列。
device_info/

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

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

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

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

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

注: device_infoは、このパラメーターに置代わります。
deviceUser
デバイスユーザーID。
appId
アプリケーション ID/名前。

メモ:device_infoがこのパラメーターに置き換わります。

応答サンプル sample-response

XML:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/xml; charset=utf-8

<resources>
  <resource>
    <id>TestStream1</id>
    <authorized>true</authorized>
  </resource>
  <resource>
    <id>TestStream2</id>
    <authorized>false</authorized>
    <error>
      <status>403</status>
      <code>authorization_denied_by_mvpd</code>
      <message>User not authorized</message>
      <details>Your subscription package does not include the "TestStream3" channel.</details>
      <helpUrl>https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes</helpUrl>
      <trace>0453f8c8-167a-4429-8784-cd32cfeaee58</trace>
      <action>none</action>
    </error>
  </resource>
</resources>

JSON:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/json; charset=utf-8

{
   "resources" : [
        {
            "id" : "TestStream1",
            "authorized" : true
        },
        {
            "id" : "TestStream3",
            "authorized" : false,
            "error" : {
               "status" : 403,
               "code" : "authorization_denied_by_mvpd",
               "message" : "User not authorized",
               "details" : "Your subscription package does not include the "TestStream3" channel.",
               "helpUrl" : "https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes",
               "trace" : "0453f8c8-167a-4429-8784-cd32cfeaee58",
               "action" : "none"
            }
        }
    ]
}
recommendation-more-help
pass-help-authentication