API Route Tester

Teste suas rotas diretamente na IDE, como no Insomnia ou Thunder Client.

Importante — Autenticação no API Route Tester

O API Route Tester não envia cookies da sessão automaticamente. Para testar rotas protegidas com AuthHybridMiddleware, você precisa obter um token JWT via login e configurá-lo na aba Auth → Bearer Token. Sem isso, a rota retornará 401 Não autenticado — exatamente como esperado.

Como usar

Clique em "Rotas" na barra superior ou pressione Ctrl + T
Na aba "Rotas", clique em uma rota detectada para preencher automaticamente
Configure headers, autenticação e body conforme necessário
Clique em "Enviar" ou pressione Enter

Funcionalidades

Aba	Descrição
Query	Parâmetros de query string (?key=value)
Headers	Headers HTTP customizáveis
Auth	Nenhuma, Bearer Token ou Basic Auth
Body	JSON, Form, Form URL-Encoded, Texto ou XML
Rotas	Rotas detectadas automaticamente do módulo

Testando rotas protegidas — Passo a passo

Rotas com AuthHybridMiddleware exigem um token JWT válido. Siga o fluxo abaixo:

Passo 1 — Fazer login e obter o token

No API Route Tester, configure uma requisição de login:

text

Método: POST
URL:    http://localhost:3005/api/auth/login
Aba:    Body → JSON
Body:
{
  "login": "seu_email_ou_username",
  "senha": "sua_senha"
}

A resposta retorna o access_token:

json

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Copie o valor de access_token.

Passo 2 — Configurar o token na aba Auth

Abra o API Route Tester (Ctrl + T)
Clique na aba Auth
Selecione Bearer Token
Cole o access_token no campo Token

O token será enviado automaticamente como Authorization: Bearer <token> em todas as requisições enquanto estiver configurado.

Passo 3 — Testar a rota protegida

Exemplo com o módulo Tarefa (após publicar e ativar o módulo):

text

Método: GET
URL:    http://localhost:3005/api/tarefa
Aba:    Auth → Bearer Token → cole o access_token

Resposta esperada (200 OK):
{
  "tarefas": []
}

Sem token (401):
{
  "error": "Não autenticado: token ausente."
}

Token inválido (401):
{
  "error": "Token inválido ou expirado."
}

Salvar a requisição com o token

Clique em "Salvar" para guardar a requisição com o token configurado. Na próxima vez que abrir, o token já estará preenchido.

Token expirado?

O access_token expira em JWT_EXPIRATION_TIME segundos (padrão: 3600s = 1h). Quando expirar, faça login novamente para obter um novo token. Você também pode usar o refresh_token retornado no login para renovar sem precisar de senha: POST /api/auth/refresh com {"refresh_token": "..."}.

Salvar requisições

Clique em "Salvar" para guardar a requisição atual. Requisições salvas aparecem no painel lateral esquerdo e podem ser reutilizadas a qualquer momento com todos os dados preenchidos (URL, headers, token, body).