Skip to main content

Endpoint

POST /api/token/refresh/
Obtiene un nuevo token de acceso usando un refresh token válido, sin necesidad de volver a ingresar credenciales.

Autenticación

Este endpoint NO requiere el header Authorization. El refresh token se envía en el body de la petición.

Request

Body Parameters

refresh
string
required
Token de refresco obtenido durante el login

Ejemplo

curl -X POST http://localhost:8000/api/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{
    "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
  }'

Response

Success (200 OK)

access
string
Nuevo token JWT de acceso
{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Error Responses

401 Unauthorized

El refresh token es inválido o ha expirado.
{
  "detail": "Token is invalid or expired",
  "code": "token_not_valid"
}

Renovación automática

Se recomienda implementar lógica en el cliente para:
  1. Detectar cuando un access token está próximo a expirar
  2. Solicitar un nuevo access token automáticamente
  3. Reintentar la petición fallida con el nuevo token
En Angular, implemente un interceptor HTTP que maneje automáticamente la renovación de tokens cuando reciba un error 401.

Ver también

Login

Obtener tokens iniciales

Build docs developers (and LLMs) love