Iga API versioon. Iga oluline muudatus. Registreeritud.
Fabrixa avaldab API ja platvormi uuendusi kindla sagedusega. Iga uus versioon ilmub esmalt siin – millised on muudatused, mis on uut, millised funktsioonid kaotatakse ja millal need tegelikult enam ei tööta. Vaata siit järele enne uuendamist.
Mis on viimaste nädalate jooksul muutunud.
Kõige uuemad esimesena. Igal kirjel on kuupäev, semveri märge ning see on jaotatud standardkategooriatesse: Lisatud / Muudetud / Vananenud / Eemaldatud / Parandatud / Turvalisus.
- CHANGEDViimane uudis: põhitee viidi üle
/v2/integration. V1-liidesed on asendatud — olemasolevad v1-integratsioonid toimivad edasi üleminekuperioodi jooksul; vt integreerimisjuhend. - CHANGEDViimane uudis: autentimine koosneb nüüd kahest päisest —
Authorization: Bearer(rakenduse juurdepääsutoken) plussX-Application-Key. Ühe tokeniga v1 autentimist enam ei aktsepteerita. - ADDEDFabrixa Studio — veebilehele integreeritav valge sildi tootekohandaja: integreeri iframe’i kaudu, lisa salvestatud disain tellimuse reale, kasutades
cart_item_key, ja laadige eelvaade alla aadressilt/v2/studio/customizations/{key}/preview. - CHANGEDLoendi lõpppunktide standardvastuse ümbrik:
links/meta/datakoos leheküljenumbrite linkidega. - CHANGEDWebhookid koondati
order.createdjaorder.updated, allkirjastatud koosx-webhook-signature(HMAC-SHA256) ja märksõnadegax-webhook-topic. - CHANGEDPäringute piirang on seatud 30 päringule rakenduse kohta minutis, mis kuvatakse kaudu
X-RateLimit-LimitjaX-RateLimit-Remainingpealkirjad.
- ADDED
GET /v1/products/:id/pricing— vaata ühikuhindu erinevate mahutasemete kaupa SKU kohta. - CHANGEDVeebihooki andmepakett sisaldab nüüd
production_hubväli (PT, ES või NL). Tagasiühilduv.
- ADDEDViie režiimiga isikupärastamise protsess voodipesu, laualinade ja aksessuaaride puhul: tekst, nimi, numbrid, pildid ja dünaamilised andmeväljad.
- ADDED
order.failedwebhooki sündmus koos struktureeritud veapõhjustega (kujunduse tagasilükkamine, kanga puudumine laos jms). - FIXEDLeheküljenumbrite erandjuhtum
GET /v1/orderskui filtreeritakse staatuse järgi lehekülgede vahel.
- ADDEDVälistingimustes kasutatav padja, laudlina ja istmekott SKUs, valmistatud sünteetilisest materjalist. Saadaval kaudu
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64tellimuse põhiosa väli — sisestage selle asemel allikafaili URL. Eemaldamise sihtmärk: v1.20.0 (28.03.2027). - SECURITYWebhooki allkirjastamisskeemi turvalisust on tugevdatud. Eelmine HMAC-variant jääb kehtima versioonini v1.18.0; edaspidi rakendatakse automaatselt uut allkirjastamismeetodit.
- ADDEDVooditarvete kategooria (ühe- ja kaheinimese voodipesud / Lits Jumeaux, voodikatted, pingulised voodilina) Hispaania veebikeskuses.
- ADDEDSublimatsiooniga salvrätik SKUs Hollandi jaotuskeskuses, tarneaeg 2–3 tööpäeva.
- CHANGEDTellimuse lõpppunkt võtab nüüd vastu
recipient.countryISO 3166-1 alfa-2-koodina; alfa-3-varukood eemaldati.
Vanemad versioonid on saadaval soovi korral — saatke e-kiri developers@fabrixa.com.
SemVer, milles on ette nähtud konservatiivsed ühilduvuskatkestused.
Olemasolevate lõpppunktide olulised muudatused
Haruldane. Teatatakse 12 kuud enne väljalaset. Vanemat versiooni toetatakse veel 12 kuud pärast uue versiooni väljalaskmist. Me ei lõpeta versioonide toetamist kergekäeliselt.
Uued lõpppunktid, väljad, käitumine
Tagasiühilduvad täiendused. Olemasolev kood töötab muutusteta edasi. Enamik väljalasked on väikesed ja toimuvad umbes iga kahe kuni nelja nädala tagant.
Veaparandused, jõudlus, turvalisus
Kindlasti ei põhjusta katkestusi. Rakendatakse pidevalt ilma eelneva teavitamiseta ning kantakse muudatuste loendisse pärast rakendamist.
12 kuud alates vananenud funktsiooni teadaandest kuni selle eemaldamiseni.
Kui me kuulutame välja mõne välja, lõpppunkti või käitumise vananenuks, märgistatakse see muudatuste loendi kandes DEPRECATED ning loetleb eemaldatava versiooni ja kuupäeva. Vananenud funktsionaalsus jääb töötama vähemalt 12 kuud pärast teate avaldamist.
Saadame kolm meeldetuletust – kuus kuud, kolm kuud ja üks kuu enne eemaldamist – API-võtme registreeritud e-posti aadressile.
Vananenud lõpppunktid tagastavad samuti X-Fabrixa-Deprecation vastuse päis, mis viitab migratsiooniteele, nii et see oleks teie logides nähtav.
Kuidas jälgida muudatusi.
Ühendada pole vaja ühtegi andmevoogu — see lehekülg on usaldusväärne teabeallikas. Siit leiate juhised, kuidas olla kursis kõigega, mis mõjutab teie integratsiooni.
Vaata kõigepealt siit
Kõik väljalasked ilmuvad sellele lehele, kusjuures kõige uuemad on ülaosas. Lisa see leht järjehoidjatesse ja vaata see läbi enne, kui uuendad sõltuvust või avaldad uue integratsiooni.
Vaba lennurada
Kui midagi kaotab kehtivuse, märgistatakse selle kirje DEPRECATED koos eemaldamise sihtversiooni ja kuupäevaga — eelnev teade, kontekstis.
Küsige muudatuse kohta
Kas kavandate muudatust või üleminekut uuele põhiversioonile? lahenduste insener võib teile selgitada teie integratsiooni ajakava ja mõju.
Millal võib süsteemi olulisi muudatusi kasutusele võtta.
Peamiste versioonide väljalasked on kavandatud kindlatesse ajavahemikesse, et need ei langeks kokku klientide tarnetähtaegade või jaemüügi tipphooajaga. Enamikul aastatel ei toimu ühtegi peamise versiooni väljalaset.
Veebruar ja september on tüüpilised süsteemimuutuste perioodid – need jäävad nii suurema jaemüügihooaja lõppu kui ka järgmise tipphooaja algusesse, mis annab süsteemiintegratoritele aega üleminekuks enne järgmist suurt müügilangust.
November–detsember (pühadepühi müügihooaeg), märts–mai (Fespa ja kevadised tootevalikute uuendused) ning kaks nädalat enne tuntud tööstusüritusi on perioodid, mil muudatusi ei tehta. Parandusväljaanded jätkuvad, kuid väiksemaid ega suuremaid käitumusmuudatusi ei tehta.
Lahenduste arendamine aitab integreerijatel üle saada peamistest takistustest.
Suuremate versioonimuutuste puhul avaldame koos versiooniteadete kõrval ka üleminekujuhendi. Lahenduste arendamise meeskond korraldab ka tasuta 30-minutilisi ülemineku-nõustamisajaid kõigile aktiivsetele integratsioonipartneritele vanade versioonide kasutusest kõrvaldamise perioodi jooksul – broneerige aeg lehekülje „contact-engineer“ kaudu. Ettevõtjatele pakutakse nende MSA raames spetsiaalset migratsioonitoetust ning varajast juurdepääsu uuele peaversioonile testmüügikanalis 90 päeva enne selle avalikku kättesaadavaks muutumist.
Enne uuendamist vaadake siit järele.
Iga uus versioon ilmub esmalt siin – millised muudatused on tehtud ja millal need võivad põhjustada tõrkeid. Kasutusest kõrvaldatavad funktsioonid saavad üleminekuaja ning suuremate versioonide väljalasked pakuvad migratsioonitoetust.