Multi-step / API monitoring

Multi-step monitoring voert als één monitor een reeks HTTP-verzoeken uit: het logt in, slaat een token op, gebruikt dit in de volgende stap en verifieert de respons via JSONPath. Het is ideaal voor het monitoren van API's en aanmeldstromen waarbij één verzoek niet volstaat. Beschikbaar in de plannen Pro en Business voor HTTP-monitors.

Waar stel ik dit in?

1. Open de detailpagina van een HTTP-monitor.
2. Plak in de sectie Multi-step / API monitoring de JSON-lijst met stappen en klik op Opslaan.
3. Een leeg veld zet de monitor terug naar een klassieke enkele controle.

Stapformaat

Stappen vormen een JSON-lijst (max. 10). Elke stap is een object met deze velden:

• url - het adres van de stap (verplicht). Mag een variabele bevatten, bijv. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (standaard GET).
• headers - een headers-object (optioneel).
• body - de body van het verzoek als tekst (optioneel).
• expect_status - verwachte HTTP-status (standaard 200).
• expect_contains - tekst die in de respons aanwezig moet zijn.
• expect_jsonpath + expect_value - een pad in de JSON-respons en de verwachte waarde.
• save - een object variabele → JSONPath; de waarde wordt bewaard voor latere stappen.
• name - een staplabel dat in de foutmelding wordt getoond (optioneel).

Voorbeeld: aanmelden + verificatie

[
  {
    "name": "login",
    "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": "profile",
    "url": "https://api.example.com/me",
    "headers": { "Authorization": "Bearer " },
    "expect_jsonpath": "user.active",
    "expect_value": "True"
  }
]

JSONPath

Ondersteunt puntnotatie en array-indexen: data.items[0].id, user.name, optioneel voorvoegsel $..

Goed om te weten

• Een multi-step monitor draait alleen vanuit de primaire regio (de multiregio-consensus wordt overgeslagen).
• Doeladressen mogen niet naar het interne netwerk verwijzen (dezelfde bescherming als gewone monitors).
• Variabelen uit save zijn alleen geldig binnen één controle.