DocumentaciónAdobe PassAdobe Pass Authentication

Recuperar lista de recursos autorizados previamente retrieve-list-of-preauthorized-resources

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
El contenido de esta página se proporciona únicamente con fines informativos. El uso de esta API requiere una licencia actual de Adobe. No se permite el uso no autorizado.
NOTE
La implementación de la API de REST está limitada por Mecanismo de limitación

Extremos de API de REST clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Descripción description

Una solicitud a la autenticación de Adobe Pass para obtener la lista de recursos autorizados previamente.

Existen dos conjuntos de API: un conjunto para la aplicación de streaming o el servicio de programador y otro para la aplicación web de segunda pantalla. Esta página describe la API para la aplicación de streaming o el servicio de programador.

Extremo
Llamado
por
Entrada
Parámetros
Método HTTP
Respuesta
Respuesta HTTP
<SP_FQDN>/api/v1/preauthorize
Servicio de programador

o

de aplicación de streaming
1. solicitante (obligatorio)
2. deviceId (obligatorio)
3. lista de recursos (obligatorio)
4. device_info/X-Device-Info (obligatorio)
5. deviceType
6. deviceUser (obsoleto)
7. appId (obsoleto)
GET
XML o JSON que contienen decisiones individuales de preautorización o detalles de error. Consulte los ejemplos siguientes.
200 - Correcto

400 - Solicitud incorrecta

401 - No autorizado

405 - Método no permitido

412 - Error de condición previa

500 - Error interno del servidor
Parámetro de entrada
Descripción
solicitante
Identificador de solicitante del programador para el que es válida esta operación.
deviceId
El ID de dispositivo bytes.
lista de recursos
Cadena que contiene una lista delimitada por comas de resourceIds que identifica el contenido al que un usuario podría tener acceso y que los extremos de autorización de MVPD reconocen.
device_info/

X-Device-Info
Información del dispositivo de streaming.

Nota: Esto PUEDE pasarse a device_info como parámetro de URL, pero debido al tamaño potencial de este parámetro y a las limitaciones en la longitud de una URL de GET, DEBE pasarse como X-Device-Info en el encabezado http.

Ver los detalles completos en Pasar información de conexión y dispositivo.
deviceType
El tipo de dispositivo (por ejemplo, Roku, PC).

Si este parámetro está configurado correctamente, ESM ofrece métricas que están desglosadas por tipo de dispositivo al usar Clientless, de modo que se puedan realizar diferentes tipos de análisis, por ejemplo, Roku, AppleTV y Xbox.

Vea, beneficios de usar el parámetro de tipo de dispositivo sin cliente en las métricas de pase

Nota: device_info reemplazará este parámetro.
deviceUser
El identificador de usuario del dispositivo.
appId
El nombre o ID de la aplicación.

Nota: device_info reemplaza este parámetro.

Respuesta de ejemplo 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