Docs / Ferramentas / API Debug Terminal

Runbook — Debug de API e logs

Use este runbook quando uma API retornar erro, resposta vazia, timeout, problema de CORS ou divergência de dados.

Fluxo recomendado

  1. Abrir tools/api-debug-terminal.html.
  2. Testar o endpoint em modo direto.
  3. Se o navegador bloquear CORS, marcar Usar proxy PHP.
  4. Conferir status HTTP, headers, body e tempo de resposta.
  5. Abrir a aba Log servidor para ver os últimos testes.
  6. Copiar o cURL gerado para reproduzir o erro fora do navegador.
  7. Depois da manutenção, limpar logs/api-debug.log e desativar o debug se necessário.

Interpretação rápida

CódigoSignificado comumAção
200Requisição OKConferir se o JSON veio completo
400Parâmetro inválidoRevisar query/body
401Sem autenticaçãoConferir token/Authorization
403Sem permissãoConferir perfil, IP, CORS ou config
404Endpoint erradoConferir rota e base URL
500Erro internoConferir log PHP/servidor
504Timeout/gatewayReduzir carga, paginação ou filtros

Segurança

Nunca deixar api-debug-proxy.php liberado para qualquer domínio. O arquivo api-debug-config.php precisa manter allowed_hosts restrito.

Abrir terminalDocs do terminal