Начало работы
- Адрес
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"
}