文件Adobe PassAdobe Pass 驗證

依第二熒幕Web應用程式擷取預先授權資源清單 retrieve-list-of-preauthorized-resources-by-second-screen-web-app

Last update: Sat Jul 20 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：一組用於串流應用程式或程式設計人員服務，另一組用於第二熒幕網頁應用程式。 本頁面說明AuthN應用程式的API。

端點
呼叫
者
輸入
引數
HTTP
方法
回應
HTTP
回應
<SP_FQDN>/api/v1/preauthorize/
驗證模組
1.註冊代碼
（路徑元件）
2。 要求者（必要）
3。 資源清單（必要）
GET
包含個別預先授權決定或錯誤詳細資料的XML或JSON。 請參閱下列範例。
200 — 成功

400 — 錯誤的請求

401 — 未獲授權

405 — 不允許的方法

412 — 先決條件失敗

500 — 內部伺服器錯誤
輸入引數
說明
註冊代碼
使用者在驗證流程開始時提供的註冊代碼值。
要求者
此作業有效的程式設計師要求者ID。
資源清單
字串，包含以逗號分隔的resourceId清單，用於識別使用者可能可以存取且可由MVPD授權端點辨識的內容。

範例回應 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