Logo SOAR

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