API повторяет то, что есть в интерфейсе. Ключ создаётся в настройках команды и действует до отзыва.
| Поле | Значение |
|---|---|
| type | http | tcp | dns | cert | heartbeat |
| target | адрес или имя хоста |
| interval | 20, 60, 300 (секунды) |
| regions | список кодов регионов или auto |
| confirm_from | сколько точек должны подтвердить отказ, по умолчанию 2 |
Частая ошибка: confirm_from: 1 на проверке из одного региона. Тогда любая сетевая икота этой точки будит дежурного.
Отправляем POST с JSON при смене состояния. Повторяем до 5 раз с нарастающей паузой, дальше складываем в журнал доставки.
Заголовок с HMAC от тела. Проверяйте её — адрес вебхука рано или поздно утекает.
У события есть идентификатор. Повтор доставки приходит с тем же — не заводите второй инцидент.
Ждём ответ 5 секунд. Долгую обработку делайте асинхронной, иначе получите повторы.