Každá verzia API. Každá zásadná zmena. Zaznamenané.
Fabrixa vydáva aktualizácie verzií API a platformy v pravidelných intervaloch. Každá nová verzia sa najskôr objaví práve tu – čo sa zmenilo, čo je nové, čo sa prestáva podporovať a kedy to skutočne prestane fungovať. Pred aktualizáciou si to tu skontrolujte.
Čo sa zmenilo za posledných pár týždňov.
Najnovšie záznamy sú uvedené ako prvé. Každý záznam je datovaný, označený podľa verzie (semver) a rozdelený do štandardných kategórií: Pridané / Zmenené / Zastarané / Odstránené / Opravené / Bezpečnosť.
- CHANGEDNajnovšie správy: základná cesta bola presunutá do
/v2/integration. Koncové body verzie v1 sú nahradené — existujúce integrácie verzie v1 budú naďalej fungovať počas prechodného obdobia; pozri príručka na integráciu. - CHANGEDNajnovšie správy: Overovanie sa teraz skladá z dvoch hlavičiek —
Authorization: Bearer(prístupový token aplikácie) plusX-Application-Key. Overovanie v1 s jedným tokenom sa už neprijíma. - ADDEDFabrixa Studio — nástroj na prispôsobenie produktu, ktorý je možné vložiť ako „white-label“ riešenie: vložte ho prostredníctvom iframe, uložte dizajn a pripojte ho k riadku objednávky pomocou
cart_item_key, a načítať náhľad z/v2/studio/customizations/{key}/preview. - CHANGEDŠtandardná odpoveďová obálka pre koncové body zoznamu:
links/meta/datas odkazmi na ďalšie stránky. - CHANGEDWebhooky zjednotené do
order.createdaorder.updated, podpísané sx-webhook-signature(HMAC-SHA256) a označené tagomx-webhook-topic. - CHANGEDLimit počtu požiadaviek je nastavený na 30 požiadaviek na aplikáciu za minútu, čo sa prejavuje prostredníctvom
X-RateLimit-LimitaX-RateLimit-Remaininghlavičky.
- ADDED
GET /v1/products/:id/pricing— zobraziť orientačné ceny za jednotku v jednotlivých objemových pásmach podľa SKU. - CHANGEDObsah webhooku „Order“ teraz obsahuje
production_hubpole (PT, ES alebo NL). Spätná kompatibilita.
- ADDEDPäťrežimový personalizačný proces pre posteľnú bielizeň, stolové prádlo a doplnky: text, meno, čísla, obrázky a dynamické dátové polia.
- ADDED
order.failedudalosť webhooku so štruktúrovanými dôvodmi chyby (zamietnutie grafického návrhu, nedostupnosť látky a podobne). - FIXEDHranica stránkovania zapnutá
GET /v1/orderspri filtrovaní podľa stavu cez hranice stránok.
- ADDEDVonkajší vankúš, obrus a vak na sedenie SKUs určené na použitie v exteriéri. K dispozícii prostredníctvom
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64pole v tele požiadavky — namiesto toho zadajte URL zdrojového súboru. Termín odstránenia: v1.20.0 (28. 3. 2027). - SECURITYBolo posilnené schéma podpisovania webhookov. Predchádzajúca varianta HMAC zostáva platná až do verzie v1.18.0; odteraz sa automaticky používa nový spôsob podpisovania.
- ADDEDKategória posteľnej bielizne (obliečky na periny pre 1 osobu / 2 osoby / dvojlôžka, prehozy, napínacie plachty) na španielskom portáli.
- ADDEDSublimačná servítka SKUs v holandskom distribučnom centre s garantovanou dodacou lehotou 2–3 pracovné dni.
- CHANGEDKoncový bod objednávky teraz prijíma
recipient.countryako ISO 3166-1 alfa-2; náhradný kód alfa-3 bol odstránený.
Staršie verzie sú k dispozícii na požiadanie — e-mailom developers@fabrixa.com.
SemVer s konzervatívnymi zmenami, ktoré narúšajú kompatibilitu.
Zásadné zmeny v existujúcich koncových bodoch
Zriedkavé. Oznámené 12 mesiacov pred vydaním. Podpora pre starú hlavnú verziu zostáva zachovaná ešte 12 mesiacov po uvedení novej hlavnej verzie. Hlavné verzie nezrušujeme ľahkovážne.
Nové koncové body, polia, správanie
Doplnenia so spätnou kompatibilitou. Existujúci kód naďalej funguje bez zmien. Väčšina vydaní je menších, s frekvenciou približne každé dva až štyri týždne.
Opravy chýb, výkon, bezpečnosť
Ide výlučne o zmeny, ktoré nespôsobujú poruchy. Nasadzujú sa priebežne bez predchádzajúceho oznámenia a zaznamenávajú sa do zoznamu zmien až po nasadení.
12 mesiacov od oznámenia o ukončení podpory až po vyradenie.
Keď označíme nejaké pole, koncový bod alebo správanie za zastarané, príslušný záznam v zozname zmien ho takto označí DEPRECATED a uvádza verziu a dátum, kedy má byť daná funkcia odstránená. Zastaraná funkcia bude naďalej fungovať najmenej 12 mesiacov po zverejnení oznámenia.
Na e-mailovú adresu uvedenú v záznamoch pre kľúč API zasielame tri upomienky – šesť mesiacov, tri mesiace a jeden mesiac pred odstránením.
Zastarané koncové body tiež vracajú X-Fabrixa-Deprecation hlavička odpovede, ktorá odkazuje na migračnú cestu, aby bola viditeľná vo vašich protokoloch.
Ako sledovať zmeny.
Nie je potrebné pripájať žiadne kanály – táto stránka je jediným spoľahlivým zdrojom informácií. Tu sa dozviete, ako mať prehľad o všetkom, čo ovplyvňuje vašu integráciu.
Najprv sa pozrite sem
Na tejto stránke sa zobrazujú všetky vydania, pričom najnovšie sú uvedené hore. Pridajte si ju do záložiek a skontrolujte ju, než aktualizujete nejakú závislosť alebo nasadíte novú integráciu.
Voľná vzletová dráha
Keď sa niečo prestáva používať, príslušný záznam je označený DEPRECATED s uvedením cieľovej verzie a dátumu odstránenia — vopred oznámené, v kontexte.
Opýtajte sa na zmenu
Plánujete zmenu alebo prechod na novšiu hlavnú verziu? Inžinier pre riešenia vám môžeme vysvetliť časový harmonogram a dopad vašej integrácie.
Kedy je možné zaviesť zmeny, ktoré narúšajú kompatibilitu.
Vydávanie hlavných verzií je naplánované na konkrétne obdobia, aby sa nezhodovalo s termínmi ukončenia podpory pre zákazníkov ani so špičkami v maloobchodnej sezóne. Vo väčšine rokov sa hlavné verzie nevydávajú vôbec.
Február a september sú typické obdobia na zavedenie zásadných zmien – v oboch prípadoch ide o obdobie po hlavnej maloobchodnej sezóne a pred vrcholom sezóny, čo integrátorom poskytuje čas na migráciu ešte pred ďalším veľkým poklesom.
Obdobia november – december (predvianočný predaj), marec – máj (veľtrh Fespa a jarné novinky) a dva týždne pred známymi udalosťami v odvetví sú obdobia, počas ktorých sa neuskutočňujú zásadné zmeny. Naďalej sa vydávajú opravy, nedochádza však k žiadnym menším ani zásadným zmenám v správaní.
Oddelenie inžinierskych riešení pomáha integrátorom prekonať najväčšie prekážky.
Pri prechode na novú hlavnú verziu zverejňujeme spolu s poznámkami k vydaniu aj príručku pre migráciu. Oddelenie Solutions Engineering zároveň počas obdobia ukončenia podpory ponúka bezplatné 30-minútové konzultácie o migrácii pre všetkých aktívnych integračných partnerov – rezervovať si ich môžete prostredníctvom stránky „contact-engineer“. Firemní zákazníci získajú v rámci svojej zmluvy MSA špecializovanú podporu pri migrácii a navyše prednostný prístup k novej hlavnej verzii na testovacom predajnom kanáli 90 dní pred jej verejným sprístupnením.
Pred aktualizáciou si to skontrolujte tu.
Každá nová verzia sa objaví najskôr tu – čo sa zmenilo a kedy dochádza k nefunkčnosti. Zastarané funkcie majú prechodné obdobie a pri prechode na novú hlavnú verziu je k dispozícii podpora migrácie.