DocumentaciónAdobe PassAdobe Pass Authentication

Recuperar token de acceso retrieve-access-token

Last update: Mon Aug 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
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.
IMPORTANT
La implementación de la API de registro de cliente dinámico está limitada por la documentación de Mecanismo de limitación.

Solicitud request

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.
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.
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.
obligatorio
Encabezados
Content-Type
El tipo de medio aceptado para los recursos que se envían.

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).
obligatorio
Aceptar
El tipo de medio aceptado por la aplicación cliente.

Si se especifica, debe ser application/json.
opcional
User-Agent
El agente de usuario de la aplicación cliente.
opcional

Respuesta response

Correcto success

Encabezados
Estado
201
obligatorio
Content-Type
application/json
obligatorio
Cuerpo

El objeto JSON tiene los atributos siguientes:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 9-bgcolor-deebff 13-bgcolor-deebff 17-bgcolor-deebff 21-bgcolor-deebff layout-auto html-authored
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 error

Encabezados
Estado
400
obligatorio
Content-Type
application/json
obligatorio
Cuerpo
error

Los valores posibles son:

table 0-row-3 1-row-2 2-row-2 3-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff layout-auto html-authored
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 samples

Recuperar token de acceso samples-retrieve-access-token

Solicitud
code language-https 
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
code language-https 
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
code language-https 
HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

{ "error": "invalid_request" }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b