文件Adobe PassAdobe Pass 驗證

擷取預先授權的資源清單 retrieve-list-of-preauthorized-resources

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。
NOTE
REST API實作已由節流機制限制

REST API端點 clientless-endpoints

<REGGIE_FQDN>：

<SP_FQDN>：

說明 description

要求Adobe Pass驗證以取得預先授權資源清單。

有兩組API：一組用於串流應用程式或程式設計人員服務，另一組用於第二熒幕網頁應用程式。 本頁面說明串流應用程式或程式設計人員服務的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
裝置識別碼位元組。
資源清單
字串，包含以逗號分隔的resourceId清單，用於識別使用者可能可以存取且可由MVPD授權端點辨識的內容。
device_info/

X-Device-Info
串流裝置資訊。

注意：這可以作為URL引數傳遞device_info，但由於此引數的潛在大小以及GETURL長度的限制，它應該作為X-Device-Info傳遞到http標頭。

檢視傳遞裝置和連線資訊中的完整詳細資料。
deviceType
裝置型別（例如Roku、PC）。

若此引數設定正確，ESM提供的量度在使用Clienless時，會針對每個裝置型別🔗進行劃分，因此可以執行不同型別的分析，例如Roku、AppleTV和Xbox。

檢視在傳遞量度中使用無使用者端裝置型別引數的好處​

注意： device_info將會取代此引數。
deviceUser
裝置使用者識別碼。
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
3f5e655c-af63-48cc-9769-2b6803cc5f4b