API-вебхуки

Вебхуки

Вебхуки уведомляют ваше приложение в реальном времени о событиях в myumbrella.ai, например, о подаче новой претензии или активации контракта.

Настройка вебхуков

1. Перейдите в Настройки → Вебхуки → Добавить эндпоинт
2. Введите URL вашего эндпоинта (должен быть HTTPS)
3. Выберите события, которые хотите получать
4. Сохраните и скопируйте секрет подписи

Типы событий

Событие	Триггер
contract.created	Новый гарантийный контракт активирован
contract.cancelled	Контракт отменён или возвращён
claim.submitted	Подана новая претензия
claim.approved	Претензия одобрена для решения
claim.denied	Претензия отклонена
claim.resolved	Решение по претензии завершено
plan.updated	Конфигурация гарантийного плана изменена

Формат полезной нагрузки

{
  "id": "evt_abc123",
  "type": "claim.submitted",
  "created_at": "2025-01-15T10:30:00Z",
  "data": {
    "claim_id": "clm_xyz789",
    "contract_id": "ctr_def456",
    "customer_email": "jane@example.com",
    "issue_type": "accidental_damage",
    "amount": 299.99
  }
}

Проверка подписей

Каждый вебхук содержит заголовок X-Umbrella-Signature. Проверяйте его для обеспечения подлинности:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Политика повторных попыток

Неудачные доставки (ответ не 2xx) повторяются до 5 раз с экспоненциальной задержкой: 1 мин., 5 мин., 30 мин., 2 часа, 24 часа.