Multi-step / API monitoring

Monitorowanie wieloetapowe (multi-step) wykonuje sekwencję żądań HTTP jako jeden monitor: loguje się, zapisuje token, używa go w kolejnym kroku i weryfikuje odpowiedź przez JSONPath. Sprawdza się przy monitorowaniu API i procesów logowania, gdzie jedno żądanie nie wystarcza. Dostępne w planach Profi i Business dla monitorów typu HTTP.

Gdzie to ustawię?

1. Otwórz szczegóły monitora HTTP.
2. W sekcji Multi-step / monitorowanie API wklej JSON z listą kroków i kliknij Zapisz.
3. Puste pole przywraca monitor do klasycznej jednorazowej kontroli.

Format kroków

Kroki to lista JSON (maks. 10). Każdy krok to obiekt z następującymi polami:

• url - adres kroku (wymagane). Może zawierać zmienną, np. .
• method - GET, POST, PUT, PATCH, DELETE, HEAD (domyślnie GET).
• headers - obiekt nagłówków (opcjonalne).
• body - treść żądania jako tekst (opcjonalne).
• expect_status - oczekiwany status HTTP (domyślnie 200).
• expect_contains - tekst, który musi znaleźć się w odpowiedzi.
• expect_jsonpath + expect_value - ścieżka w odpowiedzi JSON i oczekiwana wartość.
• save - obiekt zmienna do JSONPath, wartość jest zapisywana dla kolejnych kroków.
• name - nazwa kroku w komunikacie błędu (opcjonalne).

Przykład: logowanie + weryfikacja

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

JSONPath

Obsługuje notację kropkową i indeksy tablic: data.items[0].id, user.name, z opcjonalnym prefiksem $..

Warto wiedzieć

• Monitor wieloetapowy działa tylko z regionu podstawowego (konsensus wieloregionowy jest pomijany).
• Adresy docelowe nie mogą kierować do sieci wewnętrznej (taka sama ochrona jak przy zwykłych monitorach).
• Zmienne z save obowiązują tylko w ramach jednej kontroli.