La solution d'impression à la demande Fabrixa API permet à n'importe quelle plateforme ou boutique en ligne POD d'envoyer une commande et d'en suivre le cycle de vie tout au long de order.created et order.updated webhooks, et confiez à Fabrixa l'impression, le conditionnement et l'expédition en white-label — qu'il s'agisse d'une seule pièce ou de commandes à l'échelle de l'Union européenne. Vous concevez l'expérience d'achat ; nous nous chargeons de la production textile à la demande en arrière-plan. Pas de quantité minimale de commande, pas de frais de mise en place, pas de logo Fabrixa sur le colis.
Cet article présente, dans un langage simple, une vue d'ensemble de l'intégration API (v2) à l'intention des développeurs qui envisagent d'utiliser Fabrixa comme couche de traitement des commandes. Si vous préférez parcourir la documentation de référence, la version complète Documentation de l'API et étape par étape guide d'intégration sont prêts dès que vous l'êtes.
À quoi sert l'API ?
Fabrixa est un plateforme d'impression textile réactive: un tableau de bord unique pour les canaux de vente, la conception, la production et l'expédition. La plupart des clients se connectent via Shopify, WooCommerce ou Fabrixa Studio. L'intégration API constitue la quatrième option : elle est conçue pour les plateformes POD et les développeurs qui possèdent déjà leur propre boutique en ligne et souhaitent disposer d'un contrôle programmatique sur la gestion des commandes.
Vous contactez API pour passer vos commandes. Fabrixa se charge de leur production : impression réactive sur coton et lin au Portugal et en Espagne, impression par sublimation sur polyester aux Pays-Bas. Les colis sont expédiés sous votre marque, avec votre adresse de retour, et aucune mention de Fabrixa n'apparaît sur l'emballage. Vos clients ne sauront jamais que nous existons, à moins que vous ne leur en parliez.
Fonctionnement de l'API
- Ping — un test de fonctionnement rapide permettant de vérifier que vos identifiants et votre connexion sont bien actifs avant d'envoyer quoi que ce soit de définitif.
- Produits — consultez le catalogue sur lequel vous vous basez : vêtements, linge de maison et tissus au mètre, avec les modèles de base et les variantes disponibles pour l'impression.
- Commandes — créer une commande et consulter son statut. C'est le cœur de toute intégration : on y introduit des lignes, des sources, les informations relatives au client et à la livraison ; on obtient en retour une commande suivie.
- Exécutions — Suivez la production et l'expédition au fur et à mesure que les articles sont fabriqués et expédiés, afin que votre plateforme puisse afficher un statut précis aux vendeurs.
- Studio — joindre un motif personnalisé dans Fabrixa Studio (notre configurateur de produits intégrable et en white-label) à une commande en fonction de son
clé_article_panier, ce qui fait que ce que l'acheteur a conçu est exactement ce qui est imprimé.
Authentification et rate limits
L'intégration API (v2) est accessible à l'URL de base https://api.fabrixa.com/v2/integration. Chaque requête comporte deux en-têtes:
| En-tête | Objectif |
|---|---|
Autorisation : au porteur |
Votre jeton API — permet d'identifier et d'autoriser la requête. |
X-Application-Key : |
Votre clé d'application — elle est associée au jeton ; les deux doivent donc être présents. |
La limite de débit est de 30 requêtes par minute. C'est largement suffisant pour le trafic généré par les commandes, mais cela signifie que les opérations en masse doivent être espacées plutôt que lancées en boucle serrée. Gérez cette limite avec souplesse, ralentissez lorsque vous l'atteignez et privilégiez les webhooks (voir ci-dessous) plutôt que l'interrogation régulière.
Webhooks : réagissez à l'état, ne le vérifiez pas en continu
Au lieu de demander sans cesse “ C'est déjà fait ? ”, abonnez-vous aux webhooks et laissez Fabrixa vous avertir dès qu'un changement survient. L'intégration API génère deux événements :
- order.created — se déclenche lorsqu'une commande est acceptée pour la production. Utilisez-le pour confirmer la réception à votre vendeur et marquer la commande comme étant en cours de traitement.
- order.updated — déclenche des actions à mesure que la commande passe par les étapes de production et d'expédition, y compris le suivi. Utilisez-le pour synchroniser l'état de votre plateforme sans dépasser votre limite de requêtes.
Entre deux événements et un plafond de 30 par minute, une intégration bien conçue frôle à peine la limite : envoyer la commande, puis réagir à la réponse reçue.
Le flux des commandes, de bout en bout
Quel que soit l'itinéraire que vous choisissiez, le tracé reste le même :
- Connecter — une boutique en ligne (Shopify ou WooCommerce) ou la plateforme API.
- Conception — personnalisez-le dans Fabrixa Studio, ou fournissez un fichier PDF prêt à imprimer.
- Envoyer la commande — via la table API, avec les lignes de produit, le client et l'adresse de livraison.
- Nous fabriquons et expédions — Fabrixa se charge de l'impression, de l'emballage et de l'expédition, en white-label.
Un petit mot sur la qualité, car c’est la raison pour laquelle les vendeurs choisissent la teinture réactive : le colorant réactif forme une liaison covalente avec la cellulose de la fibre de coton et se fixe de manière permanente sous l’effet de la chaleur et de la vapeur. La couleur fait partie intégrante de la fibre — pas de couche superficielle, pas de craquelures aux points de flexion —, ce qui donne au tissu le toucher d’un coton non imprimé et garantit généralement une tenue de la couleur pendant plus de 600 cycles de lavage. À titre d’exemple de délai de fabrication, les vêtements fabriqués au Portugal sont prêts en 6 à 9 jours ouvrés environ.
Pourquoi les plateformes s'appuient sur le modèle Fabrixa
- MOQ 1 — d’une seule pièce à plusieurs dizaines de milliers. Pas de quantité minimale, pas de frais de mise en place, pas de contrat.
- White-label par défaut — c'est la marque du client qui figure sur chaque colis, et non la nôtre.
- Chaîne d'approvisionnement courte au sein de l'UE — la production au Portugal, en Espagne et aux Pays-Bas, et non le transport de marchandises sur de longues distances.
- Impression véritablement réactive — Du coton biologique certifié GOTS comme matière de base par défaut, ainsi que les certifications OEKO-TEX Standard 100 et Made in Green.
FAQ
Dois-je utiliser Fabrixa Studio pour pouvoir utiliser l'API ?
Non. Studio est facultatif. Vous pouvez envoyer à la place un fichier PDF prêt à imprimer avec la commande. Studio n'intervient que lorsque vous souhaitez que les acheteurs personnalisent un produit dans votre boutique en ligne, et vous associez ce motif à la commande en clé_article_panier.
Comment puis-je authentifier les requêtes ?
Envoyer deux en-têtes à chaque appel : Autorisation : au porteur et X-Application-Key :. Ces deux éléments sont obligatoires : si l'un des deux manque, la demande sera rejetée.
Que se passe-t-il si j'atteins la limite de requêtes ?
L'API est limité à 30 requêtes par minute. Si vous dépassez cette limite, attendez un peu avant de réessayer plutôt que de surcharger l'endpoint. Pour les changements d'état, utilisez la order.created et order.updated Les webhooks plutôt que l'interrogation régulière : ils vous permettent de rester synchronisé sans gaspiller de requêtes.
La gestion des commandes est-elle vraiment en white-label ?
Oui. Les colis sont expédiés sous votre marque, avec votre adresse d'expéditeur, et ne comportent par défaut aucune mention de la marque Fabrixa. Vos clients finaux ne nous voient jamais.
Commencez à créer
Le moyen le plus rapide d'y accéder est le guide d'intégration, avec le soutien total de Documentation de l'API. Si vous préférez d'abord voir comment tout cela s'articule, le Présentation de la plateforme passe par les différents canaux : Studio, production et expédition. Et si vous souhaitez tester la compatibilité avec votre plateforme, parlez à notre équipe — nous serons ravis d'examiner avec vous votre cas d'utilisation.
