Über dieses Tool
Bevor Sie Assertions im Code schreiben, lohnt es sich, sie an einer echten Response auszuprobieren und zu sehen, welche bestehen. Fügen Sie einen JSON-Body ein, optional Statuscode und Header aus den DevTools oder curl -i, und definieren Sie Checks in einer Tabelle: Ein JSONPath existiert oder nicht, ist gleich einem Wert, hat einen Typ, passt auf eine Regex, enthält ein Element, hat eine Länge oder ist größer bzw. kleiner als eine Zahl. Status-Checks akzeptieren exakte Codes oder Klassen wie 2xx, und Header-Namen werden ohne Rücksicht auf Groß-/Kleinschreibung verglichen. Die Ergebnisse erscheinen wie in einem Test-Runner, mit ✓- und ✕-Zeilen und einer Zusammenfassung wie „3 passed, 1 failed“, die Sie in einen Bugreport kopieren können. JSONPath wird mit deaktivierter Skriptauswertung ausgewertet, Filterausdrücke werden also abgelehnt statt ausgeführt. Die Antwortzeit lässt sich aus eingefügtem Text nicht messen, daher wird dieser Check als übersprungen gemeldet.
So funktioniert es
- Fügen Sie den Response-Body als JSON ein und, wenn Sie sie prüfen wollen, Status und Header. Oder klicken Sie auf „Load sample“ (Beispiel laden).
- Fügen Sie Checks hinzu: Wählen Sie ein Ziel, geben Sie einen JSONPath wie $.data[*].email oder einen Header-Namen ein und wählen Sie Operator und erwarteten Wert.
- Lesen Sie die Ergebnisse während der Eingabe und kopieren Sie den Report. Pfade mit mehreren Treffern müssen für jeden Treffer bestehen.
FAQ zu API Response Validator
Warum schlägt mein Filterausdruck wie $..[?(@.price > 10)] fehl?
Filter- und Skriptausdrücke erfordern die Ausführung von Code, was dieses Tool aus Sicherheitsgründen deaktiviert. Verwenden Sie stattdessen Wildcard-Pfade wie $.items[*].price mit einem Operator wie „>“: Jeder gefundene Wert muss bestehen.
Wie wird der erwartete Wert interpretiert?
Lässt er sich als JSON parsen, wird er als JSON verglichen: 42 ist eine Zahl, "42" ein String, true ein Boolean und null ist null. Alles andere wird als reiner Text verglichen. Gleichheit bei Objekten und Arrays ignoriert die Reihenfolge der Keys.
Kann ich diese Checks in automatisierte Tests umwandeln?
Ja. Sobald die Checks bestehen, erzeugen Sie mit dem API Assertion Builder entsprechende Assertions für Playwright, Postman, REST Assured oder Cypress.