POST/api/auth/refresh
Cambia un token de actualización válido por un nuevo par de token de acceso y token de actualización.
Envíe el `refreshToken` recibido más recientemente en el cuerpo JSON. La respuesta contiene un nuevo `token` y un nuevo `refreshToken`. Cada token de actualización solo puede usarse una vez y tiene una validez de siete días por defecto; guarde el nuevo token tras cada llamada y descarte el anterior. Un token de actualización ausente, inválido, caducado o ya usado da como resultado 400 `VALIDATION_ERROR`. El usuario deberá entonces volver a iniciar sesión mediante `POST /api/auth/login`. Como un token de actualización se consume al usarse, un cliente debería evitar renovaciones paralelas.
Descripción general
Llamada: POST /api/auth/refresh. Este endpoint pertenece al grupo «Autenticación» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: refreshToken (body). Casos de error documentados: 400 VALIDATION_ERROR. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.
Autenticación y seguridad
No se requiere autenticación
Idempotente: No
Parámetros
refreshToken(body, string, obligatorio)— Token de actualización emitido más recientementeSolicitud de ejemplo
{"refreshToken":"<Refresh-Token de /login>"}Respuesta de ejemplo
{"ok":true,"token":"<nuevo JWT>","refreshToken":"<nuevo Refresh-Token>"}Códigos de error
400 VALIDATION_ERROR — El token de actualización falta, es inválido, ha caducado o ya se ha usado.Comportamiento verificado
Un token de actualización válido devuelve un nuevo par de tokens; un token inválido devuelve 400 `VALIDATION_ERROR`.
Autenticación
POST /api/auth/loginInicia la sesión de un usuario con dirección de correo o nombre de usuario y contraseña, y emite un token de acceso (JWT) y un token de actualización (refresh token).POST /api/auth/forgot-passwordInicia el restablecimiento de una contraseña: si existe una cuenta con la dirección de correo indicada, recibe un correo con un enlace para restablecerla.POST /api/auth/reset-passwordEstablece una nueva contraseña con el token de restablecimiento del correo de restablecimiento.POST /api/auth/sso/exchangeÚltimo paso de un inicio de sesión SSO (SAML/OIDC): cambia el código de un solo uso de la redirección por un token de acceso y un token de actualización.