Eine API kann schnell antworten – und trotzdem das Falsche liefern: ein Fehlerobjekt mit Status 200, eine leere Liste oder eine Login-Seite. Ein Monitor vom Typ Website or API mit Antwortprüfungen erkennt solche Fälle.
Monitor anlegen
Öffnen Sie Monitors, wählen Sie New monitor und dann Website or API.Geben Sie die URL des Endpunkts ein und legen Sie unter Check every fest, wie oft geprüft wird.Wählen Sie in der Karte Request and response die Option Keyword, headers and more.
Die Anfrage
Method: GET, HEAD, POST, PUT, PATCH, DELETE oder OPTIONS.Request headers: einer pro Zeile im Format Name: value, etwa ein API-Schlüssel oder Accept: application/json.Request body, zum Beispiel JSON für einen POST.Follow redirects, Verify TLS certificate und Timeout (s).
Die Antwort
Expected status codes: Codes oder Bereiche, etwa 200-299, 301. Jeder andere Status gilt als Ausfall.Keyword: ein Text, den die Antwort enthalten oder nicht enthalten muss. Groß- und Kleinschreibung wird beachtet.Response checks: JSON-Felder und Header, etwa $.status gleich ok. Bis zu 10, und alle müssen zutreffen.
Mit Test request sehen Sie die Antwort, bevor Sie speichern.
Langsame Antworten und Timing
Setzen Sie Alert when slower than (ms), zum Beispiel auf 2000. Sind drei Checks hintereinander langsamer, wechselt der Monitor auf „langsam“, und Ihre Kanäle erhalten einen Langsam-Alarm; langsame Zeit zählt nicht als Ausfallzeit. Die Antwortzeit jedes Checks ist in DNS, Verbindung, TLS, Server und Download aufgeschlüsselt, damit Sie sehen, wo die Zeit verloren geht. Siehe Alarme bei langsamen Antworten.
APIs mit mehreren Schritten
Hängt ein Aufruf von einem anderen ab, etwa von einem Login, der ein Token liefert, nutzen Sie stattdessen einen Multi-Step-Flow.
Nutzen Sie nach Möglichkeit einen eigenen Health-Endpunkt; siehe Health-Check-Endpunkt erstellen und die Checkliste für API-Monitoring. Mehr zum API-Monitoring.