🔐 Folder: Authentication#
Este folder contiene los endpoints necesarios para generar tokens JWT que permiten autenticar el acceso a los diferentes módulos de la API maat.ai.
🛠️ Métodos de Autenticación disponibles#
✉️ AccessToken by Email#
Este endpoint permite generar un JWT de acceso temporal usando una cuenta de correo electrónico registrada.🔐 Uso: Autenticación estándar para consumir endpoints protegidos.
⏱️ Duración: Corta (30 minutos).
✅ Entrega: Un JWT en el campo access_token.
📌 Recomendación: Renueva el token de forma automática (Usando refresh_token) o manual antes de que expire.
🔗 UrlToken by Email#
Este endpoint genera un JWT de acceso vía URL, ideal para consumir reportes públicos o de un solo uso.📄 Uso: Acceso temporal a reportes o archivos.
⏳ Duración: Hasta 24 horas.
✅ Entrega: Un JWT en el campo urlToken.
🚫 Advertencia: No sustituye al access_token Ya que no contiene datos de usuario.
📌 Requisitos#
Para utilizar cualquier método necesitas:Una cuenta válida registrada en maat.ai (email autorizado).
Tu api_key correctamente configurado como variable de entorno o en los headers.
✅ Buenas Prácticas#
Al trabajar con postman, usa variables de entorno para manejar api_key, api_secret, y tokens.
No reutilices tokens una vez expirados.
Si utilizas el refresh_token, restringe su acceso, ya que con este se pueden generar nuevos access_token.
No compartas ningún token de acceso. Recuerda que son llaves temporales a nuestros servicios.
Modificado en 2026-04-10 18:09:30
