Varje API-release. Varje breaking change. Loggad.
Fabrixa släpper API och plattformsuppdateringar enligt ett förutsägbart schema. Varje release publiceras här först – vad som har ändrats, vad som är nytt, vad som fasas ut och när det faktiskt slutar fungera. Kolla här innan du uppgraderar.
Vad har förändrats under de senaste veckorna?.
Senaste först. Varje post är daterad, märkt med semver-taggar och indelad i standardkategorierna: Tillagt / Ändrat / Föråldrat / Borttaget / Korrigerat / Säkerhet.
- CHANGEDSenaste nytt: basvägen har flyttats till
/v2/integration. V1-ändpunkterna har ersatts — befintliga V1-integrationer fortsätter att fungera under övergångsperioden; se integrationsguide. - CHANGEDSenaste nytt: autentiseringen består nu av två rubriker —
Authorization: Bearer(Tillgångstoken för applikationen) plusX-Application-Key. Autentisering med en enda token (v1) accepteras inte längre. - ADDEDFabrixa Studio — en inbäddningsbar produktkonfigurator som kan anpassas efter kundens varumärke: bädda in via iframe, bifoga en sparad design till en orderrad med
cart_item_key, och hämta en förhandsvisning från/v2/studio/customizations/{key}/preview. - CHANGEDStandardrespons vid listans ändpunkter:
links/meta/datamed sidnumreringslänkar. - CHANGEDWebhooks samlade till
order.createdochorder.updated, undertecknat medx-webhook-signature(HMAC-SHA256) och taggad medx-webhook-topic. - CHANGEDBegränsningen är inställd på 30 förfrågningar per applikation och minut, vilket visas via
X-RateLimit-LimitochX-RateLimit-Remainingrubriker.
- ADDED
GET /v1/products/:id/pricing— visa enhetspriser för olika volymnivåer per SKU. - CHANGEDWebhook-payloaden för beställningar innehåller nu en
production_hubfält (PT, ES eller NL). Bakåtkompatibel.
- ADDEDPipeline för anpassning i fem olika lägen för sängkläder, bordsdukar och tillbehör: text, namn, siffror, bilder och dynamiska datafält.
- ADDED
order.failedwebhook-händelse med strukturerade felorsaker (avvisat bildmaterial, tyg slut i lager och liknande). - FIXEDGränsfall för sidnumrering på
GET /v1/ordersnär man filtrerar efter status över sidgränser.
- ADDEDUtomhuskudde, bordsduk och sittpåse SKUs för användning utomhus i syntetmaterial. Finns att köpa via
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64fältet i ordertexten – ange istället en URL till källfilen. Borttagningsdatum: v1.20.0 (2027-03-28). - SECURITYSäkerheten i signaturschemat för webhooks har förstärkts. Den tidigare HMAC-varianten förblir giltig fram till version 1.18.0; den nya signeringsmetoden tillämpas automatiskt från och med nu.
- ADDEDKategorin sängkläder (påslakan för 1 person / 2 personer / två enkelsängar, överkast, lakan med resår) på den spanska webbplatsen.
- ADDEDSublimeringsservett SKUs på den nederländska hubben med en leveranstid på 2–3 arbetsdagar.
- CHANGEDBeställningsändpunkten accepterar nu
recipient.countryenligt ISO 3166-1 alfa-2; reservvärdet för alfa-3 har tagits bort.
Äldre utgåvor finns tillgängliga på begäran – skicka ett e-postmeddelande developers@fabrixa.com.
SemVer, med försiktiga kompatibilitetsbrott.
Viktiga ändringar som påverkar befintliga slutpunkter
Sällsynt. Tillkännages 12 månader före lanseringen. Den gamla huvudversionen fortsätter att stödjas i 12 månader efter att den nya huvudversionen har släppts. Vi avslutar inte huvudversioner utan vidare.
Nya slutpunkter, fält, beteenden
Tillägg med bakåtkompatibilitet. Befintlig kod fortsätter att fungera utan ändringar. De flesta utgåvorna är mindre uppdateringar som släpps ungefär varannan till var fjärde vecka.
Felkorrigeringar, prestanda, säkerhet
Inga avbrott alls. Driftsätts löpande utan förvarning och loggas i ändringsloggen efter driftsättningen.
12 månader från meddelandet om att funktionen fasas ut till dess att den tas bort.
När vi avskaffar ett fält, en slutpunkt eller en funktion markeras det i ändringsloggen DEPRECATED och anger vilken version som ska tas bort samt datumet för detta. Den utfasade funktionen fortsätter att fungera i minst 12 månader efter meddelandet.
Vi skickar tre påminnelser – sex månader, tre månader och en månad före borttagningen – till den e-postadress som finns registrerad för API-nyckeln.
Föråldrade slutpunkter returnerar också en X-Fabrixa-Deprecation svarshuvudet som pekar på migreringsvägen, så att den syns i dina loggar.
Hur man håller reda på ändringar.
Inga flöden att koppla in – den här sidan är den enda tillförlitliga källan. Så här håller du dig uppdaterad om allt som påverkar din integration.
Kolla här först
Alla utgåvor publiceras på den här sidan, med den senaste överst. Lägg till sidan som bokmärke och kolla igenom den innan du uppgraderar ett beroende eller lanserar en ny integration.
En fri landningsbana
När något fasas ut märks posten med en tagg DEPRECATED med uppgifter om vilken version som ska tas bort och datum – förhandsinformation, i sitt sammanhang.
Fråga om en ändring
Planerar du en förändring eller en övergång till en ny huvudversion? En lösningsingenjör kan guida dig genom tidsplanen och konsekvenserna för din integration.
När förändringar som medför inkompatibilitet kan släppas.
Lanseringar av nya huvudversioner planeras in under specifika tidsfönster så att de inte sammanfaller med kundernas lanseringsdatum eller högsäsonger inom detaljhandeln. De flesta år lanseras inga nya huvudversioner.
Februari och september är de vanligaste tidpunkterna för genomgripande förändringar – båda infaller efter den stora detaljhandelssäsongen och före högsäsongen, vilket ger integratörerna tid att genomföra migreringen innan nästa stora lansering.
November–december (julhandeln), mars–maj (Fespa och vårens produktlanseringar) samt de två veckorna före kända branschevenemang är perioder då inga störande förändringar får ske. Uppdateringar fortsätter att släppas, men inga mindre eller större förändringar av funktionaliteten kommer att ske.
Lösningsutvecklingen hjälper integratörerna att ta sig över de största hindren.
Vid större versionsuppdateringar publicerar vi en migreringsguide tillsammans med releaseanteckningarna. Solutions Engineering erbjuder dessutom kostnadsfria 30-minuters migreringskonsultationer för alla aktiva integrationspartner under utfasningsperioden – boka via sidan ”contact-engineer”. Företagskunder får dedikerad migreringssupport inom ramen för sitt MSA-avtal, samt tidig tillgång till den nya huvudversionen via en testkanal 90 dagar innan den släpps till allmänheten.
Läs detta innan du uppgraderar.
Varje ny version publiceras här först – vad som har ändrats och när den slutar fungera. Utfasade funktioner medför en övergångsperiod, och vid övergång till en ny huvudversion erbjuds migreringsstöd.