Вебхуки

(Инфраструктура доставки — волна 2; формат тела ниже фиксирован уже сейчас, чтобы ранние интеграции не пришлось переделывать.)

Solved отправляет вебхуки в формате Standard Webhooks:

webhook-id: evt_01J9Z4A7R3V5W2XN4V6B0RTC5H
webhook-timestamp: 1790000041
webhook-signature: v1,<base64 HMAC-SHA256 от "id.timestamp.body">

{ "id": "evt_01J…", "type": "link.created", "api_version": "v1",
  "created_at": "2026-10-02T12:00:00Z",
  "data": { "object": { "id": "lnk_01J9Z…", "short_url": "https://slv.link/spring-sale" } } }

Проверяйте подпись сами — не доверяйте неподписанному телу — и отклоняйте метку времени старше 5 минут (защита от повтора). Каждая попытка доставки подписывается заново, поэтому ретрай через час с той же подписью всё равно пройдёт проверку. При ротации секрета подписи 24 часа подписываем обоими секретами сразу, чтобы переезд не терял события.

Доставка: только HTTPS, таймаут 10 с, повторы через 5 с / 5 мин / 30 мин / 2 ч / 5 ч / 10 ч / 10 ч (~27 ч), после 5 дней сплошных неудач подписка отключается. Порядок не гарантирован — используйте created_at или тип события, а не порядок получения.

Пропустили событие или ещё не готовы держать приёмник? Опрашивайте вместо подписки: GET /v1/events?type=…&created_after=…, та же курсорная пагинация, что и везде, хранение 30 дней.

Далее: Долгие операции · Идемпотентность