Vsaka izdaja API. Vsaka sprememba, ki vpliva na združljivost. Zabeleženo.
Fabrixa redno objavlja posodobitve za API in platformo. Vsaka nova različica se najprej objavi tukaj – kaj se je spremenilo, kaj je novega, kaj bo prenehalo delovati in kdaj bo dejansko prenehalo delovati. Preden izvedete nadgradnjo, preverite tukaj.
Kaj se je spremenilo v zadnjih nekaj tednih.
Najnovejše na prvem mestu. Vsak vnos je opremljen z datumom, oznako po standardu SemVer ter razvrščen v standardne kategorije: Dodano / Spremenjeno / Zastarelo / Odstranjeno / Popravljeno / Varnost.
- CHANGEDNajnovejše novice: osnovna pot je bila premaknjena na
/v2/integration. Končne točke različice v1 so nadomeščene — obstoječe integracije različice v1 bodo še naprej delovale v obdobju prehoda; glej vodnik po integraciji. - CHANGEDNajnovejše novice: preverjanje pristnosti zdaj poteka prek dveh glav —
Authorization: Bearer(dostopni žeton aplikacije) terX-Application-Key. Avtentifikacija v1 z enim žetonom ni več sprejeta. - ADDEDFabrixa Studio — vgradljiv orodje za prilagajanje izdelkov z možnostjo »white-label«: vgradite ga prek iframe-a, shranjeni dizajn pa dodajte v vrstico naročila s
cart_item_key, ter si oglejte predogled iz/v2/studio/customizations/{key}/preview. - CHANGEDStandardni odgovorni okvir za končne točke seznama:
links/meta/datas povezavami za stranice. - CHANGEDWebhooki so združeni v
order.createdinorder.updated, podpisano zx-webhook-signature(HMAC-SHA256) in označeno zx-webhook-topic. - CHANGEDOmejitev števila zahtevkov je nastavljena na 30 zahtevkov na aplikacijo na minuto, prikazana prek
X-RateLimit-LimitinX-RateLimit-Remainingglave.
- ADDED
GET /v1/products/:id/pricing— ogled cen na enoto po posameznih količinskih razredih na SKU. - CHANGEDVsebina spletnega obvestila »webhook« zdaj vključuje
production_hubpolje (PT, ES ali NL). Združljivo z prejšnjimi različicami.
- ADDEDPetstopenjski postopek prilagajanja po meri za posteljnino, namizno perilo in dodatke: besedilo, ime, številke, slike in dinamična polja za podatke.
- ADDED
order.faileddogodek webhook s strukturiranimi razlogi za napako (zavrnitev grafičnega predloga, izčrpane zaloge tkanine in podobno). - FIXEDIzjemni primer razvrščanja po straneh pri
GET /v1/orderspri filtriranju po statusu preko mej med stranmi.
- ADDEDZunanja blazina, prt in sedežna vreča SKUs za uporabo na prostem, iz sintetičnega materiala. Na voljo prek
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64polje v telesu naročila — namesto tega vnesite URL izvorne datoteke. Cilj odstranitve: v1.20.0 (28. 3. 2027). - SECURITYSistem podpisovanja webhookov je bil okrepljen. Prejšnja različica HMAC ostaja veljavna do različice v1.18.0; od zdaj naprej se bo samodejno uporabljal nov način podpisovanja.
- ADDEDKategorija posteljnine (prevleke za odeje za 1 osebo / 2 osebi / ločeni postelji, pregrinjala, napenjalne rjuhe) na španskem spletnem mestu.
- ADDEDServieta za sublimacijski tisk SKUs v nizozemskem distribucijskem centru z obljubljenim rokom dostave 2–3 delovnih dni.
- CHANGEDKončna točka naročila zdaj sprejema
recipient.countrykot ISO 3166-1 alfa-2; nadomestna oznaka alfa-3 je bila odstranjena.
Starejše izdaje so na voljo na zahtevo — po e-pošti developers@fabrixa.com.
SemVer z zmernimi spremembami, ki povzročajo nezdružljivost.
Pomembne spremembe obstoječih končnih točk
Redko. Napovedano 12 mesecev pred izdajo. Stara glavna različica ostane podprta še 12 mesecev po izdaji nove glavne različice. Glavnih različic ne ukinjamo kar tako.
Nove končne točke, polja, obnašanje
Dodatki, združljivi z prejšnjimi različicami. Obstoječa koda še naprej deluje brez sprememb. Večina izdaj je manjših, izhajajo pa približno vsakih dva do štiri tedne.
Popravki napak, zmogljivost, varnost
Izključno neprekinjajoče spremembe. Uvedene so se sproti brez predhodnega obvestila, v dnevnik sprememb pa so bile vnesene šele po uvedbi.
12 mesecev od obvestila o opustitvi do odstranitve.
Ko neko polje, končno točko ali obnašanje označimo kot zastarelo, se to v zapisu o spremembah ustrezno označi DEPRECATED ter navaja ciljno različico in datum umika. Zastarela funkcionalnost bo še naprej delovala vsaj 12 mesecev po objavi obvestila.
Na e-poštni naslov, ki je naveden v evidenci za ključ API, pošljemo tri opominske obvestila – šest mesecev, tri mesece in en mesec pred odstranitvijo.
Zastarele končne točke prav tako vrnejo X-Fabrixa-Deprecation glava odgovora, ki kaže na pot migracije, tako da je vidna v vaših dnevnikih.
Kako spremljati spremembe.
Ni treba priključevati nobenih virov podatkov — ta stran je edini zanesljiv vir informacij. Tukaj je navodilo, kako ostati na tekočem z vsem, kar vpliva na vašo integracijo.
Najprej preverite tukaj
Na tej strani so objavljene vse izdaje, najnovejše pa so na vrhu. Dodajte jo med zaznamke in jo preglejte, preden posodobite odvisnost ali izvedete novo integracijo.
Prosta vzletno-pristajalna steza
Ko se nekaj izteka, se ta vnos označi DEPRECATED z navedbo ciljne različice in datuma odstranitve — predhodno obvestilo v kontekstu.
Povprašajte o spremembi
Načrtujete spremembo ali prehod na novo glavno različico? Inženir za rešitve vam lahko podrobno razloži časovni okvir in posledice vaše integracije.
Kdaj se lahko izdajo spremembe, ki vplivajo na združljivost.
Izidi glavnih različic so načrtovani v določena časovna obdobja, da se ne prekrivajo z datumi prehoda strank na nove različice ali s konicami prodajne sezone. Večina let ne prinaša nobenega izida glavne različice.
Februar in september sta tipična obdobja za uvedbo sprememb – oba sta po koncu glavne prodajne sezone in pred vrhuncem sezone, kar integratorjem omogoča, da opravijo migracijo še pred naslednjim velikim padcem prodaje.
November–december (praznična prodaja), marec–maj (Fespa in spomladanske novosti) ter dva tedna pred znanimi dogodki v panogi so obdobja, v katerih se ne uvajajo spremembe. Izhajajo še vedno popravki, vendar ne pride do manjših ali večjih sprememb v delovanju.
Oddelek za razvoj rešitev pomaga integratorjem pri premagovanju večjih težav.
Ob izidu novih glavnih različic poleg opomb k izdaji objavljamo tudi vodnik za migracijo. Oddelek za inženiring rešitev v obdobju umika stare različice organizira tudi brezplačne 30-minutne posvetovalne ure o migraciji za vse aktivne integracijske partnerje – rezervirajte termin prek strani »contact-engineer«. Podjetniški uporabniki prejmejo namensko podporo pri migraciji v okviru svoje pogodbe MSA, poleg tega pa imajo 90 dni pred javno razpoložljivostjo zgodnji dostop do nove glavne različice prek testnega prodajnega kanala.
Preden izvedete nadgradnjo, preverite tukaj.
Vsaka nova različica se najprej objavi tukaj – kaj se je spremenilo in kdaj pride do napak. Odpravljene funkcije imajo prehodno obdobje, za prehod na novo glavno različico pa je na voljo podpora za migracijo.