Assertions

API-Pruefung Assertions

Was sind Assertions?

Assertions sind Bedingungen, die Sie festlegen, um den Statuscode und die Antwortzeit Ihrer API-Anfrage zu validieren. Sie helfen sicherzustellen, dass sich Ihre API unter verschiedenen Bedingungen wie erwartet verhaelt. Wenn eine oder mehrere Assertions fehlschlagen, wird eine Warnung ausgeloest, die es Ihnen ermoeglicht, sofort zu handeln.

Arten von Assertions

Sie koennen folgende Arten von Assertions fuer Ihre API-Pruefungen festlegen:

  • Antwortzeit: Legen Sie einen Wert fest und pruefen Sie dagegen. Wenn die Antwortzeit den angegebenen Wert ueberschreitet, schlaegt die Assertion fehl, was zum Fehlschlagen des Tests fuehrt.
  • Statuscode: Geben Sie den erwarteten Statuscode der API-Antwort an. Wenn der Antwortcode vom erwarteten Wert abweicht, schlaegt die Assertion fehl, was zum Fehlschlagen der API-Pruefung fuehrt.

Assertions festlegen

Fehlgeschlagene Assertions und Pruefungsdetails

Wenn eine Assertion fehlschlaegt, werden die Details des Fehlers auf der Pruefungsdetailseite sichtbar. Dies umfasst Informationen darueber, welche Assertion fehlgeschlagen ist und warum, was Ihnen hilft, Probleme schnell zu identifizieren und zu beheben.

Zusammenspiel mit Antwortzeit-Limits

Wenn eine Pruefung ein Antwortzeit-Limit hat und als verschlechtert markiert ist, aber auch eine fehlschlagende Assertion hat, wird die Pruefung als fehlgeschlagen markiert. Dies stellt sicher, dass alle kritischen Probleme umgehend erfasst und behoben werden.

So legen Sie Assertions fest

  1. Assertions-Einstellungen aufrufen: Navigieren Sie zu den Assertions-Einstellungen fuer Ihre API-Pruefung.
  2. Assertions hinzufuegen: Geben Sie den Typ der Assertion an, die Sie hinzufuegen moechten (Antwortzeit, Statuscode).
  3. Kriterien festlegen: Definieren Sie die Kriterien fuer die Assertion (z. B. erwarteter Statuscode, maximale Antwortzeit).
  4. Einstellungen speichern: Stellen Sie sicher, dass Sie Ihre Einstellungen speichern, um die Assertions anzuwenden.

Praktische Anwendungsfaelle

  • Leistungsueberwachung: Verwenden Sie Antwortzeit-Assertions, um sicherzustellen, dass Ihre API die Leistungsbenchmarks erfuellt.
  • Fehlererkennung: Verwenden Sie Statuscode-Assertions, um unerwartete Fehler oder Ausfaelle in Ihrer API zu erkennen.

Durch die Verwendung von Assertions koennen Sie sicherstellen, dass Ihre APIs wie erwartet funktionieren und die richtigen Daten liefern, was zur Aufrechterhaltung der Zuverlaessigkeit und Leistung Ihrer Dienste beitraegt.