Multi-step / API monitoring

Il monitoraggio multi-step esegue come un unico monitor una sequenza di richieste HTTP: effettua il login, salva un token, lo usa nel passaggio successivo e verifica la risposta tramite JSONPath. È ideale per monitorare API e flussi di accesso dove una singola richiesta non basta. Disponibile nei piani Pro e Business per i monitor HTTP.

Dove lo configuro?

1. Apri la pagina di dettaglio di un monitor HTTP.
2. Nella sezione Multi-step / API monitoring incolla l'elenco JSON dei passaggi e fai clic su Salva.
3. Un campo vuoto riporta il monitor a un controllo singolo classico.

Formato del passaggio

I passaggi sono un elenco JSON (max 10). Ogni passaggio è un oggetto con questi campi:

• url - l'indirizzo del passaggio (obbligatorio). Può contenere una variabile, ad es. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (GET predefinito).
• headers - un oggetto di intestazioni (facoltativo).
• body - il corpo della richiesta come testo (facoltativo).
• expect_status - stato HTTP atteso (200 predefinito).
• expect_contains - testo che deve essere presente nella risposta.
• expect_jsonpath + expect_value - un percorso nella risposta JSON e il valore atteso.
• save - un oggetto variabile → JSONPath; il valore viene memorizzato per i passaggi successivi.
• name - un'etichetta del passaggio mostrata nel messaggio di errore (facoltativo).

Esempio: accesso + verifica

[
  {
    "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

Supporta la notazione con punti e gli indici di array: data.items[0].id, user.name, prefisso facoltativo $..

Da sapere

• Un monitor multi-step viene eseguito solo dalla regione principale (il consenso multiregione viene saltato).
• Gli indirizzi di destinazione non devono puntare alla rete interna (stessa protezione dei monitor normali).
• Le variabili da save sono valide solo all'interno di un singolo controllo.