Вебхуки iiko
Приём событий iikoCloud: типы, формат и регистрация.
4 мин чтения#api#webhooks#iiko#вебхуки
Приём событий из iikoCloud вынесен в отдельный сервис iiko-service со своим HTTP-портом (по умолчанию 3010).
Эндпоинты сервиса
GET
/health— статус сервиса и кэш токеновPOST
/webhooks/iiko— приёмник вебхуков iikoCloudТипы событий
DeliveryOrderUpdate— изменение заказа доставки.StopListUpdate— изменение стоп-листа.PersonalShiftUpdate— смены сотрудников.ErrorWebHook— ошибки на стороне iiko.
Пример payload
[
{
"eventType": "DeliveryOrderUpdate",
"eventTime": "2026-06-05T12:30:00.000Z",
"organizationId": "...",
"eventInfo": { "order": { "...": "..." } }
}
]Регистрация
Вебхуки регистрируются скриптом — он передаёт iiko публичный адрес приёмника из WEBHOOK_PUBLIC_URL:
npm run register-webhooks
Важно
Поле
iikoWebhookSecret для проверки HMAC-подписи зарезервировано в схеме, но проверка ещё не включена.