Multi-step / API monitoring

La surveillance multi-étapes exécute en un seul moniteur une séquence de requêtes HTTP : elle se connecte, enregistre un token, l'utilise à l'étape suivante et vérifie la réponse via JSONPath. Elle est idéale pour surveiller des API et des flux de connexion où une seule requête ne suffit pas. Disponible dans les forfaits Pro et Business pour les moniteurs HTTP.

Où le configurer ?

1. Ouvrez la page de détail d'un moniteur HTTP.
2. Dans la section Multi-step / API monitoring, collez la liste JSON des étapes et cliquez sur Enregistrer.
3. Un champ vide ramène le moniteur à une vérification simple classique.

Format d'une étape

Les étapes forment une liste JSON (max. 10). Chaque étape est un objet avec ces champs :

• url - l'adresse de l'étape (obligatoire). Peut contenir une variable, par ex. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (GET par défaut).
• headers - un objet d'en-têtes (facultatif).
• body - le corps de la requête sous forme de texte (facultatif).
• expect_status - statut HTTP attendu (200 par défaut).
• expect_contains - texte qui doit être présent dans la réponse.
• expect_jsonpath + expect_value - un chemin dans la réponse JSON et la valeur attendue.
• save - un objet variable → JSONPath ; la valeur est conservée pour les étapes suivantes.
• name - un libellé d'étape affiché dans le message d'erreur (facultatif).

Exemple : connexion + vérification

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

Prend en charge la notation par points et les index de tableau : data.items[0].id, user.name, préfixe facultatif $..

Bon à savoir

• Un moniteur multi-étapes s'exécute uniquement depuis la région principale (le consensus multirégion est ignoré).
• Les adresses cibles ne doivent pas pointer vers le réseau interne (même protection que les moniteurs classiques).
• Les variables issues de save ne sont valables que dans une seule vérification.