Web Debugger

Propósito e intenção do usuário: Identificar e diagnosticar interações de API web construindo requisições HTTP, validando respostas e identificando discrepâncias. Usuários-alvo incluem engenheiros frontend, desenvolvedores backend, analistas de QA e equipes de API que precisam de testes reprodutíveis entre ambientes, diagnosticar pontos finais instáveis ou verificar integrações com serviços de terceiros. O valor está em entradas estruturadas, saídas precisas e comparações deterministas que reduzem o tempo de depuração.
Lógica central e recursos: Gerenciamento de entrada multi-campo baseado em formulário para base_url, caminho do endpoint, método, headers, parâmetros de consulta e corpo opcional. Funcionalidades-chave incluem construção de requisição, execução, captura de resposta, medição de latência e validação de status/headers/corpo. Funcionalidades avançadas adicionam variáveis de ambiente, esquemas de autenticação, modelos predefinidos, diffing por JSON-path e exportação de resultados.
Entradas e Saídas: Entradas incluem base_url (string, obrigatório), endpoint (string, obrigatório), método (GET/POST/PUT/PATCH/DELETE, obrigatório), headers (objeto, opcional), query_params (objeto, opcional), body (string, opcional), expected_status (inteiro, opcional), expected_headers (objeto, opcional), e expected_body_pattern (string, opcional). Saídas incluem actual_status (inteiro), actual_headers (objeto), actual_body (string), latency_ms (número) e diffs (array de strings). Regras de formatação: corpos JSON são comparados quando o tipo de conteúdo é application/json; caso contrário, diff de string bruta; comparações numéricas são exatas, a menos que tolerância seja configurada.
Algoritmos e Cálculos: Construir URL a partir de base_url e endpoint, mesclar headers, adicionar parâmetros de consulta e enviar a requisição HTTP. Cronometrar o round-trip para calcular latency_ms. Se a resposta for JSON, realizar comparação estruturada contra expected_body_pattern ou caminhos JSON direcionados; caso contrário aplicar diff textual. Marcar discrepâncias de status, headers ou conteúdo do corpo e produzir uma lista concisa de diffs com referências de caminho de campo.
Erros e Casos Limite: Lida com entradas inválidas (ex., URL ausente, método não suportado), falhas de rede, timeouts e respostas não determinísticas. Oculta headers sensíveis, exige UTF-8 e retorna códigos de erro padronizados com sugestões de retry opcionais. Payloads grandes ou respostas em streaming são limitados; quando dados externos não estão disponíveis ou há limitações de taxa, resultados parciais e códigos de erro são devolvidos.
Indústria/Região e Localização: padrões HTTP/1.1/2, manuseio de headers conforme RFC e timestamps ISO-8601 para relatórios de latência. Suporta horários baseados em UTC e tratamento de strings neutro a localização; não é necessária moeda ou formatação regional, a menos que entradas ampliem isso.