DOZOR 8 из 8 систем в норме Войти

APIПроверки, инциденты, дежурства.

REST и JSON. Примеры ниже показаны на данных магазина «Северный ветер»: сервис payments-api и инцидент INC-2042.

Начало работы

Адрес
https://api.dozorru.ru/v1
Токен
Создаёт администратор в кабинете: «Интеграции», раздел API. Токен передаётся в заголовке Authorization: Bearer.
Формат
Тела запросов и ответов в JSON, кодировка UTF-8. Время в ответах в формате ISO 8601 с часовым поясом, для Москвы это +03:00.
Идентификаторы
Инциденты называются INC- и номер, проверки chk_, сигналы «я жив» hb_.

GET/checks

Список проверок

Все проверки аккаунта с текущим состоянием. Фильтр по сервису: ?service=payments-api.

Запрос
curl https://api.dozorru.ru/v1/checks \
  -H "Authorization: Bearer $DOZOR_TOKEN"
Ответ
{
  "items": [
    {
      "id": "chk_pay_health",
      "service": "payments-api",
      "type": "http",
      "path": "/api/pay/health",
      "interval_s": 30,
      "threshold_ms": 800,
      "locations": ["msk-1", "nsk-1", "fra-1"],
      "state": "ok",
      "p95_ms": 182
    }
  ]
}

POST/checks

Создать проверку

Ставит сайт, API или сервер на проверку. Три проверки подряд выше порога открывают инцидент.

Запрос
curl -X POST https://api.dozorru.ru/v1/checks \
  -H "Authorization: Bearer $DOZOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "payments-api",
    "type": "http",
    "path": "/api/pay/health",
    "interval_s": 30,
    "threshold_ms": 800,
    "locations": ["msk-1", "nsk-1", "fra-1"]
  }'
Ответ
{
  "id": "chk_pay_health",
  "state": "pending",
  "created_at": "2026-10-12T03:01:12+03:00"
}

POST/heartbeats/{id}

Сигнал «я жив»

Для cron-задач. Задача зовёт адрес после каждого успешного запуска. Если сигнала нет дольше положенного, DOZOR открывает инцидент.

Запрос
curl -X POST https://api.dozorru.ru/v1/heartbeats/hb_nightly_backup \
  -H "Authorization: Bearer $DOZOR_TOKEN"
Ответ
{
  "ok": true,
  "next_expected_before": "2026-10-13T03:30:00+03:00"
}

GET/incidents

Список инцидентов

Параметр status принимает open, investigating и resolved.

Запрос
curl "https://api.dozorru.ru/v1/incidents?status=open" \
  -H "Authorization: Bearer $DOZOR_TOKEN"
Ответ
{
  "items": [
    {
      "id": "INC-2042",
      "service": "payments-api",
      "severity": "SEV-2",
      "status": "open",
      "opened_at": "2026-10-12T03:12:04+03:00",
      "assignee": "Анна Котова",
      "release": "v4.18"
    }
  ]
}

POST/incidents/{id}/ack

Принять инцидент

То же, что кнопка «Принять» в кабинете дежурного. Звонок и эскалация по графику прекращаются.

Запрос
curl -X POST https://api.dozorru.ru/v1/incidents/INC-2042/ack \
  -H "Authorization: Bearer $DOZOR_TOKEN"
Ответ
{
  "id": "INC-2042",
  "status": "investigating",
  "acked_by": "Анна Котова",
  "acked_at": "2026-10-12T03:13:20+03:00"
}

POST/incidents/{id}/resolve

Закрыть инцидент

Переводит инцидент в «решён». Заметка попадёт в хронологию и в черновик разбора.

Запрос
curl -X POST https://api.dozorru.ru/v1/incidents/INC-2042/resolve \
  -H "Authorization: Bearer $DOZOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note": "Откат на v4.17"}'
Ответ
{
  "id": "INC-2042",
  "status": "resolved",
  "resolved_at": "2026-10-12T03:19:08+03:00",
  "duration_s": 424
}

GET/oncall

Кто дежурит сейчас

Текущий дежурный и цепочка эскалации. Удобно для чат-ботов и для проверки графика.

Запрос
curl https://api.dozorru.ru/v1/oncall \
  -H "Authorization: Bearer $DOZOR_TOKEN"
Ответ
{
  "now": {
    "name": "Анна Котова",
    "until": "2026-10-12T20:00:00+03:00",
    "channels": ["call", "push", "telegram"]
  },
  "escalation": [
    { "after_min": 5,  "name": "Илья Марков" },
    { "after_min": 15, "name": "Ринат Сафин" }
  ]
}

POST/status/updates

Запись на странице статуса

Обычно DOZOR публикует запись сам при открытии инцидента. Метод нужен, чтобы написать её вручную, например для плановых работ.

Запрос
curl -X POST https://api.dozorru.ru/v1/status/updates \
  -H "Authorization: Bearer $DOZOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "services": ["payments", "cart"],
    "state": "degraded",
    "text": "Оплата работает медленно. Знаем о проблеме и уже чиним."
  }'
Ответ
{
  "id": "upd_8f31c2",
  "state": "degraded",
  "published_at": "2026-10-12T03:15:02+03:00"
}

Токен выдаёт администратор.

Зайдите в кабинет администратора, откройте «Интеграции» и создайте токен. Дальше запросы из примеров работают с вашими данными.

Войти как администратор