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 recientemente

Solicitud 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

Artículos relacionados

← Autenticación