Endpoints / Autenticación

POST

Logout

Cierra la sesión del usuario revocando el refreshToken enviado.

POST/auth/logout

Caso de Uso

Usa este endpoint cuando el usuario decide cerrar sesión y el sistema necesita invalidar el refreshToken actual para evitar que se generen nuevos tokens de acceso desde esa sesión.

Autenticación

No requiere token JWT.

Parámetros de ruta

Este endpoint no recibe parámetros de ruta.

Body

refreshTokenstringobligatorio

Token de refresco que se desea revocar para cerrar la sesión.

Reglas de negocio

1

Se debe enviar el refreshToken de la sesión actual.

2

El backend revoca el token usando su hash.

3

Si el token no existe o ya fue revocado, la respuesta sigue siendo correcta.

4

El accessToken no se revoca en el servidor.

El cliente debe eliminarlo localmente después del cierre de sesión.

Errores esperados

500El token de refresco es requerido

Ocurre cuando no se envía refreshToken o se envía vacío.

500Error revocando el token de refresco

Ocurre si falla la revocación por un error inesperado en el servidor o en la base de datos.

Notas de uso

1

Llama este endpoint antes de limpiar la sesión en el cliente.

2

Después de una respuesta exitosa, elimina accessToken y refreshToken.

3

No es necesario enviar el header Authorization.

4

Usa la misma variable de entorno que el resto de la documentación para la base URL.