Refresh Token
Descrição
Permite que usuários autenticados obtenham um novo token JWT sem necessidade de re-autenticação. Útil para manter sessões de usuário e renovar automaticamente tokens expirados.
Verbo
POST
Endpoint
/auth/refresh
Cabeçalhos
| Parâmetro | Valor |
|---|---|
| Authorization | Bearer {token} |
| Content-Type | application/json |
Campos Esperados
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| - | - | Não | Nenhum campo é necessário no corpo da requisição. |
Corpo da Requisição
{}
Observação: O token atual deve ser incluído no cabeçalho Authorization como Bearer {token}.
Respostas
Sucesso - 200
{
"success": true,
"code": 200,
"message": "Token refreshed successfully",
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
"user": {
"user_id": "123",
"first_name": "John",
"email": "john@example.com"
},
"role": "Individual"
}
Erro - 401 (Cabeçalho de autorização ausente)
{
"status": 401,
"error": 401,
"messages": {
"error": "Authorization header required"
}
}
Erro - 401 (Token inválido)
{
"status": 401,
"error": 401,
"messages": {
"error": "Invalid token format"
}
}
Erro - 401 (Token expirado)
{
"status": 401,
"error": 401,
"messages": {
"error": "Token expired and cannot be refreshed"
}
}
Erro - 404 (Usuário não encontrado)
{
"status": 404,
"error": 404,
"messages": {
"error": "User not found"
}
}
Códigos de Resposta
- 200 - Token renovado com sucesso
- 401 - Cabeçalho de autorização ausente ou token inválido/expirado
- 404 - Usuário não encontrado