Recuperar token de acceso
Última actualización: 6 de diciembre de 2024
- 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.
IMPORTANTLa implementación de la API de registro de cliente dinámico está limitada por la documentación de Mecanismo de limitación.
Solicitud
HTTP
ruta
/o/client/token
método
POST
Parámetros de cuerpo
client_id
La cadena del identificador de la aplicación cliente.
Para obtener más información sobre cómo obtener la cadena de identificador de cliente, consulte la documentación de la API Recuperar credenciales de cliente.
Para obtener más información sobre cómo obtener la cadena de identificador de cliente, consulte la documentación de la API Recuperar credenciales de cliente.
obligatorio
client_secret
La cadena secreta de la aplicación cliente.
Para obtener más información sobre cómo obtener la cadena secreta del cliente, consulte la documentación de la API Recuperar credenciales del cliente.
Para obtener más información sobre cómo obtener la cadena secreta del cliente, consulte la documentación de la API Recuperar credenciales del cliente.
obligatorio
grant_type
Cadena de tipo de concesión (por ejemplo, "client_credentials") que la aplicación cliente puede utilizar para el extremo del token de cliente.
Para obtener más información sobre cómo obtener la cadena de tipo de concesión, consulte la documentación de la API Recuperar credenciales de cliente.
Para obtener más información sobre cómo obtener la cadena de tipo de concesión, consulte la documentación de la API Recuperar credenciales de cliente.
obligatorio
Encabezados
Content-Type
El tipo de medio aceptado para los recursos que se envían.
Debe ser application/x-www-form-urlencoded.
Debe ser application/x-www-form-urlencoded.
obligatorio
X-Device-Info
La generación de la carga de información del dispositivo se describe en la documentación de X-Device-Info.
Se recomienda utilizarlo siempre que la plataforma de dispositivos de la aplicación permita la provisión explícita de valores válidos.
Cuando se proporciona, el backend de autenticación de Adobe Pass combina explícitamente los valores establecidos con los valores extraídos implícitamente (de forma predeterminada).
Cuando no se proporciona, el backend de autenticación de Adobe Pass utilizará valores extraídos implícitamente (de forma predeterminada).
Se recomienda utilizarlo siempre que la plataforma de dispositivos de la aplicación permita la provisión explícita de valores válidos.
Cuando se proporciona, el backend de autenticación de Adobe Pass combina explícitamente los valores establecidos con los valores extraídos implícitamente (de forma predeterminada).
Cuando no se proporciona, el backend de autenticación de Adobe Pass utilizará valores extraídos implícitamente (de forma predeterminada).
obligatorio
Aceptar
El tipo de medio aceptado por la aplicación cliente.
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
Correcto
Encabezados
Estado
201
obligatorio
Content-Type
application/json
obligatorio
Cuerpo
El objeto JSON tiene los atributos siguientes:
Atributo
id
Identificador opaco que se puede utilizar para rastrear la actividad del usuario.
obligatorio
access_token
Valor del token de acceso que la aplicación cliente debe utilizar para el encabezado Autorización.
obligatorio
created_at
Hora a la que se emitió el token de acceso.
obligatorio
expires_in
Tiempo en segundos hasta que caduca el token de acceso.
obligatorio
token_type
El tipo de token (por ejemplo, "portador").
obligatorio
obligatorio
Error
Encabezados
Estado
400
obligatorio
Content-Type
application/json
obligatorio
Cuerpo
error
Los valores posibles son:
Valor
invalid_request
La solicitud no es válida debido a uno de los siguientes motivos:
- La solicitud omite un parámetro requerido.
- La solicitud incluye un valor de parámetro no admitido (que no sea de tipo de concesión).
- La solicitud repite un parámetro.
- La solicitud incluye varias credenciales.
- La solicitud utiliza más de un mecanismo para autenticar al cliente.
- La solicitud tiene un formato incorrecto.
invalid_client
Las credenciales del cliente no son válidas, el cliente debe obtener nuevas credenciales de cliente e intentarlo de nuevo. Para obtener más información, consulte la documentación de la API Recuperar credenciales del cliente.
unauthorized_client
El tipo de concesión utilizado no es válido.
obligatorio
Muestras
Recuperar token de acceso
Solicitud
POST /o/client/token HTTP/1.1
X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
Content-Type: application/x-www-form-urlencoded
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
Body:
client_id=s6BhdRkqt3&client_secret=t7AkePiru4&grant_type=client_credentials
Respuesta - Correcta
HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
{
"id": "a932f8f0-210a-41a4-b2a8-377751f6b76f",
"access_token": "2YotnFZFEjr1zCsicMWpAA",
"created_at": 1723227212,
"expires_in": 86400,
"token_type": "bearer"
}
Respuesta: error
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
{ "error": "invalid_request" }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b