Saltar al contenido principal

Flujo de autenticación

En esta página encontrarás los detalles sobre los flujos de autenticación en la API de Koncili.


La API Koncili usa autenticación basada en tokens JWT, con dos mecanismos principales:

  1. Token de acceso: Credenciales iniciales
  2. Refresh token: Renovación del acceso

Token de acceso​

Endpoint:​

  • POST: /public/api/auth/token

Requisitos:​

  • Las credenciales deben codificarse en base64
  • Formato: email:senha
Importante

Cómo codificar tus credenciales:

  1. Combina el correo y la contraseña en el formato: seuemail@dominio.com:suasenha
  2. Conviértelo a base64

Ejemplo de solicitud:

{ "credentials": "dGVzdGVAZW1haWwuY29tOnNlbmhhMTIz" }

Refresh token​

Endpoint:​

  • POST: /public/api/auth/refresh-token

Características​

  • Cada renovación genera un nuevo refresh token
  • El token anterior se invalida después de la renovación
Importante

El token de acceso dura 2 horas; crea un proceso de actualización del token usando el refresh token