Auth

Obtener Access Token M2M

Changed on

Intercambia las credenciales de un cliente máquina a máquina por un Access Token.

Se usa en integraciones servidor a servidor: con el client_id y el client_secret entregados por Toku se obtiene un token de vigencia limitada, que después viaja en el header Authorization de cada llamada a la API, con el esquema y el token separados por un espacio (Bearer <access_token>).

El cuerpo acepta también el formato heredado usuario / password, que se traduce a client_id / client_secret antes de validar. Solo los clientes habilitados de forma explícita pueden usar este endpoint: cualquier otro client_id recibe 401, igual que unas credenciales rechazadas por el proveedor de identidad.

post/auth/login

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/auth/login
  • Auth
    API key in header x-api-key

Request body

client_idstring required

Identificador del cliente entregado por Toku.

client_secretstring required

Secreto asociado al cliente. No se registra ni se devuelve.

Response

Successful Response

access_tokenstring required

Token que autoriza las llamadas siguientes, enviado en el header Authorization.

expires_ininteger required

Segundos de vigencia del token desde su emisión.

token_typestring required

Esquema con el que se envía el token en el header Authorization.

Example response

{
  "expires_in": 86400,
  "token_type": "Bearer"
}

Changes