Elke API-release. Elke breaking change. Vastgelegd.
Fabrixa brengt API- en platformupdates uit volgens een vast patroon. Elke release verschijnt hier als eerste — wat is er veranderd, wat is er nieuw, wat wordt afgeschaft en wanneer gaat het daadwerkelijk niet meer werken. Kijk hier even voordat je een upgrade uitvoert.
Wat er de afgelopen weken is veranderd.
De meest recente vermelding staat bovenaan. Elk item is voorzien van een datum en een semver-tag, en is onderverdeeld in de standaardcategorieën: ADDED / CHANGED / DEPRECATED / REMOVED / FIXED / SECURITY.
- CHANGEDBreaking: het basispad is verplaatst naar
/v2/integration. De v1-endpoints zijn verouderd — bestaande v1-integraties blijven tijdens de overgangsperiode gewoon werken; zie de integratiegids. - CHANGEDBreaking: de authenticatie bestaat nu uit twee headers —
Authorization: Bearer(toegangstoken van de applicatie) plusX-Application-Key. Authenticatie met één token (v1) wordt niet langer geaccepteerd. - ADDEDFabrixa Studio — een in te sluiten white-label productconfigurator: insluiten via iframe, een opgeslagen ontwerp aan een bestelregel toevoegen met
cart_item_key, en haal een voorbeeld op uit/v2/studio/customizations/{key}/preview. - CHANGEDStandaard response-envelope op lijst-endpoints:
links/meta/datamet pagineringlinks. - CHANGEDWebhooks samengevoegd tot
order.createdenorder.updated, ondertekend metx-webhook-signature(HMAC-SHA256) en getagd metx-webhook-topic. - CHANGEDDe verzoeklimiet is ingesteld op 30 verzoeken per applicatie per minuut, weergegeven via
X-RateLimit-LimitenX-RateLimit-Remainingheaders.
- ADDED
GET /v1/products/:id/pricing- stukprijs per staffel vooraf bekijken in volumeniveaus per SKU. - CHANGEDDe payload van de bestel-webhook bevat nu een
production_hubveld (PT, ES of NL). Achterwaarts compatibel.
- ADDEDPijplijn voor personalisatie in vijf modi voor beddengoed, tafellinnen en accessoires: tekst, naam, cijfers, afbeeldingen en dynamische gegevensvelden.
- ADDED
order.failedwebhook-gebeurtenis met gestructureerde foutredenen (afwijzing van het drukbestand, stof niet op voorraad en dergelijke). - FIXEDRandgeval bij paginering op
GET /v1/ordersbij het filteren op status over paginagrenzen heen.
- ADDEDBuitenkussen, tafelkleed en zitzak-SKU's voor gebruik buitenshuis, gemaakt van synthetisch materiaal. Verkrijgbaar via
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64veld in de body van de bestelling — geef in plaats daarvan de URL van het bronbestand op. Te verwijderen vanaf versie v1.20.0 (28-03-2027). - SECURITYHet handtekeningsschema voor webhooks is versterkt. De vorige HMAC-variant blijft geldig tot en met versie 1.18.0; vanaf nu wordt automatisch de nieuwe handtekening toegepast.
- ADDEDCategorie beddengoed (dekbedovertrekken voor 1P / 2P / Lits Jumeaux, spreien, hoeslakens) op de Spaanse hub.
- ADDEDSublimatieservet-SKU's op de Nederlandse hub met een levertijd van 2–3 werkdagen.
- CHANGEDHet order-endpoint accepteert nu
recipient.countryals ISO 3166-1 alpha-2; de alpha-3-reserve is verwijderd.
Oudere versies kun je opvragen — stuur een e-mail naar developers@fabrixa.com.
SemVer, met voorzichtige breaking changes.
Breaking changes aan bestaande endpoints
Zeldzaam. Wordt 12 maanden voor de release aangekondigd. De oude hoofdversie blijft nog 12 maanden na de release van de nieuwe hoofdversie ondersteund. We schrappen hoofdversies niet zomaar.
Nieuwe endpoints, velden, gedragingen
Achterwaarts compatibele toevoegingen. Bestaande code blijft zonder aanpassingen werken. De meeste releases zijn kleine updates, die ongeveer om de twee tot vier weken verschijnen.
Bugfixes, prestaties, beveiliging
Absoluut geen breaking changes. Wordt continu geïmplementeerd zonder voorafgaande aankondiging en wordt na de implementatie in het changelog vastgelegd.
12 maanden vanaf bericht van afschrijving tot verwijdering.
Wanneer we een veld, endpoint of gedrag als verouderd markeren, wordt dit in het changelog-item aangeduid DEPRECATED en vermeldt de versie en de datum waarop de functie wordt verwijderd. De verouderde functionaliteit blijft nog minstens 12 maanden na de kennisgeving werken.
We sturen drie herinneringsberichten — zes maanden, drie maanden en één maand vóór de verwijdering — naar het e-mailadres dat bij de API-sleutel is geregistreerd.
Verouderde endpoints geven ook een X-Fabrixa-Deprecation een responsheader die naar het migratietraject verwijst, zodat dit in je logbestanden te zien is.
Hoe houd je wijzigingen bij?
Geen feeds die je hoeft aan te sluiten — deze pagina is dé betrouwbare bron. Zo blijf je op de hoogte van alles wat van invloed is op je integratie.
Kijk hier eerst even
Elke release wordt op deze pagina geplaatst, met de meest recente bovenaan. Maak er een bladwijzer van en bekijk de pagina voordat je een afhankelijkheid bijwerkt of een nieuwe integratie implementeert.
Ruim van tevoren aangekondigd
Wanneer iets uit de roulatie gaat, wordt het betreffende item gemarkeerd DEPRECATED met de beoogde versie en datum voor verwijdering — voorafgaande kennisgeving, in de juiste context.
Vraag naar een wijziging
Ben je bezig met de planning rond een wijziging of een migratie naar een nieuwe hoofdversie? Een solutions engineer kan je uitleggen hoe de timing en de gevolgen van je integratie eruitzien.
Wanneer breaking changes kunnen worden verzonden.
De release van nieuwe hoofdversies wordt gepland in specifieke periodes, zodat deze niet samenvallen met de dropdata van klanten of piekperiodes in de detailhandel. In de meeste jaren worden er geen nieuwe hoofdversies uitgebracht.
Februari en september zijn de gebruikelijke periodes voor ingrijpende wijzigingen — beide vallen na het grote winkelseizoen en vóór de piekperiode, waardoor integrators de tijd hebben om de migratie af te ronden vóór hun volgende grote levering.
November–december (kerstinkopen), maart–mei (Fespa en de voorjaarscollecties) en de twee weken voorafgaand aan bekende branche-evenementen zijn periodes waarin geen ingrijpende wijzigingen worden doorgevoerd. Er worden wel patches uitgebracht, maar er vinden geen kleine of grote wijzigingen in de werking plaats.
Solutions engineering loodst integrators door elke major-versiesprong.
Bij grote versie-updates publiceren we naast de release-opmerkingen ook een migratiegids. De afdeling Solutions Engineering organiseert bovendien gratis migratiespreekuren van 30 minuten voor alle actieve integratiepartners tijdens de overgangsperiode — je kunt je hiervoor aanmelden via de pagina ‘contact-engineer’. Enterprise-klanten krijgen specifieke migratieondersteuning in hun MSA, plus vroegtijdige toegang tot de nieuwe hoofdversie via een staging-verkoopkanaal, 90 dagen voordat deze voor het grote publiek beschikbaar komt.
Kijk hier even voordat je de upgrade uitvoert.
Elke release verschijnt hier als eerste — wat er is veranderd en wanneer er fouten optreden. Verouderde functies krijgen een overgangsperiode, en bij overgangen naar een nieuwe hoofdversie wordt migratieondersteuning geboden.