01
Importer la collection
Dans Postman : File → Import → Link. Collez l'URL JSON à partir du bouton de téléchargement ci-dessus. Postman ajoute la collection — avec ses variables — à votre espace de travail.
Développeurs · Collection Postman
Importez la collection. Cinq minutes et vous y êtes.
Une collection Postman prête à l'emploi, comprenant des exemples concrets pour l'API d'intégration de Fabrixa. Saisissez vos identifiants, parcourez la requêtes et observez les réponses réelles renvoyées par l'API avant même d'écrire la moindre ligne de code d'intégration. Mise à jour à chaque nouvelle version : la collection est actualisée dès que l'API est mise à jour.
Que contient la collection ?
Chaque endpoint, avec des exemples de payloads.
Organisée en dossiers par ressource. Chaque requête est fournie avec un exemple de corps de requête, les deux en-têtes d'authentification préconfigurés et un exemple de réponse enregistré — ce qui vous permet de prévisualiser la structure de la réponse avant de lancer la requête.
Authentification et produits
- GET /ping — vérifier les identifiants
- GET /products — liste et pagination (SKU + variant_id)
- Schémas complets des champs dans la documentation Swagger
Commandes
- POST /orders — créer une commande
- GET /orders/{id}/fulfillments — suivre la production
Studio et webhooks
- GET /v2/studio/customizations/{key}/preview
- Payload du webhook + vérification HMAC (exemple)
Importation en 30 secondes
File → Import → Link → collez l'URL.
02
Ouvrez l'onglet « Variables »
La collection est fournie avec ses propres variables — base_url est prérempli ; access_token et application_key sont des espaces réservés. Aucun fichier d'environnement distinct n'est nécessaire.
03
Collez vos clés
Saisissez l'Application Access Token et l'Application Key d'un canal de vente dans votre tableau de bord, cliquez sur « Save », et chaque requête sera authentifiée.
Variables d'environnement
Ce qui se trouve dans le fichier env.
Une URL de base, deux identifiants, intégrés directement dans la collection. Développez votre application pour un canal de vente, puis collez les clés de votre canal de production au moment de la mise en production : même collection, mêmes requêtes.
Variables de collection
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Auth préconfiguré
Les deux en-têtes d'authentification, prédéfinis pour chaque requête.
Chaque requête comporte Authorization: Bearer {{access_token}} et X-Application-Key: {{application_key}}, extraites des variables de collection — aucune configuration d'en-tête par requête n'est nécessaire. Pour passer d'un canal de vente à un autre, il suffit de modifier ces deux variables : même collection, clés différentes.
Exemples détaillés
Chaque requête est accompagnée d'un exemple de corps et d'une réponse enregistrée.
Cette collection ne se limite pas à des URL factices : chaque requête est accompagnée d'un exemple concret, ce qui vous permet de cliquer sur « Send » et de visualiser des données réelles. Les exemples de réponses enregistrés sont disponibles dans le panneau « Examples » pour une consultation hors ligne.
Vérifier l'authentification
Vérifie avant toute chose que votre Application Access Token et votre Application Key sont valides. Code 200 en cas de réussite, 401 si un en-tête est manquant.
Lister les produits
Requête de catalogue paginée. Renvoie les produits page par page dans l'enveloppe links / meta / data, avec le SKU et l'identifiant de variante pour chaque article.
Passer une commande
Exemple de contenu pour une commande d'un t-shirt, avec un fichier PDF source, les coordonnées du client et l'adresse de livraison. Cliquez sur « Send » pour voir la commande créée avec son identifiant Fabrixa.
Suivi de la production
Affiche les étapes de production par article (impression, fixation, lavage, couture) avec les statuts pending, in progress, done ou rejected pour une commande passée.
Aperçu Studio
Renvoie l'image d'aperçu générée pour une personnalisation Studio enregistrée — vous pouvez l'insérer directement dans la vignette d'un panier.
Vérification de la signature
Exemple concret illustrant le recalcul de la signature HMAC-SHA256 et sa comparaison avec la signature « x-webhook-signature » avant le traitement.
Gestion des versions
La collection est mise à jour en même temps que l'API.
Chaque nouvelle version de l'API propose une collection mise à jour à la même URL. Réimportez-la pour récupérer les nouveaux endpoints et les exemples de payloads — les requêtes existantes de votre version enregistrée continueront de fonctionner jusqu’à ce que l'endpoint en question soit effectivement obsolète.
URL permanente
L'URL du fichier JSON de la collection est permanente. Une réimportation permet de récupérer la dernière version : l'URL ne change jamais d'une version à l'autre.
Référence du changelog
Voir le changelog pour les notes de version correspondantes de l'API - ce qui a été déplacé, ce qui a été ajouté, ce qui est déprécié.
Politique de dépréciation
Les endpoints bénéficient d'une période de dépréciation de 12 mois. La collection signale les requêtes dépréciées dans la description, ce qui permet de les repérer facilement avant que des dysfonctionnements ne surviennent.
Télécharger et démarrer
Récupérez la collection. Lancez votre première requête.
Importez la collection, saisissez vos identifiants de canal de vente et envoyez votre première requête en quelques minutes — aucun code d'intégration n'est nécessaire pour commencer à explorer la plateforme.