Acerca de esta herramienta
Antes de escribir assertions en código, ayuda probarlas contra una respuesta real y ver cuáles pasan. Pega un body JSON y, si quieres, el código de estado y las cabeceras copiados de DevTools o de curl -i, y define comprobaciones en una tabla: un JSONPath existe o no, es igual a un valor, tiene un tipo, coincide con una regex, contiene un elemento, tiene una longitud o es mayor o menor que un número. Las comprobaciones de estado aceptan códigos exactos o clases como 2xx, y los nombres de cabecera se comparan sin distinguir mayúsculas. Los resultados se muestran como en un test runner, con filas ✓ y ✕ y un resumen “3 passed, 1 failed” que puedes copiar en un reporte de bug. El JSONPath se evalúa con la evaluación de scripts desactivada, así que las expresiones de filtro se rechazan en lugar de ejecutarse. El tiempo de respuesta no se puede medir a partir de texto pegado, así que esa comprobación se marca como omitida.
Cómo usarla
- Pega el JSON del body de la respuesta y, si quieres comprobarlos, el estado y las cabeceras. O pulsa “Load sample”.
- Añade comprobaciones: elige un objetivo, escribe un JSONPath como $.data[*].email o un nombre de cabecera, elige un operador y un valor esperado.
- Lee los resultados mientras escribes y copia el informe. Las rutas que coinciden con varios valores deben cumplirse para todas las coincidencias.
Preguntas frecuentes: Validador de respuestas de API
¿Por qué falla mi expresión de filtro como $..[?(@.price > 10)]?
Las expresiones de filtro y de script requieren evaluar código, algo que esta herramienta desactiva por seguridad. Usa rutas con comodines como $.items[*].price con un operador como «>»: todos los valores coincidentes deben cumplirlo.
¿Cómo se interpreta el valor esperado?
Si se puede parsear como JSON, se compara como JSON, así que 42 es un número, "42" es una cadena, true es un booleano y null es null. Cualquier otra cosa se compara como texto plano. La igualdad en objetos y arrays ignora el orden de las claves.
¿Puedo convertir estas comprobaciones en tests automatizados?
Sí. Cuando las comprobaciones pasen, usa el API Assertion Builder para generar las assertions equivalentes de Playwright, Postman, REST Assured o Cypress.