Recuperar decisiones de preautorización utilizando mvpd específico
Última actualización: 5 de abril de 2025
- Temas:
- Autenticación
IMPORTANTEl 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.
IMPORTANTEl implementación de la API de REST V2 está delimitado por la documentación sobre el mecanismo🔗 de limitación.
Pedir
HTTP
ruta
/api/v2/{serviceProvider}/decisions/preauthorize/{mvpd}
método
PUBLICAR
Parámetros de ruta
serviceProvider
El identificador único interno asociado con el proveedor de servicios durante el proceso de incorporación.
obligatorio
mvpd
El identificador único interno asociado con el proveedor de identidad durante el proceso de incorporación.
obligatorio
Parámetros de cuerpo
recursos
La lista de recursos que requieren una decisión de MVPD para poder mostrarse.
obligatorio
Encabezados
Autorización
La generación de la carga útil del token de portador se describe en la documentación del encabezado Autorización.
obligatorio
Content-Type
El tipo de medio aceptado para los recursos que se envían.
Debe ser application/json.
Debe ser application/json.
obligatorio
AP-Device-Identifier
La generación de la carga del identificador de dispositivo se describe en la documentación del encabezado AP-Device-Identifier.
obligatorio
X-Device-Info
La generación de la carga útil de información de dispositivos se describe en la documentación del encabezado X-Device-Info .
Se recomienda encarecidamente utilizarlo siempre cuando la plataforma de dispositivos del aplicación permita la provisión explícita de valores válidos.
Cuando se proporciona, el Adobe Pass Authentication back-end combinará valores establecidos explícitamente con valores extraídos implícitamente (de forma predeterminada).
Cuando no se proporciona, el Adobe Pass Authentication back-end utilizará valores extraídos implícitamente (de forma predeterminada).
Se recomienda encarecidamente utilizarlo siempre cuando la plataforma de dispositivos del aplicación permita la provisión explícita de valores válidos.
Cuando se proporciona, el Adobe Pass Authentication back-end combinará valores establecidos explícitamente con valores extraídos implícitamente (de forma predeterminada).
Cuando no se proporciona, el Adobe Pass Authentication back-end utilizará valores extraídos implícitamente (de forma predeterminada).
Obligatorio
X-Forwarded-For
La dirección IP del dispositivo de flujo continuo.
Se recomienda utilizarlo siempre para implementaciones de servidor a servidor, especialmente cuando la llamada la realice el servicio del programador en lugar del dispositivo de flujo continuo.
Para implementaciones de cliente a servidor, la dirección IP del dispositivo de flujo continuo se envía implícitamente.
Se recomienda utilizarlo siempre para implementaciones de servidor a servidor, especialmente cuando la llamada la realice el servicio del programador en lugar del dispositivo de flujo continuo.
Para implementaciones de cliente a servidor, la dirección IP del dispositivo de flujo continuo se envía implícitamente.
opcional
Adobe-Subject-Token
o
X-Roku-Reserved-Roku-Connect-Token
o
X-Roku-Reserved-Roku-Connect-Token
La generación de la carga de inicio de sesión único para el método de identidad de Platform se describe en la documentación del encabezado Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token.
Para obtener más información sobre los flujos habilitados para el inicio de sesión único que utilizan una identidad de plataforma, consulte la documentación de Inicio de sesión único mediante flujos de identidad de plataforma.
Para obtener más información sobre los flujos habilitados para el inicio de sesión único que utilizan una identidad de plataforma, consulte la documentación de Inicio de sesión único mediante flujos de identidad de plataforma.
opcional
AD-Service-Token
La generación de la carga de inicio de sesión único para el método del token de servicio se describe en la documentación del encabezado AD-Service-Token.
Para obtener más información sobre los flujos habilitados para el inicio de sesión único que utilizan un token de servicio, consulte la documentación de Inicio de sesión único mediante flujos de token de servicio.
Para obtener más información sobre los flujos habilitados para el inicio de sesión único que utilizan un token de servicio, consulte la documentación de Inicio de sesión único mediante flujos de token de servicio.
opcional
AP-Partner-Framework-Status
La generación de la carga útil de inicio de sesión único para el método Partner se describe en la documentación del encabezado AP-Partner-Framework-Estado .
Para obtener más detalles sobre inicio de sesión único flujos habilitados mediante un socio, consulte la documentación sobre el inicio de sesión único mediante flujos de socio.
Para obtener más detalles sobre inicio de sesión único flujos habilitados mediante un socio, consulte la documentación sobre el inicio de sesión único mediante flujos de socio.
opcional
Aceptar
El tipo medios aceptado por el cliente aplicación.
Si se especifica, debe ser application/json.
Si se especifica, debe ser application/json.
opcional
User-Agent
El agente de usuario de la aplicación cliente.
opcional
Respuesta
Código
Texto
Descripción
200
OK
El cuerpo de la respuesta contiene una lista de decisiones con información adicional.
400
Solicitud incorrecta
La solicitud no es válida, el cliente debe corregirla e intentarlo de nuevo. El cuerpo de respuesta puede contener información de error que se adhiera a la documentación de Códigos de error mejorados.
401
No autorizado
El token de acceso no es válido, el cliente debe obtener un nuevo token de acceso e intentarlo de nuevo. Para obtener más información, consulte la Información general sobre el registro de clientes dinámicos.
405
Método no permitido
El método HTTP no es válido, el cliente debe utilizar un método HTTP permitido para el recurso solicitado e intentarlo de nuevo. Para obtener más información, consulte la sección Solicitud.
500
Error interno del servidor
El lado del servidor ha encontrado un problema. El cuerpo de respuesta puede contener información de error que se adhiera a la documentación de Códigos de error mejorados.
Correcto
Encabezados
Estado
200
obligatorio
Content-Type
application/json
obligatorio
Cuerpo
decisiones
JSON que contiene una lista de elementos, cada uno con los siguientes atributos:
Atributo
resource
El identificador de recurso para el que se devuelve la decisión de preautorización.
Obligatorio
Proveedor de servicios
El identificador único interno asociado al proveedor de servicios durante el proceso de incorporación.
Obligatorio
mvpd
El identificador único interno asociado con el proveedor de identidad durante el proceso de incorporación.
obligatorio
authorized
El estado de decisión del recurso, que puede ser "true" o "false".
obligatorio
origen
Información sobre la fuente de decisión:
Los valores posibles son:
- mvpd
La decisión es emitida por el extremo de preautorización de MVPD. - degradación
La decisión se emite como resultado del acceso degradado. - La decisión temppass
se ha emitido como resultado del acceso temporal. - La decisión ficticia
se emite como resultado de la función de autorización previa ficticia.
Obligatorio
error
El error proporciona información adicional sobre la decisión "Denegar" que se adhiere a la documentación de los códigos de Error mejorados.
opcional
Obligatorio
Error
Encabezados
Estado
400, 401, 405, 500
obligatorio
Content-Type
application/json
obligatorio
Cuerpo
El cuerpo de respuesta puede proporcionar información de error adicional que se adhiera a la documentación de Códigos de error mejorados.
obligatorio
Muestras
1. Recupere las decisiones de preautorización utilizando mvpd específico
Solicitud
POST /api/v2/REF30/decisions/preauthorize/Cablevision HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
Content-Type: application/json
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
Body:
{
"resources": ["resource1", "resource2", "resource3"]
}
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"decisions": [
{
"resource": "resource1 ",
"serviceProvider": "REF30",
"mvpd": "Cablevision",
"source": "mvpd",
"authorized": true
},
{
"resource": "resource2",
"serviceProvider": "REF30",
"mvpd": "Cablevision",
"source": "mvpd",
"authorized": true
},
{
"resource": "resource3",
"serviceProvider": "REF30",
"mvpd": "Cablevision",
"source": "mvpd",
"authorized": false,
"error": {
"status": 403,
"code": "preauthorization_denied_by_mvpd",
"message": "The MVPD has returned a \"Deny\" decision when requesting pre-authorization for the specified resource.",
"helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=es",
"action": "none"
}
}
]
}
2. Recuperar decisiones de preautorización utilizando mvpd específico mientras se aplica la degradación
Solicitud
POST /api/v2/REF30/decisions/preauthorize/${degradedMvpd} HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
Content-Type: application/json
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
Body:
{
"resources": ["REF30", "apasstest1"]
}
Respuesta - Degradación de AuthNAll
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"decisions": [
{
"resource": "REF30",
"serviceProvider": "REF30",
"mvpd": "${degradedMvpd}",
"source": "degradation",
"authorized": true
}
{
"resource": "apasstest1",
"serviceProvider": "REF30",
"mvpd": "${degradedMvpd}",
"source": "degradation",
"authorized": true
}
]
}
Respuesta: degradación de AuthZAll
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"decisions": [
{
"resource": "REF30",
"serviceProvider": "REF30",
"mvpd": "${degradedMvpd}",
"source": "degradation",
"authorized": true
}
{
"resource": "apasstest1",
"serviceProvider": "REF30",
"mvpd": "${degradedMvpd}",
"source": "degradation",
"authorized": true
}
]
}
Respuesta: degradación de AuthZNone
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"decisions": [
{
"resource": "REF30",
"serviceProvider": "REF30",
"mvpd": "${degradedMvpd}",
"source": "degradation",
"authorized": false,
"error": {
"status": 403,
"code": "authorization_denied_by_degradation_rule",
"message": "The integration has an AuthZNone rule applied for the requested resources",
"helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=es",
"action": "none"
}
}
{
"resource": "apasstest1",
"serviceProvider": "REF30",
"mvpd": "${degradedMvpd}",
"source": "degradation",
"authorized": false,
"error": {
"status": 403,
"code": "authorization_denied_by_degradation_rule",
"message": "The integration has an AuthZNone rule applied for the requested resources",
"helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=es",
"action": "none"
}
}
]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b