Перейти до вмісту

Зміни та версії

Версіонується Shop API, у шляху: /v1/shop/…. Віджет версій не має — CDN Neocarts завжди віддає актуальну, зворотно сумісну збірку.

  • Зміна, що ламає сумісність (поле вилучене чи перейменоване, правило посилене, відповідь переформатована) виходить як нова мажорна версія. Попередня версія працює ще шість місяців після анонсу нової.
  • Додаткові зміни (нове необовʼязкове поле, новий ендпоінт, нове значення у відповіді) потрапляють у поточну версію без зміни номера. Інтеграція має ігнорувати невідомі поля у відповідях.
  • Текст повідомлень про помилки не є частиною контракту: він може змінюватися будь-коли. Будуйте логіку на статусах і ключах полів — див. Помилки.

Як ми повідомляємо про зміни

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)