Katra API versija. Katra izmaiņa, kas ietekmē saderību. Reģistrēts.
Fabrixa regulāri publicē API un platformas atjauninājumus. Katrs atjauninājums vispirms parādās šeit — kas ir mainījies, kas ir jauns, kas vairs netiek atbalstīts un kad tas faktiski vairs nedarbosies. Pirms atjaunināšanas pārbaudiet šo informāciju.
Kas ir mainījies pēdējo pāris nedēļu laikā.
Jaunākie ieraksti vispirms. Katram ierakstam ir norādīts datums, pievienota SemVer atzīme, un tas ir iedalīts standarta kategorijās: Pievienots / Izmaiņas / Novecojis / Noņemts / Labots / Drošība.
- CHANGEDPēdējās ziņas: pamatceļš pārvietots uz
/v2/integration. v1 galapunkti ir aizstāti — esošās v1 integrācijas turpinās darboties līdz brīdim, kad tās tiks izņemtas no lietošanas; skatiet integrācijas rokasgrāmata. - CHANGEDPēdējās ziņas: autentifikācijai tagad ir divi galvenes —
Authorization: Bearer(lietojumprogrammas piekļuves žetons) plusX-Application-Key. Autentifikācija ar vienu žetonu (v1) vairs netiek atbalstīta. - ADDEDFabrixa Studio — ievietojams „white-label“ produktu pielāgošanas rīks: ievietojams, izmantojot iframe, saglabāto dizainu pievienojiet pasūtījuma rindai ar
cart_item_key, un atvērt priekšskatījumu no/v2/studio/customizations/{key}/preview. - CHANGEDStandarta atbildes aploksne saraksta galapunktiem:
links/meta/dataar lappušu numerācijas saitēm. - CHANGEDWebhooki apvienoti uz
order.createdunorder.updated, parakstīts arx-webhook-signature(HMAC-SHA256) un ar atslēgvārdiemx-webhook-topic. - CHANGEDPieprasījumu skaita ierobežojums ir noteikts 30 pieprasījumiem uz vienu lietojumprogrammu minūtē, kas tiek parādīts caur
X-RateLimit-LimitunX-RateLimit-Remainingvirsraksti.
- ADDED
GET /v1/products/:id/pricing— apskatīt vienības cenas atkarībā no apjoma līmeņiem par SKU. - CHANGEDWebhook datu slodze tagad ietver
production_hublauks (PT, ES vai NL). Atpakaļsaderīgs.
- ADDEDPiecu veidu personalizācijas process gultas veļai, galda veļai un aksesuāriem: teksts, vārds, skaitļi, attēli un dinamiskie datu lauki.
- ADDED
order.failedwebhook notikums ar strukturētiem kļūdas iemesliem (attēla noraidīšana, auduma nav noliktavā un tamlīdzīgi). - FIXEDLappušu numerācijas robežgadījums par
GET /v1/ordersfiltrējot pēc statusa, pārejot no vienas lappuses uz citu.
- ADDEDĀra spilvens, galdauts un sēžmaiss SKUs, paredzēti lietošanai ārā no sintētiskiem materiāliem. Pieejams caur
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64lauks pasūtījuma tekstā — tā vietā norādiet avota faila URL. Izņemšanas termiņš: v1.20.0 (2027-03-28). - SECURITYWebhook parakstīšanas shēma ir padarīta drošāka. Iepriekšējais HMAC variants paliek spēkā līdz versijai v1.18.0; turpmāk automātiski tiks piemērota jaunā parakstīšanas metode.
- ADDEDGultas veļas kategorija (pūku segas pārvalki 1P / 2P / Lits Jumeaux, gultas pārklāji, elastīgās palagas) Spānijas tirdzniecības platformā.
- ADDEDSublimācijas serviete SKUs Nīderlandes izplatīšanas centrā ar piegādes termiņu 2–3 darbdienas.
- CHANGEDPasūtījuma galapunkts tagad pieņem
recipient.countrykā ISO 3166-1 alfa-2; alfa-3 rezerves variants tika noņemts.
Vecākas versijas pieejamas pēc pieprasījuma — sūtiet e-pastu developers@fabrixa.com.
SemVer, ar piesardzīgām izmaiņām, kas var izraisīt nesaderību.
Būtiskas izmaiņas esošajos galapunktos
Reti. Tiek paziņots 12 mēnešus pirms izlaišanas. Vecā galvenā versija tiek atbalstīta vēl 12 mēnešus pēc jaunās galvenās versijas izlaišanas. Mēs neatsakāmies no galvenajām versijām vieglprātīgi.
Jauni galapunkti, lauki, darbība
Papildinājumi, kas ir atpakaļsaderīgi. Esošais kods turpina darboties bez izmaiņām. Lielākā daļa izlaidumu ir nelieli, un tie notiek aptuveni ik pēc divām līdz četrām nedēļām.
Kļūdu labojumi, veiktspēja, drošība
Stingri bez pārtraukuma. Tiek ieviests nepārtraukti bez iepriekšēja paziņojuma, un izmaiņas tiek reģistrētas izmaiņu žurnālā pēc ieviešanas.
12 mēneši no brīža, kad tiek publicēts paziņojums par funkcijas atbalsta pārtraukšanu, līdz tās izņemšanai.
Kad mēs atzīstam kādu lauku, galapunktu vai darbību par novecojušu, izmaiņu žurnāla ieraksts to atzīmē DEPRECATED un norāda versiju un datumu, kad funkcija tiks izņemta. Novecojusī funkcionalitāte turpinās darboties vismaz 12 mēnešus pēc paziņojuma publicēšanas.
Mēs nosūtām trīs atgādinājuma paziņojumus — sešus mēnešus, trīs mēnešus un vienu mēnesi pirms atcelšanas — uz e-pasta adresi, kas reģistrēta saistībā ar API atslēgu.
Arī novecojušie galapunkti atgriež X-Fabrixa-Deprecation atbildes galvenes rinda, kas norāda uz migrācijas ceļu, lai tā būtu redzama jūsu žurnālos.
Kā sekot līdzi izmaiņām.
Nav nepieciešams pieslēgt nekādus datu avotus — šī lapa ir galvenais informācijas avots. Šeit ir izklāstīts, kā būt vienu soli priekšā visam, kas ietekmē jūsu integrāciju.
Vispirms apskatiet šeit
Šajā lapā tiek publicēti visi izlaidumi, jaunākie no tiem atrodas augšā. Pievienojiet to grāmatzīmēm un pārskatiet to, pirms atjaunināt atkarību vai izlaist jaunu integrāciju.
Brīva skrejceļa
Kad kāds elements tiek izņemts no apgrozības, tā ieraksts tiek atzīmēts DEPRECATED norādot mērķa versiju un datumu — iepriekšējs paziņojums, ņemot vērā kontekstu.
Jautājiet par izmaiņām
Plānojat izmaiņas vai pāreju uz jaunu galveno versiju? Risinājumu inženieris var izskaidrot jums integrācijas laika grafiku un ietekmi.
Kad var ieviest izmaiņas, kas ietekmē saderību.
Galveno versiju izlaides tiek plānotas konkrētos laika periodos, lai tās nesakristu ar klientu piegādes termiņiem vai mazumtirdzniecības sezonas kulmināciju. Vairumā gadu galveno versiju izlaides nenotiek vispār.
Februāris un septembris ir tipiski laika posmi, kad notiek pārmaiņas — gan pēc lielā mazumtirdzniecības sezonas, gan pirms tās kulminācijas, kas integrētājiem dod laiku veikt migrāciju pirms nākamā lielā pārdošanas apjoma krituma.
Novembris–decembris (svētku sezonas tirdzniecība), marts–maijs (Fespa izstāde un pavasara jauno produktu laišana tirgū) un divas nedēļas pirms nozīmīgiem nozares pasākumiem ir periodi, kad netiek veiktas izmaiņas. Programmas labojumu izlaide turpinās, taču netiek veiktas ne nelielas, ne būtiskas darbības izmaiņas.
Risinājumu izstrādes nodaļa palīdz integrētājiem pārvarēt galvenās grūtības.
Lielu versiju atjauninājumu gadījumā kopā ar izlaides piezīmēm publicējam migrācijas rokasgrāmatu. Risinājumu inženieru komanda atbalsta periodā, kad funkcijas tiek pakāpeniski izņemtas no apgrozības, visiem aktīvajiem integrācijas partneriem piedāvā bezmaksas 30 minūšu konsultācijas par migrāciju — pieteikties var, izmantojot lapu „Sazināties ar inženieri”. Uzņēmumu klientiem tiek nodrošināts īpašs migrācijas atbalsts saskaņā ar MSA līgumu, kā arī agrīna piekļuve jaunajai galvenajai versijai izmēģinājuma pārdošanas kanālā 90 dienas pirms tās publiskas pieejamības.
Pirms atjaunināšanas pārbaudiet šeit.
Katrs jaunais izlaidums vispirms parādās šeit — kas ir mainījies un kad rodas kļūdas. Novecojušo funkciju atbalsta pārtraukšanai ir paredzēts pārejas periods, bet galveno versiju atjauninājumiem tiek nodrošināts migrācijas atbalsts.