Зміни та версії
Версіонується Shop API, у шляху: /v1/shop/…. Віджет версій не має — CDN Neocarts завжди віддає актуальну, зворотно сумісну збірку.
Політика
Section titled “Політика”- Зміна, що ламає сумісність (поле вилучене чи перейменоване, правило посилене, відповідь переформатована) виходить як нова мажорна версія. Попередня версія працює ще шість місяців після анонсу нової.
- Додаткові зміни (нове необовʼязкове поле, новий ендпоінт, нове значення у відповіді) потрапляють у поточну версію без зміни номера. Інтеграція має ігнорувати невідомі поля у відповідях.
- Текст повідомлень про помилки не є частиною контракту: він може змінюватися будь-коли. Будуйте логіку на статусах і ключах полів — див. Помилки.
Як ми повідомляємо про зміни
Section titled “Як ми повідомляємо про зміни”Кожен випуск — і новий мажорний, і додатковий у поточній версії — записується в таблиці нижче з датою; шість місяців підтримки попередньої версії відлічуються від цього запису.
Журнал
Section titled “Журнал”| Версія | Дата | Зміна |
|---|---|---|
v1 |
2026-10-14 | Вебхуки: у delivery.data ідентифікатори довідників розгорнуто в обʼєкти city, branch, parcel_locker, street — { id, external_id, name }, де external_id — ідентифікатор у перевізника. Раніше приходили лише наші city_id/branch_id, з яких ТТН не сформувати. Вебхуки не версіонуються; обробники, що читали *_id, треба оновити |
v1 |
2026-10 | Додатково: вебхуки — підписані POST на сервер магазину про замовлення, підписки й платежі; налаштування в панелі, «Інтеграція» |
v1 |
2026-09 | Перший випуск: товари (PUT /v1/shop/products/{external_id}, PUT …/price), створення замовлення (POST /v1/shop/orders/create), заміна складу (PUT /v1/shop/orders/{order}/items) |