Multi-step / API monitoring

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

Dove lo imposto?

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

Formato dei passi

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

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

Esempio: accesso + verifica

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

JSONPath

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

Buono a sapersi

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