Assertions

Was sind Assertions?

Eine Assertion ist eine Bedingung, die Ihre API-Antwort erfüllen muss. Sie fügen einer Prüfung eine oder mehrere Assertions hinzu, und wenn eine davon nicht erfüllt ist, wird die Prüfung als fehlgeschlagen markiert und eine Warnung ausgelöst.

Arten von Assertions

• Status code: vergleicht den HTTP-Statuscode der Antwort mit einer Zahl, zum Beispiel Equals 200 oder Less than 400.
• Response time: vergleicht die gesamte Antwortzeit in Millisekunden mit einer Zahl, zum Beispiel Less than 800.
• Body: prüft, dass der Antwort-Body einen Text enthält (Contains) oder nicht enthält (Does not contain). Der Abgleich ist ein wörtlicher, Groß- und Kleinschreibung beachtender Teilstring; reguläre Ausdrücke werden nicht unterstützt, und ein leerer Wert schlägt immer fehl.

Für Statuscode und Antwortzeit können Sie Equals, Not equals, Equals or Greater than, Equals or Less than, Greater than oder Less than wählen.

So fügen Sie eine Assertion hinzu

1. Suchen Sie im Prüfungsformular den Abschnitt Assertions und klicken Sie auf Assertion hinzufügen.
2. Wählen Sie die Art (Status code, Response time oder Body).
3. Wählen Sie den Vergleich und geben Sie den Wert ein.
4. Speichern Sie die Prüfung.

Fehlgeschlagene Assertions und Prüfungsdetails

Schlägt eine Assertion fehl, zeigt die Detailseite der Prüfung, welche Assertion fehlgeschlagen ist, sodass Sie sehen, warum die Prüfung als fehlgeschlagen markiert wurde.

Zusammenspiel mit Antwortzeit-Limits

Ist eine Prüfung langsamer als ihr Antwortzeit-Limit, wird sie als verschlechtert markiert. Hat sie zusätzlich eine fehlschlagende Assertion, wird die Prüfung als fehlgeschlagen markiert.

Praktische Anwendungsfälle

• Leistung: Eine Response-time-Assertion mit Less than setzt eine harte Obergrenze für Ihre API.
• Fehlererkennung: Eine Status-code-Assertion fängt unerwartete Fehler ab.
• Inhalt: Eine Body-Assertion bestätigt, dass die Antwort weiterhin den erwarteten Wert enthält, zum Beispiel einen Feldnamen oder ein Stichwort.

Mehrstufige Prüfungen unterstützen dieselben Assertions in jedem Schritt, siehe Mehrstufige API-Prüfungen.