Refrescar Token

Renueva un token JWT vigente sin necesidad de volver a enviar tus credenciales de API. Útil para mantener una sesión activa durante operaciones prolongadas y evitar el rate limit del endpoint de Obtener Token.

Buena Práctica

El token expira en 1 hora. Renuévalo de forma anticipada (por ejemplo, a los 50 minutos) para evitar que expire en medio de una operación crítica.

Token Vigente Requerido

Este endpoint requiere un token aún válido. Si tu token ya expiró, deberás obtener uno nuevo con tus credenciales a través de Obtener Token.

---

Endpoint

POST /v1/autenticacion/refrescar-token

Rate Limit

Los endpoints de autenticación están limitados a un máximo de 10 intentos cada 15 minutos por IP. Al superar el límite, la API responde con 429 Too Many Requests.

Headers

Header	Requerido	Descripción
Authorization	Sí	Esquema Bearer con tu token JWT vigente: Bearer <token>

Este endpoint no recibe cuerpo (body).

Ejemplo de Solicitud

curl -X POST https://api-public.thesheriff.pe/v1/autenticacion/refrescar-token \
  -H "Authorization: Bearer <TU_TOKEN_ACTUAL>"

const response = await fetch(
  "https://api-public.thesheriff.pe/v1/autenticacion/refrescar-token",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${currentToken}`,
    },
  },
);

const { data } = await response.json();
console.log("Nuevo token:", data.token);

Ejemplo de Respuesta

Una respuesta exitosa (200 OK) devuelve un nuevo token de acceso dentro del objeto data.

{
  "statusCode": 200,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... (nuevo token)",
    "expiresIn": "1h",
    "tokenType": "Bearer"
  }
}

Descripción de Campos

Campo	Tipo	Descripción
data.token	string	Nuevo token JWT de acceso. Reemplaza al token anterior en tus siguientes llamadas.
data.expiresIn	string | number	Tiempo de vigencia del nuevo token (por defecto 1h).
data.tokenType	string	Tipo de token. Siempre Bearer.

Errores

Los errores se devuelven con el código de estado HTTP correspondiente y la siguiente estructura:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "El token ha expirado"
}

Código	message	Causa
401	Falta el encabezado de autorización	No se envió el header Authorization.
401	Formato de autorización inválido. Use: Bearer <token>	El header no usa el esquema Bearer o está mal formado.
401	El token ha expirado	El token venció. Obtén uno nuevo con tus credenciales.
401	Token inválido	El token no es válido o fue manipulado.
429	Authentication rate limit exceeded. Try again in N seconds.	Se superó el límite de 10 intentos cada 15 minutos por IP.