01
Bestellingen
POST /v2/integration/orders
Dien een bestelling in met rijen, bron-PDF's, klantgegevens en verzendadres. Geeft de Fabrixa-bestel-ID terug. 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, fulfilment, 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 (bedrukken, 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, de volledige body van de bestelling, bezorging met 10 retries 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 Application Access Token en Application Key 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 Application Key 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 rows, sources (PDF-URL’s), customer en shipping_address. 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 Application Key. Elke webhook wordt ter verificatie voorzien van een HMAC-handtekening, met voorspelbare rate limits per applicatie.
Application Access Token
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-versleuteling
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-retries
Maximaal 10 bezorgpogingen bij een respons die niet in de 2xx- of 3xx-reeks valt. De webhook wordt na de 10e mislukte poging gedeactiveerd.
Veelgestelde vragen
De integratie-API, beantwoord
Hoe authenticeer ik me bij de Fabrixa API?
Elk verzoek moet twee headers bevatten: een Application Access Token dat als Bearer-token in de Authorization-header wordt verzonden, en een Application Key in de X-Application-Key-header. Beide worden gegenereerd op het moment dat je een verkoopkanaal aanmaakt in het Fabrixa-dashboard, en een verzoek wordt afgewezen met een 401-foutcode als een van beide headers ontbreekt.
Kan ik de Fabrixa API testen voordat ik echte bestellingen verstuur?
Ja — maak een speciaal verkoopkanaal aan om verder op voort te bouwen, dien testbestellingen in, controleer of de webhooks goed worden verzonden en test randgevallen; leid vervolgens echt verkeer naar je live kanaal zodra alles naar behoren werkt. Door dat kanaal te registreren en aan te maken, zijn je Application Access Token en Application Key onmiddellijk beschikbaar, zonder dat je daarvoor een aparte aanvraag hoeft in te dienen.
Is de Fabrixa-integratie-API versleuteld met HTTPS?
Ja — de API werkt uitsluitend via HTTPS op api.fabrixa.com, en elk verzoek in platte tekst wordt aan de rand geweigerd. Elk verzoek wordt bovendien geauthenticeerd met zowel een Bearer-token als een Application Key, en elke webhook-payload wordt ondertekend met HMAC-SHA256, zodat deze vóór verwerking kan worden geverifieerd.
Wat levert een POST-verzoek naar /v2/integration/orders op?
Een geauthenticeerde POST-aanroep naar /v2/integration/orders valideert de payload, reserveert een plek in de productiewachtrij en retourneert een bevestiging met het Fabrixa-bestel-ID in milliseconden, samen met optionele velden voor verzendlabels en tracking. De fulfilment kan vervolgens per bestelregel worden gevolgd of via webhooks naar je worden doorgestuurd.
Heb ik een SDK of proxy nodig om de Fabrixa API te integreren?
Nee — de integratie van Fabrixa is een directe REST-verbinding via standaard HTTP, waarbij geen SDK, geen proxyserver en geen connector van een derde partij nodig is. Je roept de API rechtstreeks vanuit je eigen stack aan met behulp van JSON-verzoeken en -antwoorden, met webhooks voor statuswijzigingen.
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 solutions engineers reageren binnen 24 uur — de meeste teams zijn binnen twee weken operationeel.