Multi-step / API monitoring

La monitorización multietapa (multi-step) ejecuta una secuencia de solicitudes HTTP como un solo monitor: inicia sesión, guarda un token, lo usa en el siguiente paso y verifica la respuesta mediante JSONPath. Es ideal para monitorizar API y flujos de inicio de sesión, donde una sola solicitud no basta. Disponible en los planes Profi y Business para monitores de tipo HTTP.

¿Dónde lo configuro?

1. Abra el detalle de un monitor HTTP.
2. En la sección Multietapa / monitorización de API, pegue el JSON con la lista de pasos y haga clic en Guardar.
3. Un campo vacío devuelve el monitor a la comprobación única clásica.

Formato de los pasos

Los pasos son una lista JSON (máx. 10). Cada paso es un objeto con estos campos:

• url - la dirección del paso (obligatorio). Puede contener una variable, p. ej. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (GET por defecto).
• headers - un objeto de cabeceras (opcional).
• body - el cuerpo de la solicitud como texto (opcional).
• expect_status - el estado HTTP esperado (200 por defecto).
• expect_contains - texto que debe aparecer en la respuesta.
• expect_jsonpath + expect_value - la ruta en la respuesta JSON y el valor esperado.
• save - un objeto variable hacia JSONPath, el valor se guarda para los siguientes pasos.
• name - el nombre del paso en el mensaje de error (opcional).

Ejemplo: inicio de sesión + verificación

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

JSONPath

Admite notación de puntos e índices de array: data.items[0].id, user.name, con un prefijo $. opcional.

Bueno saberlo

• Un monitor multietapa se ejecuta solo desde la región principal (el consenso multirregión se omite).
• Las direcciones de destino no deben apuntar a la red interna (la misma protección que en los monitores habituales).
• Las variables de save solo son válidas dentro de una única comprobación.