Mit der Print-on-Demand-API von Fabrixa kann jede POD-Plattform und jeder Online-Shop eine Bestellung senden, deren Lebenszyklus über die Webhooks order.created und order.updated verfolgen und sie von Fabrixa white-label drucken, verpacken und versenden lassen – schon ab einem Stück, EU-weit. Sie gestalten das Einkaufserlebnis; wir betreiben die reaktive Textilproduktion im Hintergrund. Keine Mindestbestellmenge, keine Einrichtungsgebühren, kein Fabrixa-Branding auf dem Paket.
Dieser Beitrag bietet einen leicht verständlichen Überblick über die Integration API (v2) für Entwickler, die Fabrixa als Fulfilment-Layer in Betracht ziehen. Wenn Sie stattdessen lieber die Referenz überfliegen möchten: Die vollständige API-Dokumentation und der Schritt für Schritt Integrationsleitfaden, stehen bereit, wann immer Sie so weit sind.
Wozu dient das API?
Fabrixa ist ein Plattform für reaktiven Textildruck: ein einziges Dashboard für Vertriebskanäle, Designs, Produktion und Versand. Die meisten Kunden stellen über Shopify, WooCommerce oder Fabrixa Studio eine Verbindung her. Die Integration API ist der vierte Weg – entwickelt für POD-Plattformen und Entwickler, die bereits über einen eigenen Online-Shop verfügen und programmatische Kontrolle über das Fulfilment wünschen.
Sie rufen die API auf, um Bestellungen zu senden. Fabrixa übernimmt die Produktion: Reaktivdruck auf Baumwolle und Leinen in Portugal und Spanien, Sublimationsdruck auf Polyester in den Niederlanden. Die Pakete werden unter Ihrem Markennamen und mit Ihrer Rücksendeadresse versandt, ohne dass irgendwo auf der Verpackung ein Hinweis auf Fabrixa zu finden ist. Ihre Kunden erfahren nichts von unserer Existenz, es sei denn, Sie teilen es ihnen mit.
Was der API leistet
- Ping — Ein einfacher Test, um zu überprüfen, ob Ihre Anmeldedaten und die Verbindung funktionieren, bevor Sie echte Daten senden.
- Produkte — Lesen Sie den Katalog, auf dem Sie aufbauen: Bekleidung, Heimtextilien und Stoffe pro Meter, mit den für den Druck verfügbaren Grundmaterialen und Varianten.
- Bestellungen — Eine Bestellung anlegen und deren Status abrufen. Das ist der Kern jeder Integration: Zeilen, Quellen, Kunden- und Versanddaten werden eingegeben; als Ergebnis erhält man eine nachverfolgbare Bestellung.
- Fulfilments — Verfolgen Sie die Produktion und den Versand, sobald Artikel hergestellt und versandt werden, damit Ihre Plattform den Verkäufern den genauen Status anzeigen kann.
- Studio — Fügen Sie ein in Fabrixa Studio (unserem einbettbaren White-Label-Produktkonfigurator) personalisiertes Design über seinen
cart_item_key, sodass genau das gedruckt wird, was der Käufer entworfen hat.
Authentifizierung und Rate Limits
Die Integration API (v2) befindet sich unter der Basis-URL https://api.fabrixa.com/v2/integration. Jede Anfrage enthält zwei Header:
| Aufhängung | Zweck |
|---|---|
Authorization: Bearer |
Ihr API-Token – dient zur Identifizierung und Autorisierung der Anfrage. |
X-Application-Key: |
Ihr Application Key – bildet zusammen mit dem Token ein Paar, daher müssen beide vorhanden sein. |
Die Rate Limit beträgt 30 Anfragen pro Minute. Das reicht für auftragsgesteuerten Traffic aus, bedeutet aber, dass Massenvorgänge zeitlich gestaffelt und nicht in einer engen Schleife ausgeführt werden sollten. Gehen Sie mit der Begrenzung flexibel um, schalten Sie einen Gang zurück, wenn Sie sie erreichen, und nutzen Sie Webhooks (siehe unten) anstelle von Polling.
Webhooks: Reagieren Sie auf den Status, statt ihn abzufragen
Anstatt immer wieder zu fragen “Ist es schon fertig?”, abonnieren Sie Webhooks und lassen Sie sich von Fabrixa benachrichtigen, sobald sich etwas ändert. Die Integration API löst zwei Ereignisse aus:
- order.created — wird ausgelöst, wenn eine Bestellung in die Produktion übernommen wird. Verwenden Sie diese Funktion, um dem Verkäufer den Eingang zu bestätigen und die Bestellung als in Bearbeitung zu kennzeichnen.
- order.updated — wird ausgelöst, wenn die Bestellung die Produktions- und Versandphasen durchläuft, einschließlich der Sendungsverfolgung. Nutzen Sie diese Funktion, um den Status Ihrer Plattform synchron zu halten, ohne Ihr Rate Limit auszureizen.
Zwischen zwei Ereignissen und einer Obergrenze von 30 pro Minute stößt eine ordnungsgemäß durchgeführte Integration kaum an die Grenze: Erst die Bestellung senden, dann auf die Rückmeldung reagieren.
Der Bestellablauf von Anfang bis Ende
Egal, für welche Variante Sie sich entscheiden, die Form ist dieselbe:
- Anbindung — ein Online-Shop (Shopify oder WooCommerce) oder API.
- Design — Gestalten Sie das Design individuell in Fabrixa Studio oder reichen Sie eine druckfertige PDF-Datei ein.
- Bestellung absenden — über die API, mit Produktzeilen, Kunden- und Lieferadresse.
- Wir produzieren und versenden — Fabrixa übernimmt Druck, Verpackung und Versand als White-Label-Dienstleister.
Ein kurzer Hinweis zur Qualität, denn genau das ist der Grund, warum sich Verkäufer für Reaktivfarbstoffe entscheiden: Der Reaktivfarbstoff geht eine kovalente Bindung mit der Zellulose in der Baumwollfaser ein und wird unter Einwirkung von Hitze und Dampf dauerhaft fixiert. Die Farbe wird Teil der Faser – keine Oberflächenschicht, kein Abblättern an Biegestellen –, sodass sich der Stoff wie unbedruckte Baumwolle anfühlt und die Farbe in der Regel über 600 Waschgänge hinweg erhalten bleibt. Als Beispiel für die Durchlaufzeit: Bei in Portugal hergestellter Bekleidung beträgt diese etwa 6–9 Werktage.
Warum Plattformen auf Fabrixa aufbauen
- MOQ 1 — von einem Stück bis zu Zehntausenden. Keine Mindestbestellmenge, keine Einrichtungsgebühren, keine Verträge.
- Standardmäßig als White-Label — auf jedem Paket steht die Marke des Kunden, nicht unsere.
- Kurze Lieferkette in der EU — Produktion in Portugal, Spanien und den Niederlanden, keine Fernverkehrstransporte.
- Echter Reaktivdruck — GOTS-zertifizierte Bio-Baumwolle als Standardgrundlage, zusätzlich OEKO-TEX Standard 100 und Made in Green.
FAQ
Muss ich Fabrixa Studio verwenden, um das API nutzen zu können?
Nein. Studio ist optional. Sie können stattdessen ein druckfertiges PDF mit der Bestellung mitschicken. Studio kommt erst dann zum Einsatz, wenn Käufer ein Produkt in Ihrem Shop individuell gestalten sollen – dieses Design hängen Sie dann per cart_item_key.
Wie authentifiziere ich Anfragen?
Bei jedem Aufruf zwei Header senden: Authorization: Bearer und X-Application-Key: . Beide sind gemeinsam erforderlich – das eine ohne das andere wird abgelehnt.
Was passiert, wenn ich das Rate Limit erreiche?
Die API-Regelung begrenzt die Anzahl der Anfragen auf 30 pro Minute. Wenn Sie diese Grenze überschreiten, warten Sie einen Moment und versuchen Sie es erneut, anstatt den Endpoint ununterbrochen anzufragen. Verwenden Sie für Statusänderungen die order.created und order.updated Webhooks statt Polling – so bleiben Sie immer auf dem Laufenden, ohne Anfragen zu verbrauchen.
Ist das Fulfilment wirklich white-label?
Ja. Die Pakete werden standardmäßig unter Ihrer Marke mit Ihrer Absenderadresse und ohne Fabrixa-Logo versandt. Ihre Endkunden bekommen uns nie zu Gesicht.
Mit dem Bauen beginnen
Der schnellste Weg hinein ist der Integrationsleitfaden,, unterstützt durch die vollständige API-Dokumentation. Wenn Sie lieber erst einmal sehen möchten, wie das Ganze zusammenpasst, führt die Plattformübersicht durch die Bereiche Kanäle, Studio, Produktion und Versand. Und wenn Sie die Eignung für Ihre Plattform auf Herz und Nieren prüfen möchten, Sprechen Sie mit unserem Team — wir gehen Ihren Anwendungsfall gerne mit Ihnen durch.
