Руководство UpRadar — все разделы

Формат webhook-уведомлений

Webhook-уведомления позволяют отправлять события UpRadar во внешние системы (incident-management, чат-боты, внутренние интеграции). UpRadar делает HTTP POST с JSON-телом на указанный URL.

Формат payload

Пример события incident_down:

{
  "event": "incident_down",
  "monitor": {
    "id": "b7f0f6c5-2a95-4df6-8a42-0e2adfd4e1f7",
    "name": "API Production",
    "url": "https://api.example.com/health"
  },
  "project_id": "5f7d6d09-c41d-42d8-b9e3-84051b7f6387",
  "timestamp": "2026-04-08T10:30:05.000Z",
  "incident_id": "8b84e339-3dc1-4e86-bef8-53f8cc3a5c8a",
  "failure_reason": "HTTP 503"
}

Пример события incident_up:

{
  "event": "incident_up",
  "monitor": {
    "id": "b7f0f6c5-2a95-4df6-8a42-0e2adfd4e1f7",
    "name": "API Production",
    "url": "https://api.example.com/health"
  },
  "project_id": "5f7d6d09-c41d-42d8-b9e3-84051b7f6387",
  "timestamp": "2026-04-08T10:40:10.000Z",
  "incident_id": "8b84e339-3dc1-4e86-bef8-53f8cc3a5c8a",
  "duration_seconds": 605
}

Для SSL/domain alert-типов используются поля alert_id, severity, days_until_expiry и предметное поле (cert_subject или domain).

Описание ключевых полей

  • event — Тип события (например: incident_down, incident_up, ssl_expiry, domain_expiry).
  • monitor.id — Публичный идентификатор монитора.
  • project_id — Публичный идентификатор проекта.
  • timestamp — Время отправки webhook (ISO 8601, UTC).
  • incident_id / alert_id — Идентификатор сущности события: инцидента или alert-записи.

HTTP-заголовки

Content-Type: application/json
User-Agent: UpRadar/1.0

Таймаут и доставка

UpRadar выполняет одну попытку доставки webhook с таймаутом 5 секунд. Если endpoint не отвечает вовремя или возвращает код вне диапазона 2xx, отправка считается неуспешной.

Идемпотентность на вашей стороне. Используйте связку event + incident_id (или event + alert_id) как ключ дедупликации.