Кожен реліз API. Кожен breaking change. Зафіксовано.
Fabrixa випускає версії API та оновлення платформи з передбачуваною періодичністю. Кожен випуск спочатку з’являється саме тут — що змінилося, що нового, що виходить з ужитку та коли це фактично перестане працювати. Перевірте цю сторінку перед оновленням.
Що змінилося за останні кілька тижнів.
Спочатку найновіші записи. Кожен запис має дату, позначку версії за стандартом SemVer та віднесений до однієї зі стандартних категорій: Додано / Змінено / Визнано застарілим / Вилучено / Виправлено / Безпека.
- CHANGEDОстанні новини: базовий шлях перенесено до
/v2/integration. Кінцеві точки версії v1 виходять з ужитку — існуючі інтеграції з v1 продовжуватимуть працювати протягом періоду виведення з ужитку; див. посібник з інтеграції. - CHANGEDОстанні новини: аутентифікація тепер складається з двох заголовків —
Authorization: Bearer(токен доступу до додатка) плюсX-Application-Key. Аутентифікація за одним токеном (v1) більше не підтримується. - ADDEDFabrixa Studio — вбудований конфігуратор продукту під власний бренд: вбудовується за допомогою iframe, збережений дизайн можна додати до рядка замовлення за допомогою
cart_item_key, і завантажити попередній перегляд з/v2/studio/customizations/{key}/preview. - CHANGEDСтандартний конверт для відповіді на endpoints списку:
links/meta/dataз посиланнями на сторінки. - CHANGEDwebhooks об’єднано в
order.createdіorder.updated, підписано зx-webhook-signature(HMAC-SHA256) та позначено тегомx-webhook-topic. - CHANGEDОбмеження частоти запитів встановлено на рівні 30 запитів на додаток за хвилину, що відображається через
X-RateLimit-LimitіX-RateLimit-Remainingзаголовки.
- ADDED
GET /v1/products/:id/pricing- переглянути ціни за одиницю продукції на різних рівнях обсягу за SKU. - CHANGEDДані webhook тепер містять
production_hubполе (PT, ES або NL). Зворотна сумісність.
- ADDEDП'ятирежимний конвеєр персоналізації для постільної білизни, столового текстилю та аксесуарів: текст, ім'я, цифри, зображення та динамічні поля даних.
- ADDED
order.failedподія webhook зі структурованими причинами помилок (відхилення ілюстрації, відсутність тканини на складі тощо). - FIXEDВвімкнено обріз по краях сторінки
GET /v1/ordersпри фільтрації за статусом через межі сторінки.
- ADDEDПодушка для вулиці, скатертина та м'який мішок SKUs із синтетичних матеріалів для використання на відкритому повітрі. Можна придбати через
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64поле в тілі запиту — замість цього вкажіть URL-адресу вихідного файлу. Термін вилучення: v1.20.0 (28.03.2027). - SECURITYПосилено схему підпису webhooks. Попередній варіант HMAC залишається дійсним до версії v1.18.0; надалі автоматично застосовуватиметься новий спосіб підписання.
- ADDEDКатегорія постільної білизни (покривала на ковдри для односпальних, двоспальних та двох односпальних ліжок, покривала на ліжка, простирадла з гумкою) на іспанському сайті.
- ADDEDСерветка з сублімаційним друком SKUs на голландському логістичному центрі з гарантованим терміном виконання замовлення 2–3 робочих дні.
- CHANGEDКінцева точка замовлення тепер приймає
recipient.countryу форматі ISO 3166-1 альфа-2; запасний варіант альфа-3 було вилучено.
Старіші версії доступні за запитом — надішліть електронного листа developers@fabrixa.com.
SemVer із обережними змінами, що порушують сумісність.
Внесення змін до існуючих endpoints
Рідко. Анонсується за 12 місяців до випуску. Попередня основна версія підтримується протягом 12 місяців після випуску нової основної версії. Ми не припиняємо підтримку основних версій без вагомих підстав.
Нові endpoints, поля, поведінка
Доповнення, сумісні з попередніми версіями. Існуючий код продовжує працювати без змін. Більшість випусків є незначними і виходять з періодичністю приблизно раз на два-чотири тижні.
Виправлення помилок, продуктивність, безпека
Абсолютно неруйнівне оновлення. Впроваджується у режимі безперервної експлуатації без попереднього оголошення, а інформація про нього заноситься до журналу змін після впровадження.
12 місяців від повідомлення про вилучення до вилучення.
Коли ми відміняємо підтримку поля, endpoint або поведінки, у записі журналу змін це позначається відповідним тегом DEPRECATED а також вказує версію та дату, до якої планується припинення підтримки. Функціонал, що виходить з ужитку, продовжуватиме працювати щонайменше 12 місяців після опублікування повідомлення.
Ми надсилаємо три нагадування — за шість місяців, за три місяці та за один місяць до видалення — на адресу електронної пошти, вказану в обліковому записі для ключа API.
Застарілі endpoints також повертають X-Fabrixa-Deprecation заголовок відповіді, що вказує на шлях міграції, щоб його можна було побачити у ваших журналах.
Як відстежувати зміни.
Не потрібно підключати жодних каналів — ця сторінка є єдиним достовірним джерелом інформації. Ось як бути в курсі всього, що впливає на вашу інтеграцію.
Спочатку перевірте тут
На цій сторінці публікуються всі випуски, найновіші з яких розміщуються у верхній частині. Додайте її до закладок і перегляньте перед тим, як оновити залежність або випустити нову інтеграцію.
Вільна злітно-посадкова смуга
Коли щось виходить з обігу, відповідний запис позначається тегом DEPRECATED із зазначенням цільової версії та дати випуску — попереднє повідомлення в контексті.
Запитайте про зміну
Плануєте впровадження змін або перехід на нову версію? Інженер з рішень може детально пояснити вам терміни та наслідки вашої інтеграції.
Коли ламається, зміни можуть прийти.
Випуск нових версій планується на певні періоди, щоб вони не збігалися з датами припинення підтримки клієнтів або піковими сезонами роздрібної торгівлі. У більшості років випуск нових версій не відбувається.
Лютий і вересень — це типові періоди для впровадження кардинальних змін: вони припадають на час після завершення основного сезону роздрібних продажів і перед початком пікового сезону, що дає інтеграторам час на перехід до наступного великого спаду.
Листопад–грудень (передсвятковий сезон), березень–травень (виставка Fespa та весняні колекції), а також два тижні перед відомими галузевими заходами — це періоди, коли не допускаються зміни, що впливають на роботу програми. Випуск виправлень триває, але жодних незначних чи суттєвих змін у роботі програми не відбувається.
Інжиніринг рішень проводить інтеграторів через основні труднощі.
У разі випуску версій з істотними змінами ми публікуємо посібник з міграції разом із примітками до випуску. Підрозділ Solutions Engineering також проводить безкоштовні 30-хвилинні консультації з міграції для будь-якого активного партнера з інтеграції протягом періоду виведення з обігу — записуватися можна на сторінці «contact-engineer». Корпоративні клієнти отримують спеціалізовану підтримку з міграції в рамках своєї угоди MSA, а також ранній доступ до нової основної версії на тестовому каналі продажів за 90 днів до її публічного випуску.
Перш ніж виконати оновлення, перегляньте цю інформацію.
Кожне оновлення спочатку з’являється саме тут — що змінилося та коли виникають проблеми. Застарілі функції супроводжуються перехідним періодом, а при переході на нову версію надається підтримка міграції.