API Monitor
Мониторинг API позволяет отслеживать доступность, производительность и корректность ваших HTTP/REST API. Status200 периодически отправляет HTTP-запросы к эндпоинтам и оценивает ответы по заданным правилам.
Обзор
API monitor выполняет HTTP-запросы и проверяет ответы. Это даёт возможность:
- контролировать uptime и доступность API;
- отслеживать время отклика и производительность;
- проверять HTTP status code и тело ответа;
- валидировать заголовки ответа;
- использовать разные HTTP-методы (GET, POST, PUT, DELETE и т.д.);
- передавать свои заголовки и тело запроса.
Создание API Monitor
- В dashboard Status200 откройте Monitors.
- Create Monitor.
- Тип монитора: API.
- Укажите URL API и параметры запроса.
- Настройте критерии мониторинга.
Параметры
URL API
Полный URL эндпоинта (например, https://api.example.com/v1/health).
Динамические плейсхолдеры в URL
За CDN или кэширующим прокси ответ может приходить из кэша, а не с origin. Чтобы на каждой проверке обходить кэш, в URL можно подставлять плейсхолдеры — они заменяются уникальным значением при каждом запросе монитора.
Поддерживаемые плейсхолдеры
| Плейсхолдер | Описание | Пример значения |
|---|---|---|
{{timestamp}} | Текущий Unix timestamp (секунды) | 1719500000 |
{{random}} | Случайная уникальная строка | a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c5 |
Пример
URL с плейсхолдером:
https://api.example.com/health?cb={{timestamp}}При каждой проверке URL становится, например:
https://api.example.com/health?cb=1719500000
https://api.example.com/health?cb=1719500005
...Вариант с {{random}}:
https://api.example.com/health?nocache={{random}}Тип запроса API
HTTP-метод:
- GET (по умолчанию)
- POST
- PUT
- DELETE
- PATCH
- HEAD
Дополнительно
Заголовки запроса
Произвольные HTTP-заголовки: токены аутентификации, Content-Type и др.
В значениях заголовков можно использовать Monitor Secrets для секретов вроде API keys.
Тело запроса (JSON)
Для POST, PUT и PATCH — JSON body. Monitor Secrets допускаются и в теле.
Не следовать редиректам
По умолчанию Status200 следует за редиректами (301, 302 и т.д.). Включите опцию, если нужно проверять именно ответ редиректа, а не конечный URL.
Критерии мониторинга
Состояние online / degraded / offline можно задать по:
- коду ответа — ожидаемые HTTP-коды (например, 200, 201);
- времени отклика — порог по latency;
- телу ответа — наличие или соответствие фрагментам;
- заголовкам ответа — наличие или значения;
- JavaScript Expression — свои выражения над ответом: JavaScript Expressions.