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.
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.