Всяко издание на API. Всяка промяна, изискваща пренастройка. Записано.
Fabrixa пуска версии API и актуализации на платформата по предвидим график. Всяка версия се публикува първо тук — какво се е променило, какво е новото, какво вече не се поддържа и кога точно ще престане да работи. Проверете тук, преди да направите ъпгрейд.
Какво се промени през последните няколко седмици.
Най-новите първи. Всеки запис е датиран, маркиран съгласно SemVer и разпределен в стандартните категории: Добавено / Променено / Отпаднало / Премахнато / Поправено / Сигурност.
- CHANGEDПоследни новини: базовата пътека беше преместена в
/v2/integration. Крайните точки от версия v1 са отменени — съществуващите интеграции от v1 продължават да функционират през периода на преход; вижте ръководство за интеграция. - CHANGEDПоследни новини: аутентификацията вече се състои от два хедъра —
Authorization: Bearer(токен за достъп до приложението) плюсX-Application-Key. Удостоверяването с един токен (v1) вече не се приема. - ADDEDFabrixa Studio — инструмент за персонализиране на продукти, който може да се вгради като „white-label“: вградете го чрез iframe, прикачете запазен дизайн към ред от поръчката с
cart_item_key, и извлечете предварителен преглед от/v2/studio/customizations/{key}/preview. - CHANGEDСтандартен отговор при достигане на крайните точки на списъка:
links/meta/dataс връзки за преминаване към следваща страница. - CHANGEDУебхуковете са обединени в
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Полето на уебхука „Order“ вече включва
production_hubполе (PT, ES или NL). Съвместимо с по-стари версии.
- ADDEDПетстепенен процес за персонализация на спално бельо, покривки за маса и аксесоари: текст, име, цифри, изображения и динамични полета за данни.
- ADDED
order.failedсъбитие чрез уебхук със структурирани причини за грешка (отхвърляне на графичен материал, изчерпани запаси от плат и други подобни). - FIXEDКрайни случаи при разбиването на страници при
GET /v1/ordersпри филтриране по статус, когато се преминава от една страница към друга.
- ADDEDВъншна възглавница, покривка за маса и пуф SKUs, предназначени за използване на открито, изработени от синтетични материали. Могат да бъдат закупени чрез
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64поле в тялото на заявката — вместо това въведете URL адреса на изходния файл. Цел за премахване: v1.20.0 (28.03.2027 г.). - SECURITYСхемата за подписване на уебхукове е подобрена. Предишният вариант на HMAC остава валиден до версия v1.18.0; оттук нататък новото подписване се прилага автоматично.
- ADDEDКатегория „Постелни принадлежности“ (калъфи за пухени завивки за 1 човек / 2 души / две единични легла, покривки за легла, чаршафи с ластик) в испанския център.
- ADDEDСалфетка за сублимационен печат SKUs в холандския център с гарантирано време за доставка от 2–3 работни дни.
- CHANGEDКрайната точка за поръчки вече приема
recipient.countryкато ISO 3166-1 алфа-2; резервният вариант алфа-3 беше премахнат.
По-стари версии се предоставят при поискване — изпратете имейл developers@fabrixa.com.
SemVer, с консервативни промени, нарушаващи съвместимостта.
Значителни промени в съществуващите крайни точки
Рядко. Обявява се 12 месеца преди пускането. Старата основна версия продължава да се поддържа в продължение на 12 месеца след пускането на новата основна версия. Не преминаваме към следваща основна версия лесно.
Нови крайни точки, полета, поведение
Допълнения, съвместими с по-старите версии. Съществуващият код продължава да работи без промени. Повечето версии са незначителни и се пускат на всеки около две до четири седмици.
Поправки на грешки, производителност, сигурност
Изцяло без прекъсване. Внедрява се непрекъснато без предварително уведомление, а промените се отразяват в дневника на промените след внедряването.
12 месеца от датата на уведомлението за преустановяване до премахването.
Когато обявим дадено поле, крайна точка или поведение за остаряло, то се маркира в записа в дневника на промените DEPRECATED и посочва версията и датата, към които ще бъде преустановена поддръжката. Преустановената функционалност ще продължи да работи поне 12 месеца след публикуването на уведомлението.
Изпращаме три напомнителни съобщения — шест месеца, три месеца и един месец преди премахването — на имейл адреса, регистриран за ключа API.
Остарелите крайни точки също връщат X-Fabrixa-Deprecation заглавие на отговора, което сочи към пътя на миграцията, така че да е видимо в логовете Ви.
Как да следите промените.
Няма нужда да свързвате канали — тази страница е основният източник на информация. Ето как да сте винаги в крак с всичко, което засяга Вашата интеграция.
Първо проверете тук
Всяка версия се публикува на тази страница, като най-новата е най-отгоре. Добавете я в отметките си и я прегледайте, преди да актуализирате някоя зависимост или да пуснете нова интеграция.
Свободна писта
Когато даден елемент се извежда от употреба, записът му се маркира DEPRECATED с посочване на целевата версия и датата за премахване — предварително уведомление, в контекста.
Попитайте за промяна
Планирате ли промяна или миграция към нова основна версия? Инженер по решения може да Ви разясни времевата рамка и въздействието на Вашата интеграция.
Кога могат да бъдат пуснати промени, водещи до несъвместимост.
Пускането на нови основни версии се планира в конкретни периоди, така че да не съвпада с датите за прекратяване на абонаментите на клиентите или с пиковите сезони в търговията на дребно. През повечето години не се пускат нови основни версии.
Февруари и септември са типичните периоди за въвеждане на промени — и двата са след края на основния сезон за търговия на дребно и преди пиковия сезон, което дава време на интеграторите да извършат миграцията преди следващия голям спад.
Ноември–декември (празничен сезон), март–май (Fespa и пролетните колекции), както и двете седмици преди известни събития в бранша са периоди, през които не се въвеждат промени. Продължават да се пускат актуализации, но не се въвеждат нито малки, нито големи промени в поведението.
Отделът за инженерни решения помага на интеграторите да преодолеят основните трудности.
При преминаване към нова основна версия публикуваме ръководство за миграция заедно с бележките към версията. Отделът за инженерни решения организира и безплатни 30-минутни консултации по миграция за всеки активен интеграционен партньор по време на периода на извеждане от употреба — запишете се чрез страницата за връзка с инженерите. Корпоративните клиенти получават специализирана поддръжка за миграция в рамките на своето MSA, както и ранен достъп до новата основна версия в тестовия канал за продажби 90 дни преди публичното ѝ пускане.
Проверете тук, преди да извършите ъпгрейд.
Всяка нова версия се публикува първо тук — какво се е променило и кога възникват проблеми. Премахваните функции се съобщават с достатъчно предварително предупреждение, а при преминаване към нова основна версия се осигурява поддръжка за миграция.