# 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" %}
[box-updates-webhook-2](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/97ee805bdffc95edc133e571d77762ba532fe11f64040af3ffa3dad91d141508.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260530%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260530T125522Z\&X-Amz-Expires=172800\&X-Amz-Signature=7f9897b980b68cdd27dd2afa5667098eded84656f9ecce45548c357ac00988ae\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

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

***

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

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

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

***

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

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

***

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.expirenza.com/public-api/boxes-webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.