Autenticación para el uso del servicio API de EMIZOR

TL;DR

• Credenciales: Necesitarás un client_id y client_secret proporcionados por Emizor.
• Validez: El access_token obtenido tiene una validez de 1 año.
• Endpoint: Realiza una petición POST a /oauth/token para comenzar.

Para consumir cualquiera de los servicios mencionados a partir de este punto, primero se debe realizar el proceso de autenticación en el servicio como se detalla a continuación:

Existe un servicio que permite obtener el access_token que permitirá la autenticación para utilizar el resto de los servicios de la API. La respuesta también envía la validez del TOKEN, que por defecto es de 1 año.

Dado que la validez del access_token es de un año, solo es necesario tener un token válido para la autenticación en el resto de los servicios.

El access_token obtenido puede ser verificado a través de un servicio de decodificación JWT.

Se accede al servicio de autenticación con el siguiente enlace en la documentación:

POST/oauth/tokenInicia sesión para obtener un token de autenticación.

La solicitud (Request) debe incluir:

{
  "grant_type": "client_credentials",
  "client_id":"<EMIZOR_PROVIDED>",
  "client_secret": "<EMIZOR_PROVIDED>"
}

Donde:

• grant_type: representa el tipo de credencial, envíe siempre "client_credentials".
• client_id, client_secret: representan las dos credenciales que EMIZOR proporcionará al cliente

Respuesta exitosa: código 200

{
  "token_type": "string",
  "expires_in": 0,
  "access_token": "string"
}

Donde:

• token_type: representa el tipo de token, en este caso es Bearer.
• expires_in: representa el tiempo de duración, por defecto 1 año, en Timestamp.
• access_token: representa el token que se utilizará para todos los servicios restantes.

Posibles respuestas de error:

{
  "data": {
    "error": "unsupported_grant_type.",
    "error_description": "The authorization grant type is not supported by the authorization server.",
    "hint": "Check that all required parameters have been provided.",
    "message": "The authorization grant type is not supported by the authorization server."
  }
}