Autenticación

Inicio de sesión, renovación de token, restablecimiento de contraseña, finalización de SSO: y acceso a la API con claves de API.

Este grupo abarca el inicio de sesión de los usuarios: inicio de sesión con dirección de correo electrónico o nombre de usuario y contraseña, renovación de la sesión mediante un token de actualización, restablecimiento de una contraseña olvidada y finalización de un inicio de sesión único (SAML/OIDC). Los endpoints devuelven un token de acceso (JWT), que se envía en la cabecera `Authorization: Bearer <token>`, y un token de actualización que se sustituye por uno nuevo cada vez que se utiliza.

Para el acceso automatizado de sus propios programas a sus datos, utilice una clave API para la API REST en `https://zentor-app.de/api/v1` en lugar de un inicio de sesión de usuario. Zentor activa el acceso a la API bajo petición; a continuación, los administradores crean en el panel, en «Claves de API», claves con permisos definidos (scopes). La clave se transmite en la cabecera `Authorization: Bearer <clave de API>` o en `X-API-Key`. Encontrará los scopes, los códigos de error y recomendaciones para guardar las claves de forma segura en la visión general de la referencia de la API.

Los endpoints de inicio de sesión están protegidos contra intentos fallidos repetidos: tras varios intentos incorrectos, el servidor retrasa los siguientes intentos y los bloquea temporalmente con 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← Referencia API