DocumentaciónAdobe PassAdobe Pass Authentication

Recuperar token de autorización retrieve-authorization-token

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

Recupera el token de autorización (AuthZ).

Extremo
Llamado
por
Entrada
Parámetros
Método HTTP
Respuesta
Respuesta HTTP
<SP_FQDN>/api/v1/tokens/authz

Por ejemplo:

<SP_FQDN>/api/v1/tokens/authz
Servicio de programador

o

de aplicación de streaming
1. solicitante (obligatorio)
2. deviceId (obligatorio)
3. recurso (obligatorio)
4. device_info/X-Device-Info (obligatorio)
5. deviceType
6. deviceUser (obsoleto)
7. appId (obsoleto)
GET
1. Correcto
2. Token de autenticación
no encontrado o caducado:
Motivo de explicación XML
no se encontró el token de autenticación
3. Token de autorización
no encontrado:
Explicación XML
4. Token de autorización
caducado:
Explicación de XML
200: éxito
412: sin AuthN

404: sin AuthZ

410: AuthZ caducado
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.
resource
Cadena que contiene un resourceId (o fragmento MRSS), identifica el contenido solicitado por un usuario y es reconocida por los extremos de autorización de MVPD.
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, Ventajas 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 response

Correcto

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
        <expires>1348148289000</expires>
        <mvpd>sampleMvpdId</mvpd>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <proxyMvpd>sampleProxyMvpdId</proxyMvpd>
    </authorization>

JSON:

    {
        "mvpd": "sampleMvpdId",
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348148289000",
        "proxyMvpd": "sampleProxyMvpdId"
    }

Testigo de autenticación no encontrado o caducado:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>412</status>
        <message>User not authenticated</message>
    </error>

JSON:

    {
        "status": 412,
        "message": "User not authenticated",
        "details": null
    }

No se encontró el token de autorización:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>404</status>
        <message>Not found</message>
    </error>

JSON:

    {
        "status": 404,
        "message": "Not Found",
        "details": null
    }

Token de autorización caducado:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>410</status>
        <message>Gone</message>
    </error>

JSON:

    {
        "status": 410,
        "message": "Gone",
        "details": null
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b