À propos de cet outil
Avant d’écrire des assertions en code, il est utile de les essayer sur une vraie réponse pour voir lesquelles passent. Collez un corps JSON, éventuellement le code de statut et les en-têtes copiés depuis les DevTools ou curl -i, et définissez des vérifications dans un tableau : un JSONPath existe ou non, est égal à une valeur, a un type, correspond à une regex, contient un élément, a une longueur, ou est supérieur ou inférieur à un nombre. Les vérifications de statut acceptent des codes exacts ou des classes comme 2xx, et les noms d’en-têtes sont comparés sans tenir compte de la casse. Les résultats s’affichent comme dans un test runner, avec des lignes ✓ et ✕ et un résumé « 3 passed, 1 failed » à copier dans un rapport de bug. Le JSONPath est évalué sans exécution de script : les expressions de filtre sont rejetées au lieu d’être exécutées. Le temps de réponse ne peut pas être mesuré à partir d’un texte collé : cette vérification est donc indiquée comme ignorée.
Mode d’emploi
- Collez le corps JSON de la réponse, ainsi que le statut et les en-têtes si vous voulez les vérifier. Ou cliquez sur « Load sample » (charger un exemple).
- Ajoutez des vérifications : choisissez une cible, saisissez un JSONPath comme $.data[*].email ou un nom d’en-tête, choisissez un opérateur et une valeur attendue.
- Lisez les résultats pendant la saisie et copiez le rapport. Les chemins qui correspondent à plusieurs valeurs doivent réussir pour chacune d’elles.
FAQ : Validateur de réponses API
Pourquoi mon expression de filtre comme $..[?(@.price > 10)] échoue-t-elle ?
Les expressions de filtre et de script nécessitent d’évaluer du code, ce que l’outil désactive par sécurité. Utilisez plutôt des chemins avec joker comme $.items[*].price et un opérateur comme « > » : chaque valeur trouvée doit réussir.
Comment la valeur attendue est-elle interprétée ?
Si elle se lit comme du JSON, elle est comparée en JSON : 42 est un nombre, "42" une chaîne, true un booléen et null vaut null. Tout le reste est comparé en texte brut. L’égalité sur les objets et tableaux ignore l’ordre des clés.
Puis-je transformer ces vérifications en tests automatisés ?
Oui. Une fois les vérifications au vert, utilisez le générateur d’assertions API pour produire les assertions équivalentes en Playwright, Postman, REST Assured ou Cypress.