Jokainen API-release. Jokainen breaking change. Kirjattu.
Fabrixa julkaisee API- ja alustapäivitykset säännöllisin väliajoin. Jokainen julkaisu ilmestyy ensin täällä — mitä on muuttunut, mitä uutta on tullut, mitkä ominaisuudet poistuvat käytöstä ja milloin ne lakkaavat toimimasta. Tarkista tämä sivu ennen päivitystä.
Mitä on muuttunut viime viikkoina.
Uusimmat ensin. Jokainen merkintä on päivätty, merkitty semver-tunnisteella ja jaoteltu vakiokategorioihin: Lisätty / Muutettu / Vanhentunut / Poistettu / Korjattu / Turvallisuus.
- CHANGEDUutisvälähdys: peruspolku siirretty osoitteeseen
/v2/integration. V1-rajapinnat on korvattu — olemassa olevat V1-integraatiot toimivat edelleen käytöstäpoistoaikana; katso integraatio-opas. - CHANGEDUutisvälähdys: todennus tapahtuu nyt kahden otsikon avulla —
Authorization: Bearer(Sovelluksen pääsytunnus) sekäX-Application-Key. Yhden tunnuksen v1-todennusta ei enää hyväksytä. - ADDEDFabrixa Studio — upotettava white-label-tuotteen muokkaustyökalu: upota iframe-kehyksen avulla, liitä tallennettu malli tilausriviin käyttämällä
cart_item_key, ja hae esikatselu osoitteesta/v2/studio/customizations/{key}/preview. - CHANGEDVakiovastauskuori listan päätepisteissä:
links/meta/datasivunumerointilinkkien kera. - CHANGEDWebhookit on yhdistetty
order.createdjaorder.updated, allekirjoitettux-webhook-signature(HMAC-SHA256) ja merkitty tunnisteellax-webhook-topic. - CHANGEDPyynnön rajoitus on asetettu 30 pyyntöön sovellusta kohti minuutissa, ja se näkyy
X-RateLimit-LimitjaX-RateLimit-Remainingotsikot.
- ADDED
GET /v1/products/:id/pricing— tarkastele yksikköhintoja eri volyymitasoilla SKU:n mukaan. - CHANGEDWebhook-viestin sisältö sisältää nyt
production_hubkenttä (PT, ES tai NL). Taaksepäin yhteensopiva.
- ADDEDViisivaiheinen räätälöintiprosessi vuodevaatteille, pöytäliinoille ja asusteille: teksti, nimi, numerot, kuvat ja dynaamiset tietokentät.
- ADDED
order.failedwebhook-tapahtuma, jossa on jäsenneltyjä virheiden syitä (kuvamateriaalin hylkääminen, kankaan loppuminen varastosta ja vastaavat). - FIXEDSivunumeroinnin poikkeustapaus päällä
GET /v1/orderskun suodatetaan tilan perusteella sivurajojen yli.
- ADDEDUlkokäyttöön tarkoitettu tyyny, pöytäliina ja istumapussi SKUs, valmistettu synteettisestä materiaalista. Saatavana osoitteesta
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64tilauksen runko-osan kenttä — anna sen sijaan lähdetiedoston URL-osoite. Poistokohde: v1.20.0 (28.3.2027). - SECURITYWebhook-allekirjoitusmenetelmää on vahvistettu. Aikaisempi HMAC-variantti pysyy voimassa versioon v1.18.0 asti; tästä eteenpäin otetaan automaattisesti käyttöön uusi allekirjoitusmenetelmä.
- ADDEDVuodevaatteet-tuoteryhmä (pussilakanat 1P / 2P / Lits Jumeaux, päiväpeitteet, joustavat lakanat) espanjalaisella verkkokaupalla.
- ADDEDSublimaatiopainettu lautasliina SKUs Alankomaiden jakelukeskuksessa, toimitusaika 2–3 työpäivää.
- CHANGEDTilauspäätepiste hyväksyy nyt
recipient.countryISO 3166-1 -standardin mukaisena alpha-2-tunnuksena; alpha-3-varatunnus on poistettu.
Vanhemmat julkaisut saatavilla pyynnöstä — lähetä sähköpostia developers@fabrixa.com.
SemVer, jossa noudatetaan varovaista lähestymistapaa yhteensopivuuden rikkomiseen.
Olemassa oleviin päätepisteisiin kohdistuvat yhteensopivuutta rikkovat muutokset
Harvinaista. Ilmoitetaan 12 kuukautta ennen julkaisua. Vanhaa pääversiota tuetaan vielä 12 kuukautta uuden pääversion julkaisun jälkeen. Emme lopeta pääversioiden tukea kevyesti.
Uudet päätepisteet, kentät, toiminta
Taaksepäin yhteensopivat lisäykset. Olemassa oleva koodi toimii edelleen ilman muutoksia. Suurin osa julkaisuista on pienimuotoisia, ja ne ilmestyvät noin kahden–neljän viikon välein.
Virhekorjaukset, suorituskyky, tietoturva
Ei aiheuta lainkaan katkoja. Otetaan käyttöön jatkuvasti ilman ennakkoilmoitusta, ja muutokset kirjataan muutoslokiin käyttöönoton jälkeen.
12 kuukautta käytöstäpoistoilmoituksesta poistamiseen.
Kun poistamme käytöstä kentän, päätepisteen tai toiminnon, se merkitään muutospäiväkirjamerkinnässä DEPRECATED ja siinä ilmoitetaan poistettavan version numero ja päivämäärä. Vanhentunut toiminto pysyy käytössä vähintään 12 kuukautta ilmoituksen jälkeen.
Lähetämme kolme muistutusilmoitusta – kuusi kuukautta, kolme kuukautta ja yksi kuukausi ennen poistamista – API-avaimen rekisteröityyn sähköpostiosoitteeseen.
Vanhentuneet päätepisteet palauttavat myös X-Fabrixa-Deprecation vastauksen otsikkokenttä, joka osoittaa siirtymäreitin, jotta se näkyy lokitiedoissasi.
Kuinka seurata muutoksia.
Ei syötteitä, joita pitäisi kytkeä — tämä sivu on luotettava tietolähde. Näin pysyt ajan tasalla kaikesta, mikä vaikuttaa integraatioosi.
Tarkista ensin täältä
Kaikki julkaisut näkyvät tällä sivulla, uusimmat ylhäällä. Lisää sivu kirjanmerkkeihin ja tarkista se ennen kuin päivität riippuvuuden tai julkaiset uuden integraation.
Vapaa kiitotie
Kun jonkin kohteen käyttöaika päättyy, sen tietueeseen lisätään merkintä DEPRECATED poistettavan version ja päivämäärän kanssa — ennakkoilmoitus asiayhteydessä.
Kysy muutoksesta
Suunnitteletko muutosta tai siirtymistä uuteen pääversioon? Solutions Engineer voi opastaa sinua integraation aikataulun ja vaikutusten suhteen.
Milloin yhteensopivuutta rikkovia muutoksia voidaan julkaista.
Pääversioiden julkaisut ajoitetaan tiettyihin ajanjaksoihin, jotta ne eivät osu asiakkaiden toimituspäivien tai vähittäiskaupan sesonkihuippujen päälle. Useimpina vuosina pääversioita ei julkaista lainkaan.
Helmikuu ja syyskuu ovat tyypillisiä ajankohtia merkittäville muutoksille — molemmat sijoittuvat suurten vähittäiskaupan sesonkien jälkeen ja ennen sesonkihuippua, mikä antaa integraattoreille aikaa siirtää järjestelmät uuteen järjestelmään ennen seuraavaa suurta tuotevalikoiman supistumista.
Marraskuu–joulukuu (joulumyyntikausi), maaliskuu–toukokuu (Fespa-messut ja kevään uutuustuotteet) sekä kaksi viikkoa ennen tunnettuja alan tapahtumia ovat ajanjaksoja, joiden aikana ei tehdä mullistavia muutoksia. Päivityksiä julkaistaan edelleen, mutta toimintaan ei tule pieniä eikä suuria muutoksia.
Ratkaisusuunnittelu auttaa integraattoreita selviytymään suurimmista esteistä.
Suurten versioiden vaihdosten yhteydessä julkaisemme siirtymisoppaan julkaisutiedotteiden ohella. Ratkaisusuunnitteluosasto järjestää myös ilmaisia 30 minuutin siirtymiskonsultointiaikoja kaikille aktiivisille integraatiokumppaneille vanhan version käytöstäpoistoaikana — varaa aika Contact Engineer -sivun kautta. Yritysasiakkaat saavat MSA-sopimuksensa puitteissa omaa siirtymistukea sekä varhaisen pääsyn uuteen pääversioon testauskanavalla 90 päivää ennen sen julkista saatavuutta.
Tarkista tämä ennen päivitystä.
Kaikki julkaisut ilmestyvät ensin tänne — mitä on muuttunut ja milloin järjestelmä lakkaa toimimasta. Vanhojen ominaisuuksien käytöstä poistamiseen annetaan siirtymäaika, ja pääversiopäivityksiin sisältyy siirtymistuki.