Validar token

Descrição

Endpoint para validar se um token JWT está válido e ativo. Permite verificar a validade do token sem precisar fazer um novo login.

📋 Detalhes da Requisição

URL

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

Headers Obrigatórios

Parâmetros

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

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Token válido",
  "data": {
    "valid": true,
    "expires_at": "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"
}

Campos Retornados

Campo	Tipo	Descrição
`valid`	boolean	Indica se o token é válido
`expires_at`	string	Data e hora de expiração do token

Cenários de Uso

Verificação periódica - Validar token antes de operações críticas

Renovação automática - Verificar se token precisa ser renovado

Debug de autenticação - Verificar se token está funcionando

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	Success	Token válido
`401`	Unauthorized	Token inválido, expirado ou não fornecido
`500`	Internal Server Error	Erro interno do servidor

🔄 Fluxo de Validaçã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": {
        "valid": true,
        "expires_at": "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)#

Campos Retornados#

Cenários de Uso#

⚠️ Códigos de Status HTTP#

🔄 Fluxo de Validação#

Requisição

Exemplos de Requisição

Respostas