Multi-step / API monitoring

A monitorização multi-step executa uma sequência de pedidos HTTP como um único monitor: faz login, guarda um token, usa-o no passo seguinte e verifica a resposta via JSONPath. É ideal para monitorizar APIs e fluxos de início de sessão, onde um único pedido não chega. Disponível nos planos Profi e Business para monitores do tipo HTTP.

Onde o configuro?

1. Abra o detalhe de um monitor HTTP.
2. Na secção Multi-step / monitorização de API, cole o JSON com a lista de passos e clique em Guardar.
3. Um campo vazio devolve o monitor à verificação única clássica.

Formato dos passos

Os passos são uma lista JSON (máx. 10). Cada passo é um objeto com estes campos:

• url - o endereço do passo (obrigatório). Pode conter uma variável, p. ex. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (GET por predefinição).
• headers - um objeto de cabeçalhos (opcional).
• body - o corpo do pedido como texto (opcional).
• expect_status - o estado HTTP esperado (200 por predefinição).
• expect_contains - texto que tem de estar na resposta.
• expect_jsonpath + expect_value - o caminho na resposta JSON e o valor esperado.
• save - um objeto variável para JSONPath, o valor é guardado para os passos seguintes.
• name - o nome do passo na mensagem de erro (opcional).

Exemplo: início de sessão + verificação

[
  {
    "name": "início de sessão",
    "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

Suporta notação por pontos e índices de array: data.items[0].id, user.name, com prefixo $. opcional.

Bom saber

• Um monitor multi-step corre apenas a partir da região primária (o consenso multirregião é ignorado).
• Os endereços de destino não podem apontar para a rede interna (a mesma proteção que nos monitores habituais).
• As variáveis de save só são válidas dentro de uma única verificação.