API

API: инциденты

Как получить список инцидентов, прочитать детали, подтвердить получение и добавить заметки через API.

Список

GET /incidents?monitorId=&status=open|resolved&from=&to=

Чтение

GET /incidents/{id}

{
  "id": "e5b4...",
  "monitorId": "a3f1...",
  "status": "resolved",
  "startedAt": "2026-01-19T09:39:12Z",
  "resolvedAt": "2026-01-19T09:41:22Z",
  "durationSec": 130,
  "cause": "http_status",
  "summary": "503 Service Unavailable",
  "confirmedBy": ["fra", "lon", "nyc"],
  "evidence": [
    { "region": "fra", "statusCode": 503, "responseMs": 412, "ip": "203.0.113.50", "bodyExcerpt": "<html><head><title>503 Service Unavailable" }
  ],
  "acknowledgedAt": "2026-01-19T09:40:02Z",
  "acknowledgedBy": "user:7c1d...",
  "notifications": [{ "channel": "telegram", "sentAt": "2026-01-19T09:39:14Z" }]
}

Подтверждение получения

POST /incidents/{id}/ack

Останавливает эскалацию. Возвращает обновлённый инцидент.

Заметки

POST /incidents/{id}/notes
{ "text": "Host restarted PHP-FPM." }

Заметки появляются в хронологии инцидента и в ежемесячном отчёте.

Ручные инциденты (страницы статуса)

POST /status-pages/{id}/incidents
{ "title": "Payment provider degraded", "status": "investigating", "componentIds": ["..."], "message": "..." }