01
Bestellungen
POST /v2/integration/orders
Übermitteln Sie eine Bestellung mit Zeilen, Quell-PDFs, Kundendaten und Lieferadresse. Gibt die Fabrixa-Bestell-ID zurück. Optionale Felder für Versandetikett und Sendungsverfolgung.
API-Dokumentation
Ein Endpoint. Unendlich viele Produkte.
Jede Fabrixa-SKU, jeder Stoff, jede Verarbeitung – über eine einzige dokumentierte REST API zugänglich. JSON-Eingabe, JSON-Ausgabe. Webhooks für jeden Zustandswechsel. API-Schlüssel zur Selbstverwaltung – erstellen Sie einen Vertriebskanal und legen Sie los.
Was Sie erhalten
Gebaut um die Art, wie Produktion wirklich funktioniert.
Eine dokumentierte REST API, das die Plattform widerspiegelt – Bestellungen, Fulfilment, Studio-Anpassungen und Webhooks. JSON rein, JSON raus. Nutzen Sie es zusammen mit dem Dashboard oder steuern Sie alles programmgesteuert.
02
Fulfilment
GET /orders/{id}/fulfillments
Rufen Sie den Produktionsstatus pro Position ab: jeder Schritt (Drucken, Fixieren, Waschen, Nähen) mit den Zuständen "ausstehend", "in Bearbeitung", "erledigt" und "abgelehnt". Oder abonnieren Sie Webhooks für Push.
03
Studio
iframe einbetten
Binden Sie Fabrixa Studio in Ihren Online-Shop ein. Kunden können Produkte in Echtzeit individuell gestalten – mit „postMessage“-Events für „In den Warenkorb“ und „Zurück“ sowie einer Vorschau-URL für Warenkorb-Miniaturansichten.
04
Webhooks
order.created / order.updated
Zwei Topics: HMAC-SHA256-signierte Payloads, vollständiger Order-Body, Zustellung mit 10 Retries und Back-off.
Schnellstart
Geben Sie eine Bestellung in einem POST auf.
Authentifizierte Anfrage, validierte Payloads, Platz in der Produktionswarteschlange reserviert. Bestätigung innerhalb von Millisekunden – die Bestellung Ihres Kunden ist nun in Bearbeitung.
Das vollständige Schema, alle Endpoints, Fehlercodes, Rate Limits und Integrationsbeispiele finden Sie in der technischen Dokumentation.
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" } }
Integrationsablauf
Live in zwei Wochen. Kein Proxy, keine Middleware.
Direkte REST-Integration in Ihre Plattform. Kein SDK erforderlich, kein Proxy-Server, kein Konnektor von Drittanbietern. Standard-HTTP von Ihrem Stack zu unserem.
01
Credentials
Erstellen Sie in Ihrem Dashboard einen Vertriebskanal, um ein Application Access Token und einen Application Key zu erhalten. Beide sind bei jeder Anfrage erforderlich: das Bearer-Token im Authorization-Header und der Application Key im Feld „X-Application-Key“.
02
Katalog
Durchsuchen Sie die Live-Swagger-Referenz, um die Varianten SKUs für die Produkte zu finden, die Sie verkaufen möchten, sowie Filter- und Paginierungsmuster.
03
Bestellungen
Senden Sie beim Bezahlvorgang einen POST-Request mit rows, sources (PDF-URLs), customer und shipping_address. Speichern Sie die zurückgegebene Fabrixa-Bestell-ID unter Ihrer eigenen Bestellnummer ab.
04
Webhooks
Stellen Sie einen öffentlichen POST-Endpoint zur Verfügung. Wir signieren jeden Payload mit HMAC-SHA256 (x-webhook-signature), damit Sie die Authentizität vor der Verarbeitung überprüfen können.
05
Studio
Optional: Fügen Sie den Fabrixa Studio-Iframe in Ihre Produktseite ein. Kunden nehmen ihre Anpassungen in Echtzeit vor; diese werden per POST an die Bestellung angehängt.
Ressourcen für Entwickler
Alles, was Ihr Ingenieurteam braucht.
Vollständige API-Referenz
Vollständige Endpoint-Dokumentation, Anfrage-/Antwortschemata, Fehlercodes, Rate Limits, Authentifizierung, Studio-Einbettung und Webhook-Contracts – mit einer Live-Swagger-Schnittstelle.
Dokumente öffnen →Gegen einen Vertriebskanal entwickeln
Richten Sie einen dedizierten Vertriebskanal ein, auf dessen Grundlage Sie weiterarbeiten können – geben Sie Testbestellungen auf, überprüfen Sie die Webhook-Übermittlung und validieren Sie Randfälle –, und leiten Sie anschließend echten Datenverkehr auf Ihren Live-Kanal um. Ihre Schlüssel stehen sofort nach der Erstellung des Kanals bereit – es ist kein Anforderungsschritt erforderlich.
Erstellen Sie Ihr Konto →Postman-Sammlung
Vorkonfigurierte Sammlung von Anfragen mit Beispiel-Payloads und Authentifizierung. Importieren Sie diese in Ihren Test-Workflow.
Holen Sie sich die Sammlung →
SECURITY
Zwei-Header-Authentifizierung. Signierte Webhooks. Rate-limited.
Bewährte Vorgehensweisen, keine Überraschungen. Jede Anfrage wird sowohl mit einem Bearer-Token als auch mit einem Application Key authentifiziert. Jeder Webhook wird zur Überprüfung HMAC-signiert, wobei pro Anwendung vorhersehbare Rate Limits gelten.
Application Access Token
Bearer-Token im Authorization-Header. Identifiziert die aufrufende Anwendung.
Application Key
Wird im Header „X-Application-Key“ übermittelt. Beide Angaben sind bei jeder Anfrage erforderlich – fehlt eine davon, wird der Status 401 zurückgegeben.
TLS-Verschlüsselung
HTTPS-only auf api.fabrixa.com. Anfragen im Klartext werden am Edge abgewiesen.
Webhook-Signaturen
Jeder Webhook wird mit HMAC-SHA256 signiert und im Header „x-webhook-signature“ übermittelt. Bitte überprüfen Sie dies vor der Verarbeitung.
Rate limits
30 Anfragen pro Anwendung und Minute. Die Werte „X-RateLimit-Limit“ und „X-RateLimit-Remaining“ werden bei jeder Antwort zurückgegeben.
Webhook-Retries
Bis zu 10 Zustellversuche bei einer Antwort, die nicht im 2xx- oder 3xx-Bereich liegt. Nach dem 10. Fehlversuch wird der Webhook deaktiviert.
FAQ
Die Integration API, beantwortet
Wie kann ich mich bei Fabrixa und API authentifizieren?
Jede Anfrage benötigt zwei Header: ein Application Access Token, das als „Bearer“-Token im „Authorization“-Header gesendet wird, und einen Application Key im „X-Application-Key“-Header. Beide werden beim Anlegen eines Vertriebskanals im Fabrixa-Dashboard generiert. Fehlt einer der beiden Header, wird die Anfrage mit dem Statuscode 401 abgelehnt.
Kann ich die Funktionen „Fabrixa“ und „API“ testen, bevor ich echte Aufträge erteile?
Ja – richten Sie einen eigenen Vertriebskanal ein, auf dessen Grundlage Sie weiterentwickeln können, geben Sie Testbestellungen auf, überprüfen Sie die Zustellung der Webhooks und validieren Sie Randfälle. Sobald alles funktioniert, leiten Sie dann den echten Datenverkehr auf Ihren Live-Kanal um. Durch die Registrierung und Einrichtung dieses Kanals stehen Ihnen Ihr Application Access Token und Ihr Application Key sofort zur Verfügung, ohne dass ein separater Anforderungsschritt erforderlich ist.
Ist die Fabrixa-Integration API mit HTTPS verschlüsselt?
Ja – der API unterstützt auf api.fabrixa.com ausschließlich HTTPS, und jede Anfrage im Klartext wird am Edge abgelehnt. Jede Anfrage wird zudem sowohl mit einem Bearer-Token als auch mit einem Application Key authentifiziert, und jede Webhook-Nutzlast wird mit HMAC-SHA256 signiert, sodass sie vor der Verarbeitung überprüft werden kann.
Was gibt ein POST-Aufruf an /v2/integration/orders zurück?
Ein authentifizierter POST-Aufruf an /v2/integration/orders validiert die Payloads, reserviert einen Platz in der Produktionswarteschlange und gibt innerhalb von Millisekunden eine Bestätigung mit der Fabrixa-Auftrags-ID zurück, zusammen mit optionalen Feldern für Versandetikett und Sendungsverfolgung. Die Fulfilment kann dann pro Einzelposten nachverfolgt oder über Webhooks an Sie weitergeleitet werden.
Benötige ich ein SDK oder einen Proxy für die Integration mit Fabrixa und API?
Nein – Die Integration von fabrixa erfolgt über eine direkte REST-Verbindung über Standard-HTTP, ohne dass ein SDK, ein Proxy-Server oder ein Connector eines Drittanbieters erforderlich ist. Sie rufen fabrixa direkt aus Ihrem eigenen Stack heraus mithilfe von JSON-Anfragen und -Antworten auf, wobei Webhooks für Statusänderungen zum Einsatz kommen.
Mit dem Bauen beginnen
Erstellen Sie einen Vertriebskanal und legen Sie noch heute los.
Registrieren Sie sich, richten Sie einen Vertriebskanal ein – und schon stehen Ihnen Ihre API-Zugangsdaten zur Verfügung. Benötigen Sie Unterstützung? Unsere Solutions Engineers melden sich innerhalb von 24 Stunden bei Ihnen – die meisten Teams sind innerhalb von zwei Wochen einsatzbereit.