API Reference: Создание и управление мониторами

REST API для автоматизации вашего мониторинга. Интегрируйте PulseKit в CI/CD пайплайны и системы управления инцидентами.

Смотреть Endpoints SDK и Библиотеки

Аутентификация

Все запросы к API требуют авторизации через Bearer-токен. Получите ваш API-ключ в личном кабинете в разделе "Настройки" → "Интеграции".

curl -X GET https://api.pulsekit.ru/v1/monitors \
  -H "Authorization: Bearer pk_live_51MzXk9sLp2vBqRtYw8J"

Используйте префикс pk_live_ для продакшн-среды и pk_test_ для тестовых окружений. Никогда не передавайте ключи в клиентском JavaScript коде.

Основные Endpoints

PulseKit предоставляет RESTful интерфейсы для полного управления ресурсами мониторинга.

POST /v1/monitors

Создание нового монитора. Поддерживает HTTP, HTTPS, TCP и Ping протоколы.

Настройка интервала проверки (от 60 сек)
Выбор региона проверки (Москва, Новосибирск)
Настройка уведомлений (Telegram, Email)

GET /v1/monitors/{id}/logs

Получение истории проверок и логов инцидентов для конкретного ресурса.

Фильтрация по дате и статусу
Время отклика (TTFB)
Коды ответов HTTP

PUT /v1/status-pages/{id}

Управление статус-страницами. Обновление компонентов и публикация сообщений об инцидентах.

Синхронизация с мониторами
Webhook-уведомления
Кастомизация виджетов

Примеры использования

Быстрый старт для разработчиков. Создайте монитор для проверки доступности вашего API.

Пример кода интеграции API PulseKit в редакторе кода

Python (requests)

import requests

API_KEY = "pk_live_51MzXk9sLp2vBqRtYw8J"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

payload = {
    "name": "API Gateway - Production",
    "url": "https://api.mycompany.ru/health",
    "interval": 300,
    "type": "https",
    "locations": ["ru-mow", "ru-nov"]
}

response = requests.post("https://api.pulsekit.ru/v1/monitors", json=payload, headers=HEADERS)
print(response.json())

Rate Limits и SLA

Для обеспечения стабильности сервиса применяются ограничения на частоту запросов.

Free Tier

100 запросов в минуту. Ограничение на создание 5 мониторов одновременно.

Business Tier

1000 запросов в минуту. Приоритетная обработка логов и расширенная история (30 дней).

Enterprise

Неограниченные запросы. Выделенный IP-адрес для проверок и SLA 99.99%.

При превышении лимита API возвращает статус 429 Too Many Requests. Заголовки ответа X-RateLimit-Limit и X-RateLimit-Remaining показывают текущий статус лимитов.