Chaque release API. Chaque breaking change. Consigné.
Fabrixa publie les versions API et les mises à jour de la plateforme selon un calendrier prévisible. Chaque nouvelle version est d’abord publiée ici : ce qui a changé, les nouveautés, les fonctionnalités obsolètes et la date à laquelle elles cesseront de fonctionner. Consultez cette page avant de procéder à la mise à jour.
Ce qui a changé au cours des dernières semaines.
Les plus récentes en premier. Chaque entrée est datée, associée à une version SemVer et classée dans les catégories standard suivantes : Ajouté / Modifié / Obsolète / Supprimé / Corrigé / Sécurité.
- CHANGEDRupture de compatibilité : le chemin de base a été déplacé vers
/v2/integration. Les endpoints v1 sont obsolètes — les intégrations v1 existantes continueront de fonctionner pendant la période de transition ; voir le guide d'intégration pas à pas. - CHANGEDRupture de compatibilité : L'authentification se fait désormais via deux en-têtes —
Authorization: Bearer(Application Access Token) plusX-Application-Key. L'authentification v1 à jeton unique n'est plus acceptée. - ADDEDFabrixa Studio — configurateur de produit white-label intégrable : intégration via iframe, association d'un design enregistré à une ligne de commande avec
cart_item_key, et récupération d'un aperçu depuis/v2/studio/customizations/{key}/preview. - CHANGEDEnveloppe de réponse standard sur les endpoints de liste :
links/meta/dataavec des liens de pagination. - CHANGEDWebhooks regroupés sous
order.createdetorder.updated, signé avecx-webhook-signature(HMAC-SHA256) et associé aux balisesx-webhook-topic. - CHANGEDRate limit fixé à 30 requêtes par application et par minute, affichée via
X-RateLimit-LimitetX-RateLimit-Remainingen-têtes.
- ADDED
GET /v1/products/:id/pricing- prévisualisation des prix unitaires pour les différents niveaux de volume par SKU. - CHANGEDLe payload du webhook de commande comprend désormais un champ
production_hub(PT, ES ou NL). Compatible avec les versions antérieures.
- ADDEDPipeline de personnalisation à cinq modes pour la literie, le linge de table et les accessoires : texte, nom, chiffres, images et champs de données dynamiques.
- ADDED
order.failedévénement webhook avec des motifs d'erreur structurés (refus d'illustration, rupture de stock de tissu, etc.). - FIXEDCas limite de pagination sur
GET /v1/orderslors du filtrage par statut au-delà des limites de la page.
- ADDEDSKU coussin d'extérieur, nappe et pouf en matière synthétique, adaptés à une utilisation en extérieur. Disponibles via
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64champ dans le corps de la commande — indiquez plutôt l'URL du fichier source. Date de suppression prévue : v1.20.0 (28/03/2027). - SECURITYRenforcement du schéma de signature des webhooks. L'ancienne variante HMAC reste valide jusqu'à la version 1.18.0 ; le nouveau schéma de signature sera appliqué automatiquement à partir de cette version.
- ADDEDCatégorie « Linge de lit » (housses de couette 1P / 2P / lits jumeaux, couvre-lits, draps-housses) sur le hub espagnol.
- ADDEDSKU serviettes en sublimation sur le hub néerlandais, avec un SLA de 2 à 3 jours ouvrés.
- CHANGEDL'endpoint de commande accepte désormais
recipient.countrysous la forme ISO 3166-1 alpha-2 ; la valeur de secours alpha-3 a été supprimée.
Anciennes versions disponibles sur simple e-mail à developers@fabrixa.com.
SemVer, avec des modifications rompant la compatibilité appliquées de manière prudente.
Ruptures de compatibilité sur les endpoints existants
Rare. Annoncé 12 mois avant sa sortie. L'ancienne version majeure continue d'être prise en charge pendant 12 mois après la sortie de la nouvelle version majeure. Nous ne mettons pas fin aux versions majeures à la légère.
Nouveaux endpoints, champs et comportements
Ajouts compatibles avec les versions antérieures. Le code existant continue de fonctionner sans modification. La plupart des mises à jour sont mineures et sont publiées à un rythme d'environ deux à quatre semaines.
Corrections de bogues, performances, sécurité
Modification strictement non disruptive. Déployée en continu sans annonce préalable et consignée dans le changelog après le déploiement.
12 mois à partir de l'avis de dépréciation jusqu'à la suppression.
Lorsque nous déprécions un champ, un endpoint ou un comportement, l'entrée correspondante dans le changelog l'indique DEPRECATED et indique la version et la date prévues pour la suppression. La fonctionnalité obsolète continuera de fonctionner pendant au moins 12 mois après la publication de l'avis.
Nous envoyons trois notifications de rappel — six mois, trois mois et un mois avant la suppression — à l'adresse e-mail enregistrée pour la clé API.
Les endpoints obsolètes renvoient également un X-Fabrixa-Deprecation en-tête de réponse indiquant le chemin de migration, afin qu’il apparaisse dans vos journaux.
Comment suivre les modifications.
Pas besoin de vous abonner à des flux : cette page est la source d'information de référence. Voici comment rester informé de tout ce qui concerne votre intégration.
Commencez par consulter cette page
Chaque nouvelle version est publiée sur cette page, la plus récente apparaissant en haut. Ajoutez-la à vos favoris et consultez-la avant de mettre à jour une dépendance ou de déployer une nouvelle intégration.
Une piste dégagée
Lorsqu'un élément est en voie d'abandon, sa fiche est marquée d'un tag DEPRECATED avec la version et la date prévues pour la suppression — préavis, dans le contexte.
Se renseigner sur un changement
Vous prévoyez un changement ou une migration vers une version majeure ? Un Solutions Engineer peut vous détailler le calendrier et l'impact pour votre intégration.
Quand les ruptures de compatibilité peuvent être déployées.
Les lancements de nouvelles versions majeures sont programmés dans des créneaux spécifiques afin de ne pas coïncider avec les dates de drop de vos clients ou les périodes de forte activité commerciale. La plupart des années, aucun lancement de nouvelle version majeure n'a lieu.
Février et septembre constituent généralement les périodes propices aux changements majeurs : ces mois se situent à la fois après la grande saison des ventes au détail et avant la période de forte affluence, ce qui laisse aux intégrateurs le temps de procéder à la migration avant leur prochain grand drop.
Les périodes de novembre à décembre (vente au détail pendant les fêtes), de mars à mai (salon Fespa et drops de printemps), ainsi que les deux semaines précédant les événements majeurs du secteur, constituent des périodes pendant lesquelles aucune modification susceptible d'entraîner des ruptures n'est autorisée. Les mises à jour de correctifs se poursuivent, mais aucun changement de comportement, qu'il soit mineur ou majeur, n'est apporté.
L'équipe Solutions Engineering accompagne les intégrateurs lors des montées de version majeures.
Pour les changements de version majeurs, nous publions un guide de migration en complément des notes de mise à jour. L'équipe d'ingénierie des solutions organise également des sessions de consultation gratuites de 30 minutes sur la migration, destinées à tous les partenaires d'intégration actifs pendant la période de dépréciation — les réservations s'effectuent via la page « Contacter un Solutions Engineer ». Les clients Entreprise bénéficient d’une assistance dédiée à la migration dans le cadre de leur MSA, ainsi que d’un accès anticipé à la nouvelle version majeure sur un canal de vente de préproduction 90 jours avant sa mise à disposition publique.
Consultez cette page avant de mettre à jour.
Chaque nouvelle version est d'abord publiée ici : ce qui a changé, et à partir de quand ça casse. Les fonctionnalités obsolètes bénéficient d'une période de transition, et les changements de version majeurs s'accompagnent d'une aide à la migration.