Každá verze API. Každá změna s dopadem na kompatibilitu. Zaznamenáno.
Fabrixa vydává aktualizace API a platformy v předvídatelných intervalech. Každá nová verze se nejprve objeví zde – co se změnilo, co je nového, co se přestává podporovat a kdy dojde k nefunkčnosti. Před aktualizací se zde podívejte.
Co se změnilo v posledních několika týdnech.
Nejnovější záznamy nahoře. Každý záznam je opatřen datem, označen podle semveru a rozdělen do standardních kategorií: Přidáno / Změněno / Zastaralé / Odstraněno / Opraveno / Zabezpečení.
- CHANGEDAktuální zpráva: základní cesta byla přesunuta do
/v2/integration. Koncové body verze v1 jsou nahrazeny — stávající integrace verze v1 budou fungovat i během přechodného období; viz průvodce integrací. - CHANGEDAktuální zpráva: ověřování nyní tvoří dvě hlavičky —
Authorization: Bearer(přístupový token aplikace) plusX-Application-Key. Ověřování v1 s jedním tokenem již není akceptováno. - ADDEDFabrixa Studio — nástroj pro přizpůsobení produktu, který lze vložit jako white-label: vložte jej pomocí iframe, uložte návrh a připojte jej k řádku objednávky pomocí
cart_item_key, a načíst náhled z/v2/studio/customizations/{key}/preview. - CHANGEDStandardní odpověď na koncové body seznamu:
links/meta/datas odkazy na stránkování. - CHANGEDWebhooky sloučeny do
order.createdaorder.updated, podepsáno sx-webhook-signature(HMAC-SHA256) a označeno štítkemx-webhook-topic. - CHANGEDLimit počtu požadavků je nastaven na 30 požadavků na aplikaci za minutu, zobrazeno prostřednictvím
X-RateLimit-LimitaX-RateLimit-Remainingzáhlaví.
- ADDED
GET /v1/products/:id/pricing— zobrazit orientační jednotkové ceny v jednotlivých objemových pásmech pro SKU. - CHANGEDObsah webhooku pro objednávky nyní obsahuje
production_hubpole (PT, ES nebo NL). Zpětně kompatibilní.
- ADDEDPětistupňový proces personalizace ložního prádla, stolního prádla a doplňků: text, jméno, čísla, obrázky a dynamická datová pole.
- ADDED
order.failedudálost webhooku se strukturovanými důvody chyby (zamítnutí grafického návrhu, nedostatek látky na skladě a podobně). - FIXEDOkrajový případ stránkování v režimu
GET /v1/orderspři filtrování podle stavu přes hranice stránek.
- ADDEDVenkovní polštář, ubrus a sedací vak SKUs pro venkovní použití ze syntetického materiálu. K dostání prostřednictvím
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64pole v těle příkazu — místo toho zadejte URL zdrojového souboru. Cíl odstranění: v1.20.0 (28. 3. 2027). - SECURITYBylo posíleno schéma podepisování webhooků. Předchozí varianta HMAC zůstává platná až do verze v1.18.0; od této verze se automaticky používá nový způsob podepisování.
- ADDEDKategorie ložního prádla (povlečení na jednolůžko / dvojlůžko / oddělená lůžka, přehozy, napínací prostěradla) na španělském portálu.
- ADDEDSublimační ubrousek SKUs v nizozemském distribučním centru s garantovanou dodací lhůtou 2–3 pracovní dny.
- CHANGEDKoncový bod objednávky nyní přijímá
recipient.countryjako ISO 3166-1 alfa-2; záložní kód alfa-3 byl odstraněn.
Starší verze jsou k dispozici na vyžádání – e-mailem developers@fabrixa.com.
SemVer s konzervativními změnami, které narušují kompatibilitu.
Zásadní změny ve stávajících koncových bodech
Vzácné. Oznámeno 12 měsíců před vydáním. Podpora staré hlavní verze pokračuje ještě 12 měsíců po uvedení nové hlavní verze. Hlavní verze nezrušíme bez důkladného zvážení.
Nové koncové body, pole, chování
Novinky se zpětnou kompatibilitou. Stávající kód funguje i nadále bez nutnosti úprav. Většina vydání je drobná a vychází zhruba každé dva až čtyři týdny.
Opravy chyb, výkon, bezpečnost
Jedná se výhradně o změny, které nezpůsobí poruchy. Jsou nasazovány průběžně bez předchozího oznámení a do seznamu změn jsou zaznamenány až po nasazení.
12 měsíců od oznámení o ukončení podpory až po odstranění.
Když označíme pole, koncový bod nebo chování za zastaralé, příslušný záznam v seznamu změn jej takto označí DEPRECATED a uvádí verzi a datum, kdy má být daná funkce odstraněna. Zastaralá funkce bude fungovat ještě nejméně 12 měsíců po zveřejnění oznámení.
Na e-mailovou adresu uvedenou v záznamech pro klíč API zasíláme tři upomínky – šest měsíců, tři měsíce a jeden měsíc před odstraněním.
Zastaralé koncové body rovněž vracejí X-Fabrixa-Deprecation hlavička odpovědi odkazující na migrační cestu, aby byla viditelná ve vašich protokolech.
Jak sledovat změny.
Není třeba připojovat žádné kanály – tato stránka je jediným spolehlivým zdrojem informací. Zde se dozvíte, jak mít vždy přehled o všem, co ovlivňuje vaši integraci.
Nejprve se podívejte sem
Na této stránce se objevují všechny nové verze, přičemž nejnovější jsou uvedeny nahoře. Přidejte si ji do záložek a projděte si ji, než provedete aktualizaci závislosti nebo nasadíte novou integraci.
Průjezdná dráha
Když se něco chýlí ke konci, je příslušný záznam označen DEPRECATED s uvedením cílové verze a data odstranění — předběžné oznámení v kontextu.
Zeptejte se na změnu
Plánujete změnu nebo přechod na novou hlavní verzi? Inženýr pro řešení vám může vysvětlit časový harmonogram a dopad vaší integrace.
Kdy lze vydat změny s nekompatibilními dopady.
Vydání nových hlavních verzí jsou naplánována do konkrétních časových oken, aby se nekryla s termíny ukončení podpory pro zákazníky ani se špičkami v maloobchodní sezóně. Většinou se v daném roce nevydává žádná nová hlavní verze.
Únor a září jsou typická období pro zavádění zásadních změn – v obou případech se jedná o období po hlavní maloobchodní sezóně a před vrcholem sezóny, což dává integrátorům čas na migraci ještě před dalším velkým poklesem.
Listopad–prosinec (vánoční prodejní sezóna), březen–květen (veletrh Fespa a jarní novinky) a dva týdny před známými oborovými akcemi jsou období, kdy se neprovádějí zásadní změny. Vydávání opravných verzí pokračuje, nedochází však k žádným menším ani zásadním změnám v chování.
Oddělení Solutions Engineering provází integrátory přes hlavní překážky.
Při přechodu na novou hlavní verzi zveřejňujeme spolu s poznámkami k vydání také průvodce migrací. Tým Solutions Engineering navíc během období ukončení podpory pořádá bezplatné 30minutové konzultace k migraci pro všechny aktivní integrační partnery – rezervovat si je můžete na stránce „contact-engineer“. Firemní zákazníci získávají v rámci své smlouvy MSA specializovanou podporu při migraci a navíc přednostní přístup k nové hlavní verzi prostřednictvím testovacího prodejního kanálu již 90 dní před jejím veřejným uvedením.
Než provedete aktualizaci, podívejte se sem.
Každá nová verze se objeví nejprve zde – co se změnilo a kdy dochází k nefunkčnosti. Zastaralé funkce mají přechodné období a při přechodu na novou hlavní verzi je k dispozici podpora migrace.