Mit dem Print-on-Demand-Dienst „Fabrixa“ von API kann jede POD-Plattform oder jeder Online-Shop eine Bestellung aufgeben und deren Lebenszyklus verfolgen, indem sie order.created und order.updated Webhooks – und lassen Sie es von Fabrixa als White-Label-Produkt bedrucken, verpacken und versenden – schon ab einem Stück, EU-weit. Sie gestalten das Einkaufserlebnis; wir übernehmen die bedarfsgerechte Textilproduktion im Hintergrund. Keine Mindestbestellmenge, keine Einrichtungsgebühren, kein Fabrixa-Logo 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, finden Sie die vollständige API-Dokumentation und Schritt für Schritt Integrationsleitfaden sind bereit, wenn du es bist.
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 beauftragen API mit der Fulfilment. 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.
- Erfüllungen — 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 individuelles Design bei in Fabrixa Studio (unseren einbettbaren White-Label-Produktkonfigurator) zu einer Bestellung anhand ihrer
Warenkorb-Artikel-Schlüssel, 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 Überschriften:
| Kopfzeile | Zweck |
|---|---|
Autorisierung: Inhaber |
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: Reagiere 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 ein Auftrag in die Produktion übernommen wird. Verwenden Sie diese Funktion, um dem Verkäufer den Eingang zu bestätigen und den Auftrag als in Bearbeitung zu kennzeichnen.
- order.updated — wird ausgelöst, wenn der Auftrag die Produktions- und Versandphasen durchläuft, einschließlich der Nachverfolgung. Nutzen Sie dense Funktion, um den Status Ihrer Plattform synchron zu halten, ohne Ihr Ratenlimit zu überschreiten.
Zwischen zwei Ereignissen und einer Obergrenze von 30 pro Minute stößt eine ordnungsgemäß durchgeführte Integration kaum an die Grenze: Erst den Befehl 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-Tabelle, 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 Lieferzeit: 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 Sie möchten, dass Käufer ein Produkt in Ihrem Shop individuell gestalten können, und Sie dieses Design der Bestellung hinzufügen, indem Sie Warenkorb-Artikel-Schlüssel.
Wie authentifiziere ich Anfragen?
Bei jedem Aufruf zwei Header senden: Autorisierung: Inhaber und X-Application-Key:. Beide sind gemeinsam erforderlich – das eine ohne das andere wird abgelehnt.
Was passiert, wenn ich das Ratenlimit 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 bleibst du immer auf dem Laufenden, ohne Anfragen zu verbrauchen.
Handelt es sich bei der Fulfilment wirklich um ein White-Label-Angebot?
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 volle API-Dokumentation. Wenn Sie lieber erst einmal sehen möchten, wie das Ganze zusammenpasst, dann die Plattformübersicht führt 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 gerne Ihren Anwendungsfall mit Ihnen durch.
