Webhook отримання оновлень по Боксам
Призначення: цей вебхук повідомляє про будь-яку зміну стану Бокса в Expirenza (створення, викуп, повернення до доступності, редагування рестораном).
1. Опис
Подія надсилається, коли:
створено новий Бокс (з’явився у продажу);
усі порції викуплено (
availableQuantity = 0
);Бокс знову став доступним (після відмови клієнта);
змінено назву, опис, ціну, time-slot тощо.
Expirenza залишає за собою право призупинити або вимкнути вебхук для будь-якого інтегратора без попередження.
2. Як підписатися
Заповніть форму:
Номер телефону — для швидкого контакту.
E-mail — для технічних сповіщень.
URL — endpoint, що прийматиме
POST
.
Посилання на форму тут.
Після модерації ми активуємо надсилання подій на вказаний URL.
Expirenza залишає за собою право призупинити або вимкнути вебхук для будь-якого інтегратора без попередження.
3. Специфікація та приклад
Унікальний ідентифікатор Бокса
Назва Бокса
Маркетинговий опис
Статус пропозиції (ACTIVE, SOLD_OUT, EXPIRED)
Обкладинка Бокса
Актуальна ціна, грн
Початкова ціна, грн
Загальна кількість пропозицій
Кількість доступних пропозицій
Публічне посилання на Бокс
Epoch-мілісекунди, коли зафіксовано зміну
Payload
{
"id": "72b5b1aa-ba8f-47e6-9339-29a93a15401e",
"name": "Бокс від Expirenza Restaurant",
"description": "Ви знаєте правила? ...",
"status": "ACTIVE",
"propositionImageUrl": "https://docs.expirenza.com/box.jpeg",
"timeSlot": {
"startDate": "2025-05-06T18:00:16.114+03:00",
"endDate": "2025-05-06T20:00:16.114+03:00"
},
"price": 259,
"originalPrice": 450,
"totalQuantity": 2,
"availableQuantity": 1,
"publicLink": "https://expz.menu/box/oUJP/uKok",
"restaurant": {
"name": "Expirenza Restaurant",
"address": "вул. Шевченко, буд. 2",
"city": "м. Київ",
"coordinates": {
"lat": 46.4316604,
"lng": 30.7260031
}
},
"tlm": 1746535104036
}
Заголовки
Accept
,Content-Type: application/json
таContent-Length
додаються автоматично і тут не дублюються.
4. Очікувана відповідь клієнта
200
Подія успішно оброблена
Будь-який інший код (4xx/5xx) трактуватиметься як помилка, і подію буде надіслано повторно з експоненційною затримкою.
5. Застереження щодо змін
Expirenza може додавати нові необов’язкові поля або розширювати словники без попереднього повідомлення. Переконайтеся, що парсер ігнорує невідомі атрибути, щоб інтеграція залишалася стійкою.
6. Зміни версій
2025-05-07
1.0.0
Початкова версія
Last updated