Multi-step / API monitoring

Multi-step monitoring voert een reeks HTTP-verzoeken uit als één monitor: het logt in, slaat een token op, gebruikt dit in de volgende stap en controleert het antwoord via JSONPath. Ideaal voor het monitoren van API's en aanmeldprocessen, waar één verzoek niet volstaat. Beschikbaar in de plannen Pro en Business voor monitors van het type HTTP.

Waar stel ik dit in?

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

Formaat van de stappen

De stappen zijn een JSON-lijst (max. 10). Elke stap is een object met deze velden:

• url - het adres van de stap (verplicht). Kan een variabele bevatten, bijv. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (standaard GET).
• headers - een object met headers (optioneel).
• body - de body van het verzoek als tekst (optioneel).
• expect_status - de verwachte HTTP-status (standaard 200).
• expect_contains - tekst die in het antwoord aanwezig moet zijn.
• expect_jsonpath + expect_value - het pad in het JSON-antwoord en de verwachte waarde.
• save - een object variabele naar JSONPath, de waarde wordt opgeslagen voor de volgende stappen.
• name - de naam van de stap in de foutmelding (optioneel).

Voorbeeld: aanmelden + verificatie

[
  {
    "name": "aanmelden",
    "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": "profiel",
    "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, met een optionele $. prefix.

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 bij gewone monitors).
• Variabelen uit save gelden alleen binnen één controle.