文档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：一组用于流应用程序或程序员服务，另一组用于第二屏幕Web应用程序。 本页介绍适用于流应用程序或程序员服务的API。

端点
调用者
输入
参数
HTTP
方法
响应
HTTP
响应
<SP_FQDN>/api/v1/预授权
流式处理应用程序

或

程序员服务
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 — 内部服务器错误
输入参数
描述
请求者
此操作有效的程序员requestorId。
deviceId
设备ID字节。
资源列表
一个字符串，其中包含以逗号分隔的resourceId列表，该resourceId列表标识用户可能可以访问并被MVPD授权端点识别的内容。
设备信息/

X — 设备信息
流设备信息。

注意：可以将此device_info作为URL参数传递，但由于此参数的潜在大小以及GETURL的长度限制，它应作为X-Device-Info传递到http标头。

在传递设备和连接信息中查看完整的详细信息。
deviceType
设备类型（例如，Roku、PC）。

如果该参数设置正确，ESM提供的量度在使用无客户端程序时按设备类型🔗进行划分，以便可以执行不同类型的分析，例如Roku、AppleTV和Xbox。

查看在传递量度中使用无客户端设备类型参数的好处​

注意： device_info将替换此参数。
设备用户
设备用户标识符。
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