Renovar token

Descrição

Endpoint para renovar um token JWT existente. Permite obter um novo token com nova data de expiração sem precisar fazer login novamente, mantendo a sessão ativa.

📋 Detalhes da Requisição

URL

PUT https://seudominio.com/api/auth

Headers Obrigatórios

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`Authorization`	string	✅ Sim	Token JWT válido no formato "Bearer TOKEN"

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Token renovado com sucesso",
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX2xldmVsIjoxLCJpYXQiOjE3NjEzNjA4MjMsImV4cCI6MTc2Mzk1MjgyM30.AnFhnub8uSWlgM_C_X6a4olwqfD5Slvx3HffREOXkgY",
    "expires_in": "2025-02-23 18:13:11"
  }
}

❌ Erro - Token Não Fornecido (401 Unauthorized)

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

❌ Erro - Token Inválido (401 Unauthorized)

{
  "success": false,
  "message": "Token inválido ou expirado",
  "error": "Unauthorized"
}

❌ Erro - Usuário Inativo (401 Unauthorized)

{
  "success": false,
  "message": "Usuário não encontrado ou inativo",
  "error": "Unauthorized"
}

❌ Erro - Servidor (500 Internal Server Error)

{
  "success": false,
  "message": "Erro ao renovar token",
  "error": "Internal Server Error"
}

Cenários de Uso

Renovação preventiva - Renovar antes do token expirar

Manutenção de sessão - Manter usuário logado

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	Sucesso	Token renovado com sucesso
`401`	Unauthorized	Token inválido, expirado ou usuário inativo
`500`	Internal Server Error	Erro interno do servidor

🔄 Fluxo de Renovação

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

application/json

Body

Exemplo

{
    "success": true,
    "message": "string",
    "data": {
        "token": "string",
        "expires_in": "string"
    },
    "timestamp": "string",
    "status_code": 0
}

Descrição#

📋 Detalhes da Requisição#

URL#

Headers Obrigatórios#

Parâmetros#

📤 Respostas da API#

✅ Sucesso (200 OK)#

❌ Erro - Token Não Fornecido (401 Unauthorized)#

❌ Erro - Token Inválido (401 Unauthorized)#

❌ Erro - Usuário Inativo (401 Unauthorized)#

❌ Erro - Servidor (500 Internal Server Error)#

Cenários de Uso#

⚠️ Códigos de Status HTTP#

🔄 Fluxo de Renovação#

Requisição

Exemplos de Requisição

Respostas