Hver API-release. Hver breaking change. Logget.
Fabrixa udgiver API og platformopdateringer med regelmæssige mellemrum. Hver udgivelse offentliggøres her først — hvad der er ændret, hvad der er nyt, hvad der udfases, og hvornår det rent faktisk ikke længere fungerer. Tjek her, før du opgraderer.
Hvad der er sket i de seneste uger.
Seneste først. Hver post er dateret, mærket med semver og inddelt i standardkategorierne: Tilføjet / Ændret / Udgået / Fjernet / Rettet / Sikkerhed.
- CHANGEDSeneste nyt: basisstien er flyttet til
/v2/integration. V1-endpunkterne er udfaset — eksisterende v1-integrationer fungerer fortsat i udfasningsperioden; se integrationsvejledning. - CHANGEDSeneste nyt: godkendelsen består nu af to headere —
Authorization: Bearer(adgangstoken til applikationen) plusX-Application-Key. Autentificering med én token (v1) accepteres ikke længere. - ADDEDFabrixa Studio — produktkonfigurator, der kan integreres som white-label-løsning: integrer via iframe, vedhæft et gemt design til en ordrelinje med
cart_item_key, og hent et eksempel fra/v2/studio/customizations/{key}/preview. - CHANGEDStandardresponskonvolut ved listeendepunkter:
links/meta/datamed links til næste og forrige side. - CHANGEDWebhooks samlet i
order.createdogorder.updated, underskrevet medx-webhook-signature(HMAC-SHA256) og mærket medx-webhook-topic. - CHANGEDRatebegrænsningen er indstillet til 30 anmodninger pr. applikation pr. minut og vises via
X-RateLimit-LimitogX-RateLimit-Remainingoverskrifter.
- ADDED
GET /v1/products/:id/pricing— få et overblik over enhedspriserne på tværs af mængdeniveauer pr. SKU. - CHANGEDWebhook-payloadet indeholder nu en
production_hubfelt (PT, ES eller NL). Bagudkompatibel.
- ADDEDPipeline til personliggørelse i fem trin af sengetøj, borddug og tilbehør: tekst, navn, tal, billeder og dynamiske datafelter.
- ADDED
order.failedwebhook-begivenhed med strukturerede fejlårsager (afvisning af illustrationer, udsolgt stof og lignende). - FIXEDSærligt tilfælde ved paginering på
GET /v1/ordersnår der filtreres efter status på tværs af sidegrænser.
- ADDEDUdendørspude, dug og siddepose SKUs til udendørs brug af syntetiske materialer. Kan købes via
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64feltet i ordrens hoveddel — angiv i stedet en URL til kildefilen. Fjernes fra version v1.20.0 (28. marts 2027). - SECURITYWebhook-signaturordningen er blevet styrket. Den tidligere HMAC-variant forbliver gyldig frem til version 1.18.0; fremover anvendes den nye signaturmetode automatisk.
- ADDEDKategorien »Sengetøj« (dynebetræk til 1P / 2P / Lits Jumeaux, sengetæpper, stræklagner) på den spanske hjemmeside.
- ADDEDSublimeringsserviet SKUs på det hollandske knudepunkt med en leveringstid på 2–3 hverdage.
- CHANGEDBestillingsendepunktet accepterer nu
recipient.countrysom ISO 3166-1 alfa-2; alfa-3-reserveværdien er blevet fjernet.
Ældre udgivelser kan fås på forespørgsel — send en e-mail developers@fabrixa.com.
SemVer med konservative ændringer, der bryder med tidligere versioner.
Væsentlige ændringer i eksisterende endpoints
Sjældent. Annonceret 12 måneder før udgivelsen. Den gamle hovedversion understøttes i 12 måneder efter, at den nye hovedversion er udgivet. Vi afskaffer ikke hovedversioner uden videre.
Nye slutpunkter, felter, funktionalitet
Tilføjelser med bagudkompatibilitet. Den eksisterende kode fungerer fortsat uden ændringer. De fleste udgivelser er mindre opdateringer, der udkommer med cirka to til fire ugers mellemrum.
Fejlrettelser, ydeevne, sikkerhed
Uden nogen form for afbrydelse. Implementeres løbende uden forudgående varsel og registreres i ændringsloggen efter implementeringen.
12 måneder fra meddelelsen om udfasning til fjernelse.
Når vi markerer et felt, et endpoint eller en funktionalitet som forældet, angives dette i changelog-posten DEPRECATED og angiver den version og dato, hvor funktionen vil blive fjernet. Den udfasede funktionalitet vil fortsat fungere i mindst 12 måneder efter meddelelsen.
Vi sender tre påmindelser — seks måneder, tre måneder og en måned før sletningen — til den e-mailadresse, der er registreret for API-nøglen.
Forældede endpoints returnerer også en X-Fabrixa-Deprecation responshovedet, der angiver migrationsstien, så den fremgår af dine logfiler.
Sådan holder du styr på ændringerne.
Ingen feeds, der skal tilsluttes — denne side er den eneste pålidelige kilde. Her kan du se, hvordan du holder dig opdateret om alt, der har betydning for din integration.
Se her først
Alle udgivelser vises på denne side, med den seneste øverst. Tilføj siden til dine bogmærker, og tjek den, før du opgraderer en afhængighed eller lancerer en ny integration.
En fri landingsbane
Når noget udfases, mærkes den tilhørende post DEPRECATED med angivelse af den version og dato, der skal fjernes — forhåndsmeddelelse, i den aktuelle sammenhæng.
Spørg om en ændring
Er du i gang med at planlægge en ændring eller en overgang til en ny hovedversion? En løsningsingeniør kan gennemgå tidsplanen og konsekvenserne for din integration med dig.
Hvornår kan ændringer, der medfører inkompatibilitet, udgives.
Udgivelser af hovedversioner planlægges til bestemte tidsvinduer, så de ikke falder sammen med kundernes leveringsdatoer eller højsæsoner i detailhandlen. De fleste år udgives der ingen hovedversioner.
Februar og september er de typiske perioder for ændringer, der medfører afbrydelser — henholdsvis efter den store detailsæson og før højsæsonen — hvilket giver integratorerne tid til at gennemføre overgangen, inden deres næste store levering.
November–december (julesalget), marts–maj (Fespa og forårskollektionerne) samt de to uger op til kendte branchebegivenheder er perioder, hvor der ikke foretages ændringer. Der udgives fortsat opdateringer, men der indføres ingen mindre eller større ændringer i funktionaliteten.
Løsningsudviklingen hjælper integratorerne med at overvinde de største forhindringer.
Ved større versionsopdateringer offentliggør vi en migrationsvejledning sammen med release notes. Solutions Engineering afholder desuden gratis 30-minutters migrationskonsultationer for alle aktive integrationspartnere i udfasningsperioden — book via siden »contact-engineer«. Enterprise-kunder får dedikeret migrationssupport som en del af deres MSA samt tidlig adgang til den nye hovedversion via en testkanal 90 dage før den bliver offentligt tilgængelig.
Tjek her, før du opgraderer.
Alle nye udgivelser lander her først — hvad der er ændret, og hvornår det ikke længere fungerer. Udfasede funktioner får en overgangsperiode, og ved overgang til en ny hovedversion ydes der support til migrering.