Refresh do Token

Renova o token JWT ativo

Este endpoint é do tipo: Protected

Descrição

Renova um token JWT válido com as seguintes funcionalidades:

Valida o token JWT atual no header Authorization
Gera um novo token com TTL de 180 minutos (3 horas)
Retorna apenas o novo token (não retorna dados do usuário)
Invalida o token anterior automaticamente

Detalhes do Endpoint

VERBO

POST

URL BASE

http://api.provista.dev.nabrasil.org.br/v1

ENDPOINT

/auth/refresh

Cabeçalhos

Parâmetro	Valor
Content-Type	application/json
Authorization	Bearer <token_atual>

Corpo da Requisição

Este endpoint não requer corpo de requisição.

Respostas

Sucesso - 200

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.novo.token.exemplo",
    "token_type": "bearer",
    "expires_in": 10800
  }
}

Nota: O endpoint de refresh retorna apenas o novo token. Para obter os dados do usuário, use o endpoint /auth/me

Erro - 401 (Token não fornecido)

{
  "success": false,
  "message": "Token não fornecido"
}

Condição: Token JWT não foi enviado no header Authorization

Erro - 401 (Token expirado)

{
  "success": false,
  "message": "Token expirado"
}

Condição: Token JWT expirado (TTL de 180 minutos excedido)

Erro - 401 (Token inválido)

{
  "success": false,
  "message": "Token inválido"
}

Condição: Token JWT malformado ou com assinatura inválida

Códigos de Resposta

Código	Descrição
200	Token renovado com sucesso
401	Token não fornecido, inválido ou expirado

Nunciatura Provista