Svako izdanje API. Svaka razbijajuća promjena. Zabilježeno.
Fabrixa isporučuje API i ažuriranja platforme u predvidljivom ritmu. Svaka verzija prvo stiže ovdje — što se promijenilo, što je novo, što se ukida i kada zapravo dođe do prekida. Provjerite ovdje prije nadogradnje.
Što se promijenilo u posljednjih nekoliko tjedana.
Najnovije prvo. Svaki je unos datiran, označen semverom i podijeljen u standardne kategorije: Dodano / Promijenjeno / Zastarjelo / Uklonjeno / Ispravljeno / Sigurnost.
- CHANGEDHitno: Osnovna staza premještena na
/v2/integration. Krajnje točke v1 su zamijenjene — postojeće v1 integracije nastavljaju raditi tijekom razdoblja deprecijacije; vidi Vodič za integraciju. - CHANGEDHitno: autentifikacija je sada dva zaglavlja —
Authorization: Bearer(Pristupni token za aplikaciju) plusX-Application-Key. Jednokrutni v1 autentifikacijski token više nije prihvaćen. - ADDEDFabrixa Studio — ugrađivi prilagođivač proizvoda s bijelim etiketom: ugradite putem iframea, priložite spremljeni dizajn retku narudžbe s
cart_item_key, i dohvatiti pregled iz/v2/studio/customizations/{key}/preview. - CHANGEDStandardna odgovorna omotnica na krajevima popisa:
links/meta/datas poveznicama na stranice. - CHANGEDWebhooks konsolidirani na
order.creatediorder.updated, potpisao ugovor sx-webhook-signature(HMAC-SHA256) i označeno sx-webhook-topic. - CHANGEDOgraničenje stope postavljeno na 30 zahtjeva po aplikaciji u minuti, prikazano putem
X-RateLimit-LimitiX-RateLimit-Remainingnaslovi.
- ADDED
GET /v1/products/:id/pricing— pregled cijena po jedinici u različitim razinama obujma po SKU. - CHANGEDPayload webhooka za narudžbe sada uključuje a
production_hubpolje (PT, ES ili NL). Unazad kompatibilno.
- ADDEDPostupak personalizacije u pet načina za posteljinu, stolni rublje i dodatke: tekst, ime, brojevi, slike i dinamička polja podataka.
- ADDED
order.failedwebhook događaj sa strukturiranim razlozima pogreške (odbijanje dizajna, nedostatak tkanine i slično). - FIXEDRubni slučaj paginacije na
GET /v1/ordersprilikom filtriranja po statusu preko granica stranica.
- ADDEDJastuk za vanjsku upotrebu, stolnjak i vreća za sjedenje SKUs za sintetičku vanjsku upotrebu. Dostupno putem
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64polje na tijelu narudžbe — umjesto toga navedite URL izvornog datoteka. Cilj uklanjanja: v1.20.0 (2027-03-28). - SECURITYPojačana je shema potpisivanja webhooka. Prethodna HMAC varijanta ostaje važeća do verzije v1.18.0; novo potpisivanje primjenjuje se automatski ubuduće.
- ADDEDKategorija posteljine (navlake za jorgane 1P / 2P / Lits Jumeaux, prekrivači za krevete, rastezljive plahte) na španjolskom čvorištu.
- ADDEDSublimacijski salveti SKUs na nizozemskom čvorištu s SLA-om od 2–3 radna dana.
- CHANGEDEndpoint narudžbe sada prihvaća
recipient.countrykao ISO 3166-1 alfa-2; rezervna alfa-3 je uklonjena.
Starije izdanja dostupna na zahtjev — e-pošta developers@fabrixa.com.
SemVer, s konzervativnim prekidnim promjenama.
Kardinalne promjene postojećih krajnjih točaka
Rijetko. Objavljeno 12 mjeseci prije izlaska. Stara glavna verzija ostaje podržana 12 mjeseci nakon izlaska nove glavne verzije. Glavne verzije ne ukidamo olako.
Nove završne točke, polja, ponašanje
Dodaci kompatibilni unatrag. Postojeći kod i dalje radi bez promjena. Većina izdanja su manja, u otprilike dvotjednom do četverotjednom ritmu.
Ispravci grešaka, performanse, sigurnost
Strogo bez prekida. Kontinuirano implementirano bez prethodne najave i zabilježeno u zapisniku promjena nakon implementacije.
12 mjeseci od obavijesti o ukidanju do uklanjanja.
Kada depreciramo polje, krajnju točku ili ponašanje, unos u dnevniku promjena ga označava. DEPRECATED i navodi verziju i datum cilja uklanjanja. Funkcionalnost koja je zastarjela nastavlja raditi najmanje 12 mjeseci nakon obavijesti.
Slanjem tri obavijesti o podsjetniku — šest mjeseci, tri mjeseca i jedan mjesec prije uklanjanja — na zabilježenu adresu e-pošte za API ključ.
Ukinute krajnje točke također vraćaju X-Fabrixa-Deprecation zaglavlje odgovora koje upućuje na putanju migracije, tako da je vidljivo u vašim zapisima.
Kako pratiti promjene.
Nema feedova za povezivanje — ova stranica je izvor istine. Evo kako ostati ispred svega što utječe na vašu integraciju.
Prvo provjerite ovdje
Svaka objava se pojavljuje na ovoj stranici, a najnovija je na vrhu. Označite je i pregledajte prije nego što nadogradite ovisnost ili objavite novu integraciju.
Slobodna pista
Kada se nešto ukida, njegova je stavka označena. DEPRECATED uklanjanjem ciljane verzije i datuma — prethodna obavijest, u kontekstu.
Upitajte o promjeni
Planirate li promjenu ili migraciju na novu glavnu verziju? Inženjer rješenja Možemo vas provesti kroz vremenski okvir i utjecaj vaše integracije.
Kada se mogu isporučiti prekidne promjene.
Izdavanja novih glavnih verzija zakazana su u određenim vremenskim prozorima kako ne bi poklapala s datumima isporuke kod kupaca ili s vrhunskim maloprodajnim sezonama. Većina godina nema nijednog izdanja glavne verzije.
Veljača i rujan su tipični prozori za prekid promjena — oboje nakon velike maloprodajne sezone i prije vrhunca, što integratorima daje vremena za migraciju prije njihovog sljedećeg velikog pada.
Studeni–prosinac (blagdanska maloprodaja), ožujak–svibanj (Fespa i proljetne isporuke) i dva tjedna prije poznatih industrijskih događaja su razdoblja bez prekidnih promjena. Izdavanja zakrpa se nastavljaju, ali nema manjih ni većih promjena u ponašanju.
Inženjering rješenja vodi integratore kroz glavne prepreke.
Za velike verzijske promjene objavljujemo vodič za migraciju uz bilješke o izdanju. Solutions Engineering također nudi besplatne 30-minutne konzultacije za migraciju svakom aktivnom integracijskom partneru tijekom razdoblja ukidanja podrške — rezervirajte putem stranice za kontakt-inženjera. Kupci u poduzećima dobivaju namjensku podršku za migraciju u svojem MSA-u, kao i rani pristup novoj glavnoj verziji na pripremnom prodajnom kanalu 90 dana prije javne dostupnosti.
Provjerite ovdje prije nadogradnje.
Svako izdanje prvo stigne ovdje — što se promijenilo i kada će biti prekidana podrška. Ukinuća dolaze s razdobljem podrške, a izdanja glavnih verzija dolaze s podrškom za migraciju.