# Webhook отримання оновлень по Боксам

> **Призначення:** цей вебхук повідомляє про будь-яку зміну стану Бокса в Expirenza (створення, викуп, повернення до доступності, редагування рестораном).

***

### 1. Опис

* Подія надсилається, коли:
  * створено новий Бокс (з’явився у продажу);
  * усі порції викуплено (`availableQuantity = 0`);
  * Бокс знову став доступним (після відмови клієнта);
  * змінено назву, опис, ціну, time-slot тощо.

> Expirenza залишає за собою право призупинити або вимкнути вебхук для будь-якого інтегратора без попередження.

***

### 2. Як підписатися

1. Заповніть форму:
   * **Номер телефону** — для швидкого контакту.
   * **E-mail** — для технічних сповіщень.
   * **URL** — endpoint, що прийматиме `POST`.
2. Посилання на форму [тут](https://example.com).
3. Після модерації ми активуємо надсилання подій на вказаний URL.
4. Expirenza залишає за собою право призупинити або вимкнути вебхук для будь-якого інтегратора без попередження.

***

### 3. Специфікація та приклад

{% openapi-webhook spec="box-updates-webhook-2" name="BoxUpdated" method="post" %}
[Broken link](https://docs.expirenza.com/public-api/broken-reference)
{% endopenapi-webhook %}

> Заголовки `Accept`, `Content-Type: application/json` та `Content-Length` додаються автоматично і тут не дублюються.

***

### 4. Очікувана відповідь клієнта

| HTTP код | Коли надсилати          |
| -------- | ----------------------- |
| **200**  | Подія успішно оброблена |

Будь-який інший код (4xx/5xx) трактуватиметься як помилка, і подію буде надіслано повторно з експоненційною затримкою.

***

### 5. Застереження щодо змін

Expirenza може додавати **нові необов’язкові поля** або розширювати словники без попереднього повідомлення.\
Переконайтеся, що парсер ігнорує невідомі атрибути, щоб інтеграція залишалася стійкою.

***

### 6. Зміни версій

| Дата           | Версія | Опис             |
| -------------- | ------ | ---------------- |
| **2025-05-07** | 1.0.0  | Початкова версія |