Web Debugger

Propósito e intención del usuario: Identificar y diagnosticar interacciones de API web construyendo solicitudes HTTP, validando respuestas y detectando discrepancias. Los usuarios objetivo incluyen ingenieros frontend, desarrolladores backend, analistas de QA y equipos de API que necesitan pruebas reproducibles entre entornos, diagnosticar endpoints inestables o verificar integraciones con servicios de terceros. El valor principal reside en entradas estructuradas, salidas precisas y comparaciones deterministas que reducen el tiempo de depuración.
Lógica central y características: Gestión de entradas multi-campo basada en formulario para base_url, ruta del endpoint, método, headers, parámetros de consulta y cuerpo opcional. Funciones centrales incluyen construcción de solicitud, ejecución, captura de respuesta, medición de latencia y validación de estado/headers/cuerpo. Funciones avanzadas añaden variables de entorno, esquemas de autenticación, plantillas predefinidas, diffing por JSON-path y exportación de resultados.
Entradas y salidas: Entradas incluyen base_url (cadena, requerida), endpoint (cadena, requerida), método (GET/POST/PUT/PATCH/DELETE, requerida), headers (objeto, opcional), query_params (objeto, opcional), body (cadena, opcional), expected_status (entero, opcional), expected_headers (objeto, opcional), y expected_body_pattern (cadena, opcional). Salidas incluyen actual_status (entero), actual_headers (objeto), actual_body (cadena), latency_ms (número) y diffs (array de cadenas). Reglas de formato: cuerpos JSON se comparan cuando el tipo de contenido es application/json; de lo contrario, diff de cadena cruda; comparaciones numéricas exactas a menos que se configure tolerancia.
Algoritmos y cálculos: Construir la URL a partir de base_url y endpoint, combinar headers, añadir parámetros de consulta y enviar la petición HTTP. Cronometra el tiempo de ida y vuelta para calcular latency_ms. Si la respuesta es JSON, realizar una comparación estructurada contra expected_body_pattern o rutas JSON dirigidas; de lo contrario aplicar diff textual. Señalar desajustes de estado, headers o contenido del cuerpo y generar una lista concisa de diffs con referencias de ruta de campo.
Errores y casos límite: Maneja entradas inválidas (p. ej., URL ausente, método no soportado), fallos de red, timeouts y respuestas no deterministas. Oculta headers sensibles, exige UTF-8 y devuelve códigos de error estandarizados con orientación de reintento opcional. Los payloads grandes o respuestas en streaming están limitados; cuando datos externos no están disponibles o hay limitaciones de velocidad, se devuelven resultados parciales y códigos de error.
Industria/Región y Localización: estándares HTTP/1.1/2, manejo de headers conforme a RFC y sellos de tiempo ISO-8601 para informes de latencia. Soporta tiempos basados en UTC y manejo de cadenas neutral a la localización; no se requiere moneda ni formato regional a menos que se amplíe mediante entradas.
Supuestos y Exclusiones: Se asume conectividad de red y entradas válidas y bien formadas. No es un marco de pruebas completo; excluye contexto del navegador, renderizado UI o flujos end-to-end automatizados más allá de la validación a nivel HTTP.