Aller directement au contenu principal
Une requête API Fabrixa à l'écran — payload de commande JSON avec en-têtes d'authentification, sur fond de textile tissé
documentation complète de l'API

Un endpoint. Une infinité de produits.

Chaque SKU Fabrixa, chaque tissu, chaque finition — accessibles via une seule REST API documentée. Entrée JSON, sortie JSON. Webhooks pour chaque changement d'état. Clés API en libre-service — créez un canal de vente et lancez-vous.

REST · JSON · Webhooks · Intégration Studio · Swagger

Ce que vous obtenez

Construit autour du fonctionnement réel de la production.

Une API REST documentée qui reflète l'ensemble de la plateforme : commandes, fulfilment, personnalisation de Studio et webhooks. Entrée JSON, sortie JSON. Utilisez-la en complément du tableau de bord ou contrôlez tout par programmation.

01
Commandes
POST /v2/integration/orders

Soumettre une commande avec les lignes, les PDF source, les détails du client et l'adresse de livraison. Renvoie l'identifiant de la commande Fabrixa. Champs facultatifs pour l'étiquette d'expédition et le suivi.

02
Fulfilment
GET /orders/{id}/fulfillments

Statut de production par article : chaque étape (impression, fixation, lavage, couture) avec les états pending / in progress / done / rejected. Ou souscrire à des webhooks pour le push.

03
Studio
Intégration d'un iframe

Intégrez Fabrixa Studio à votre boutique en ligne. Les clients personnalisent les produits en temps réel, grâce aux événements « postMessage » pour les actions « Ajouter au panier » et « Retour », ainsi qu'à une URL de prévisualisation pour les vignettes du panier.

04
Webhooks
order.created / order.updated

Deux sujets : payloads signés HMAC-SHA256, le corps de la commande complet, livraison en 10 tentatives avec back-off.

Guide de démarrage rapide

Passer une commande en un seul POST.

Requête authentifiée, payload validé, créneau réservé dans la file d'attente de production. Confirmation en quelques millisecondes : la commande de votre client est désormais en cours de traitement.

Le schéma complet, l'ensemble des endpoints, les codes d'erreur, les rate limits et les exemples d'intégration sont disponibles dans la documentation technique.

POST /v2/integration/orders
// POST https://api.fabrixa.com/v2/integration/orders
// Authorization: Bearer APPLICATION_ACCESS_TOKEN
// X-Application-Key: APPLICATION_KEY
{
  "number":       "ORD-2026-0142",
  "purchased_at": "2026-05-28 14:22:01",
  "rows": [
    {
      "sku":      "COF099191",
      "quantity": 1,
      "sources": [
        { "type": "file", "url": "https://cdn.you.com/art/9812.pdf" }
      ]
    }
  ],
  "customer": {
    "first_name": "Maria",
    "last_name":  "Silva",
    "email":      "maria@example.com",
    "phone":      "+351912345678"
  },
  "shipping_address": {
    "address":      "Rua do Carmo 42",
    "city":         "Lisboa",
    "postal_code":  "1200-094",
    "country_code": "PT",
    "country":      "Portugal"
  }
}
Processus d'intégration

Mise en service en deux semaines. Pas de proxy, pas d'intergiciel.

Intégration REST directe à votre plateforme. Aucun SDK requis, aucun serveur proxy, aucun connecteur tiers. Protocole HTTP standard entre votre infrastructure et la nôtre.

01
Identifiants

Pour obtenir un Application Access Token et une Application Key, créez un canal de vente dans votre tableau de bord. Ces deux éléments sont obligatoires pour chaque requête : le Bearer Token dans l'en-tête « Authorization », et l'Application Key dans l'en-tête « X-Application-Key ».

02
Catalogue

Consultez la documentation Swagger en ligne pour trouver les références SKU correspondant aux produits que vous souhaitez vendre, ainsi que les modèles de filtrage et de pagination.

03
Commandes

Au moment du paiement, envoyez une requête POST contenant rows, sources (URL des PDF), customer et shipping_address. Enregistrez l'identifiant de commande Fabrixa renvoyé en association avec votre propre référence de commande.

04
Webhooks

Exposer un endpoint POST public. Nous signons chaque payload avec HMAC-SHA256 (x-webhook-signature) afin que vous puissiez vérifier l'authenticité avant le traitement.

05
Studio

Facultatif : intégrez l'iframe Fabrixa Studio dans la page de votre produit. Les clients personnalisent leur produit en temps réel ; associez leurs personnalisations à la commande lors de l'envoi de la requête POST.

Ressources pour les développeurs

Tout ce dont votre équipe d'ingénieurs a besoin.

Référence API complète

Documentation complète des endpoints, schémas de requêtes/réponses, codes d'erreur, rate limits, authentification, intégration de Studio et contrats de webhooks — avec une interface Swagger en temps réel.

Ouvrir la documentation →

Développer sur un canal de vente

Créez un canal de vente dédié sur lequel vous pourrez vous appuyer — passez des commandes test, vérifiez la bonne réception des webhooks, validez les cas limites — puis redirigez le trafic réel vers votre canal en production. Vos clés sont prêtes dès la création du canal — aucune étape de demande n'est nécessaire.

Créez votre compte →

Collection Postman

Ensemble de requêtes préconfigurées comprenant des exemples de payloads et d'authentification. Importez-le dans votre workflow de test.

Obtenir la collection →
Sécurité

Authentification à deux en-têtes. Webhooks signés. Rate limits appliqués.

Des pratiques standard, sans surprise. Chaque requête est authentifiée à la fois par un Bearer Token et une Application Key. Chaque webhook est signé HMAC à des fins de vérification, avec des rate limits prévisibles par application.

Application Access Token

Bearer Token dans l'en-tête Authorization. Identifie l'application appelante.

Application Key

Envoyée dans l'en-tête X-Application-Key. Ces deux éléments sont obligatoires pour chaque requête ; l'absence de l'un ou de l'autre entraîne un code d'erreur 401.

Chiffrement TLS

HTTPS uniquement sur api.fabrixa.com. Les requêtes en texte brut sont rejetées à la périphérie.

Signatures des webhooks

Chaque webhook est signé à l'aide de l'algorithme HMAC-SHA256, et la signature est transmise dans l'en-tête « x-webhook-signature ». Vérifiez-la avant de traiter la requête.

Rate limits

30 requêtes par application et par minute. Les en-têtes « X-RateLimit-Limit » et « X-RateLimit-Remaining » sont renvoyés dans chaque réponse.

Retries du webhook

Jusqu'à 10 tentatives de livraison en cas de réponse autre qu'un code 2xx ou 3xx. Le webhook est désactivé après le 10e échec.

Commencez à créer

Créez un canal de vente et lancez-vous dès aujourd'hui.

Inscrivez-vous, créez un canal de vente et vos identifiants API seront immédiatement disponibles. Besoin d'aide ? Nos Solutions Engineers vous répondent dans les 24 heures — la plupart des équipes sont opérationnelles en deux semaines.