01
Bestellingen
POST /v2/integration/orders
Dien een bestelling in met rijen, bron-PDF's, klantgegevens en verzendadres. Geeft de Fabrixa order-ID. Optionele velden voor verzendlabel en tracering.
API-documentatie
Eén endpoint. Oneindig veel producten.
Elke Fabrixa-SKU, elke stof, elke afwerking — allemaal toegankelijk via één gedocumenteerde REST API. JSON-invoer, JSON-uitvoer. Webhooks voor elke statuswijziging. Zelf te beheren API-sleutels — maak een verkoopkanaal aan en ga aan de slag.
Wat je krijgt
Gebouwd rond hoe productie eigenlijk werkt.
Een gedocumenteerde REST API die het platform volledig weerspiegelt — bestellingen, afhandeling, Studio-aanpassingen en webhooks. JSON erin, JSON eruit. Gebruik het naast het dashboard, of stuur alles programmatisch aan.
02
Fulfilment
GET /orders/{id}/fulfillments
Haal de productiestatus per regelitem op: elke stap (printen, fixeren, wassen, naaien) met status in afwachting / in uitvoering / klaar / afgekeurd. Of abonneer je op webhooks voor push.
03
Studio
iframe insluiten
Integreer Fabrixa Studio in je webwinkel. Klanten kunnen producten in realtime aanpassen, met postMessage-gebeurtenissen voor ‘toevoegen aan winkelwagen’ en ‘terug’, plus een preview-URL voor miniatuurafbeeldingen in de winkelwagen.
04
Webhooks
order.created / order.updated
Twee onderwerpen: met HMAC-SHA256 ondertekende payloads, volledige orderbody, bezorging met 10 pogingen en back-off.
Snel aan de slag
Plaats een bestelling in één POST.
Geauthenticeerd verzoek, gevalideerde payload, plaats gereserveerd in de productiewachtrij. Bevestiging binnen enkele milliseconden — de bestelling van je klant is nu in behandeling.
Het volledige schema, alle endpoints, foutcodes, rate limits en integratievoorbeelden zijn te vinden in de technische documentatie.
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" } }
Integratieproces
Live over twee weken. Geen proxy, geen middleware.
Directe REST-integratie in je platform. Geen SDK nodig, geen proxyserver, geen connector van een derde partij. Standaard HTTP van je stack naar die van ons.
01
Referenties
Vraag een applicatietoegangstoken en een applicatiesleutel aan door een verkoopkanaal aan te maken in je dashboard. Beide zijn bij elk verzoek vereist: het Bearer-token in de Authorization-header en de applicatiesleutel in de X-Application-Key-header.
02
Catalogus
Bekijk de live Swagger-referentie om de variant-SKU's te vinden voor de producten die je wilt verkopen, evenals filter- en paginatiepatronen.
03
Bestellingen
Stuur bij het afrekenen een POST-verzoek met de rijen, bronnen (PDF-URL’s), klant en verzendadres. Sla de teruggestuurde Fabrixa-bestel-ID op in combinatie met je eigen bestelreferentie.
04
Webhooks
Stel een openbaar POST-endpoint bloot. We ondertekenen elke payload met HMAC-SHA256 (x-webhook-signature) zodat je de authenticiteit kunt verifiëren voor verwerking.
05
Studio
Optioneel: plaats het iframe van Fabrixa Studio op je productpagina. Klanten kunnen hun product direct aanpassen; hun aanpassingen worden via een POST-verzoek aan de bestelling toegevoegd.
Bronnen voor ontwikkelaars
Alles wat je engineeringteam nodig heeft.
Volledige API-referentie
Volledige documentatie van endpoints, verzoek-/antwoordschema’s, foutcodes, rate limits, authenticatie, Studio-integratie en webhook-contracten — met een live Swagger-interface.
Open de docs →Bouwen op een verkoopkanaal
Maak een speciaal verkoopkanaal aan waarop je kunt voortbouwen — plaats testbestellingen, controleer of de webhooks goed worden afgeleverd en test uitzonderingsgevallen — en leid vervolgens echt verkeer naar je live kanaal. Je sleutels zijn direct beschikbaar zodra je het kanaal aanmaakt — je hoeft hiervoor geen aanvraag in te dienen.
Maak je account aan →Postman-collectie
Vooraf geconfigureerde collectie van verzoeken met voorbeeldpayloads en authenticatie. Importeer deze in je testworkflow.
Haal de collectie op →
SECURITY
Auth met twee headers. Ondertekende webhooks. Rate-limited.
Standaardprocedures, geen verrassingen. Elk verzoek wordt geauthenticeerd met zowel een Bearer-token als een applicatiesleutel. Elke webhook wordt ter verificatie voorzien van een HMAC-handtekening, met voorspelbare limieten per applicatie.
Access Token voor toepassing
Bearer-token in de Authorization-header. Identificeert de aanroepende applicatie.
Application Key
Wordt verzonden in de X-Application-Key-header. Beide zijn bij elk verzoek verplicht — als een van beide ontbreekt, wordt een 401-foutcode geretourneerd.
TLS-codering
Alleen HTTPS op api.fabrixa.com. Verzoeken in platte tekst worden aan de rand afgewezen.
Webhook-handtekeningen
Elke webhook wordt ondertekend met HMAC-SHA256 en meegestuurd in de x-webhook-signature-header. Controleer dit voordat je de webhook verwerkt.
Rate limits
30 verzoeken per applicatie per minuut. Bij elk antwoord worden de velden `X-RateLimit-Limit` en `X-RateLimit-Remaining` teruggestuurd.
Webhook pogingen
Maximaal 10 bezorgpogingen bij een respons die niet in de 2xx- of 3xx-reeks valt. De webhook wordt na de 10e mislukte poging gedeactiveerd.
Begin met bouwen
Maak een verkoopkanaal aan en ga vandaag nog aan de slag.
Registreer je, maak een verkoopkanaal aan en je API-inloggegevens zijn direct beschikbaar. Hulp nodig? Onze oplossingsspecialisten reageren binnen 24 uur — de meeste teams zijn binnen twee weken operationeel.