Multi-step / API monitoring

Multi-Step-Monitoring führt eine Sequenz von HTTP-Anfragen als einen einzigen Monitor aus: Es meldet sich an, speichert ein Token, verwendet es im nächsten Schritt und prüft die Antwort per JSONPath. Ideal für die Überwachung von APIs und Login-Abläufen, bei denen eine einzelne Anfrage nicht ausreicht. Verfügbar in den Tarifen Pro und Business für Monitore vom Typ HTTP.

Wo richte ich das ein?

1. Öffnen Sie das Detail eines HTTP-Monitors.
2. Fügen Sie im Abschnitt Multi-Step / API-Monitoring das JSON mit der Liste der Schritte ein und klicken Sie auf Speichern.
3. Ein leeres Feld setzt den Monitor auf die klassische einmalige Prüfung zurück.

Format der Schritte

Die Schritte sind eine JSON-Liste (max. 10). Jeder Schritt ist ein Objekt mit diesen Feldern:

• url - die Adresse des Schritts (Pflicht). Kann eine Variable enthalten, z. B. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (standardmäßig GET).
• headers - ein Objekt mit Headern (optional).
• body - der Anfrage-Body als Text (optional).
• expect_status - der erwartete HTTP-Status (standardmäßig 200).
• expect_contains - Text, der in der Antwort enthalten sein muss.
• expect_jsonpath + expect_value - der Pfad in der JSON-Antwort und der erwartete Wert.
• save - ein Objekt Variable zu JSONPath, der Wert wird für die nächsten Schritte gespeichert.
• name - der Name des Schritts in der Fehlermeldung (optional).

Beispiel: Anmeldung + Überprüfung

[
  {
    "name": "Anmeldung",
    "method": "POST",
    "url": "https://api.example.com/auth/login",
    "headers": { "Content-Type": "application/json" },
    "body": "{\"user\": \"demo\", \"pass\": \"...\"}",
    "expect_status": 200,
    "save": { "token": "data.access_token" }
  },
  {
    "name": "Profil",
    "url": "https://api.example.com/me",
    "headers": { "Authorization": "Bearer " },
    "expect_jsonpath": "user.active",
    "expect_value": "True"
  }
]

JSONPath

Unterstützt Punktnotation und Array-Indizes: data.items[0].id, user.name, mit optionalem Präfix $..

Gut zu wissen

• Ein Multi-Step-Monitor läuft nur aus der primären Region (der Multi-Region-Konsens wird übersprungen).
• Zieladressen dürfen nicht in das interne Netzwerk zeigen (derselbe Schutz wie bei gewöhnlichen Monitoren).
• Variablen aus save gelten nur innerhalb einer einzelnen Prüfung.