Новое: вебхуки по этапам и песочница API — читать

POST /webhooks

Создать вебхук

Регистрирует endpoint для получения событий. Возвращает секрет для проверки подписи.

Запрос

POSThttps://api.lumivik.eu/v2/webhooks

Параметры

ПараметрТипОбяз.Описание
urlstringдаhttps-адрес получателя
eventsarrayдасписок типов событий

Пример запроса

curl -X POST https://api.lumivik.eu/v2/webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://erp.example.com/hooks/lumivik", "events": ["shipment.eta.updated"]}'

Пример ответа

{
  "id": "wh_44",
  "secret": "whsec_..."
}

Ошибки

КодПричина
400неверные параметры запроса
401нет или просрочен токен
403нет прав на ресурс
404ресурс не найден
429превышен лимит запросов