01
Die Sammlung importieren
In Postman: File → Import → Link. Fügen Sie die JSON-URL aus dem obigen Download-Button ein. Postman fügt die Sammlung – einschließlich ihrer Variablen – Ihrem Arbeitsbereich hinzu.
Entwickler · Postman-Sammlung
Collection importieren. In fünf Minuten an der API.
Eine vorgefertigte Postman-Sammlung mit praktischen Beispielen für die Fabrixa Integration API. Geben Sie einfach Ihre Anmeldedaten ein, klicken Sie sich durch die Anfragen und sehen Sie sich echte Antworten der API an, bevor Sie auch nur eine einzige Zeile Integrationscode schreiben. Versionsübergreifend aktualisiert – die Sammlung wird aktualisiert, sobald die API aktualisiert wird.
Was umfasst die Sammlung?
Jeder Endpoint, mit Beispiel-Payloads.
Nach Ressourcen in Ordnern organisiert. Jede Anfrage enthält einen ausgefüllten Beispieltext, die beiden voreingestellten Authentifizierungs-Header sowie eine gespeicherte Beispielantwort – so können Sie sich vor dem Absenden einen Überblick über die Form der Antwort verschaffen.
Authentifizierung und Produkte
- GET /ping — Anmeldedaten überprüfen
- GET /products – Auflisten und Paginieren (SKU + variant_id)
- Vollständige Feldschemata in der Swagger-Referenz
Bestellungen
- POST /orders – Bestellung erstellen
- GET /orders/{id}/fulfillments — Produktionsverlauf verfolgen
Studio & Webhooks
- GET /v2/studio/customizations/{key}/preview
- Webhook-Payload + HMAC-Überprüfung (Beispiel)
Import in 30 Sekunden
File → Import → Link → URL einfügen.
02
Öffnen Sie die Registerkarte „Variablen“
Die Sammlung verfügt über eigene Variablen — base_url ist bereits ausgefüllt; access_token und application_key sind Platzhalter. Es ist keine separate Umgebungsdatei erforderlich.
03
Fügen Sie Ihre Schlüssel ein
Fügen Sie den Application Access Token und den Application Key eines Vertriebskanals in Ihrem Dashboard ein, klicken Sie auf „Speichern“, und jede Anfrage wird authentifiziert.
Umgebungsvariablen
Was in der env-Datei steht.
Eine Basis-URL, zwei Anmeldedaten, fest in die Sammlung integriert. Entwickeln Sie gegen einen Vertriebskanal und fügen Sie beim Go-live die Schlüssel Ihres Live-Kanals ein – gleiche Sammlung, gleiche Anfragen.
Collection variables
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Auth bereits vorkonfiguriert
Beide Authentifizierungs-Header werden bei jeder Anfrage automatisch gesetzt.
Jede Anfrage beinhaltet Authorization: Bearer {{access_token}} und X-Application-Key: {{application_key}}, die aus den Collection Variables abgerufen werden – keine Header-Konfiguration pro Anfrage. Der Wechsel von einem Vertriebskanal zum anderen erfolgt einfach durch Bearbeiten dieser beiden Variablen: gleiche Sammlung, unterschiedliche Schlüssel.
Praxisbeispiele
Jede Anfrage wird mit einem Mustertext und einer gespeicherten Antwort geliefert.
Die Sammlung besteht nicht nur aus URL-Stubs – jede Anfrage enthält einen ausgearbeiteten Beispieltext, sodass Sie auf „Senden“ klicken und echte Daten sehen können. Gespeicherte Beispielantworten finden Sie im Bereich „Beispiele“, wo Sie sie auch offline einsehen können.
Authentifizierung überprüfen
Stellt zunächst sicher, dass Ihr Application Access Token und Ihr Application Key gültig sind. 200 bei Erfolg, 401, wenn ein Header fehlt.
Produkte auflisten
Anfrage nach einem paginierten Katalog. Gibt die Produkte seitenweise im „links/meta/data“-Umschlag zurück, mit SKU und der Varianten-ID pro Artikel.
Bestellung aufgeben
Beispieltext für eine Bestellung von einem T-Shirt mit einer Quell-PDF-Datei, Kunden- und Lieferadresse. Klicken Sie auf „Senden“, um die erstellte Bestellung mit ihrer Fabrixa-ID anzuzeigen.
Produktion verfolgen
Ruft die einzelnen Produktionsschritte pro Artikel (Drucken, Fixieren, Waschen, Nähen) mit den Status „ausstehend“, „in Bearbeitung“, „fertig“ und „abgelehnt“ für eine aufgegebene Bestellung ab.
Studio-Vorschau
Gibt das gerenderte Vorschaubild einer gespeicherten Studio-Anpassung zurück – fügen Sie es direkt in eine Warenkorb-Miniaturansicht ein.
Signaturprüfung
Ein Beispiel für die Neuberechnung der HMAC-SHA256-Signatur und deren Vergleich mit der „x-webhook-signature“ vor der Verarbeitung.
Versionsverwaltung
Die Sammlung wird aktualisiert, wenn die API aktualisiert wird.
Mit jeder neuen API-Version wird eine aktualisierte Sammlung unter derselben URL bereitgestellt. Führen Sie einen erneuten Import durch, um neue Endpoints und Beispiel-Payloads zu übernehmen – bestehende Anfragen in Ihrer gespeicherten Version funktionieren weiterhin, bis der jeweilige Endpoint tatsächlich veraltet ist.
Feste URL
Die JSON-URL der Sammlung ist dauerhaft gültig. Beim erneuten Import wird die aktuellste Version abgerufen – die URL ändert sich zwischen den einzelnen Veröffentlichungen nicht.
Verweis auf das Changelog
sehen Sie sich die Changelog für die passenden API-Versionshinweise - was wurde verschoben, was wurde hinzugefügt, was ist veraltet.
Deprecation-Policy
Für Endpoints gilt eine 12-monatige Auslaufphase. Die Sammlung kennzeichnet veraltete Anfragen in der Beschreibung, sodass sie kaum zu übersehen sind, bevor es zu Fehlern kommt.
FAQ
Die „Postman“-Sammlung – Antworten
Wie importiere ich die Fabrixa-Postman-Sammlung?
Wählen Sie in Postman „Datei“, dann „Importieren“ und anschließend „Verknüpfen“ aus und fügen Sie die JSON-URL der Sammlung ein. Postman fügt die Sammlung zusammen mit ihren Variablen zu Ihrem Arbeitsbereich hinzu – „base_url“ ist bereits ausgefüllt, während „access_token“ und „application_key“ Platzhalter sind, die Sie durch Ihren eigenen Application Access Token und Application Key ersetzen müssen.
Welche Endpoints sind in der Fabrixa-Postman-Sammlung enthalten?
Die Sammlung umfasst GET /ping zur Überprüfung von Anmeldedaten, GET /products zum Auflisten und Paginieren des Katalogs, POST /orders zum Erstellen einer Bestellung, GET /orders/{id}/fulfillments zur Verfolgung der Produktion, den Studio-Preview-Endpoint sowie ein ausgearbeitetes Beispiel für die Überprüfung von Webhook-Signaturen. Sie wurde für die Integration v2 API entwickelt und erfordert Postman v10 oder höher.
Wie wird die Authentifizierung in der Fabrixa-Postman-Sammlung eingerichtet?
Jede Anfrage in der Sammlung enthält bereits die beiden erforderlichen Header – „Authorization: Bearer {{access_token}}“ und „X-Application-Key: {{application_key}}“ –, die aus den Collection variables übernommen werden. Durch das Einfügen Ihres Application Access Tokens und Ihres Application Keys in diese Variablen wird jede Anfrage auf einmal authentifiziert, ohne dass für jede einzelne Anfrage eine separate Konfiguration erforderlich ist.
Wird die Fabrixa-Postman-Sammlung aktualisiert, wenn sich die API ändert?
Ja – mit jeder API-Version wird eine aktualisierte Sammlung unter derselben permanenten URL bereitgestellt, sodass beim erneuten Import die neuesten Endpoints und Beispiel-Payloads abgerufen werden. Für Endpoints gilt ein 12-monatiges Deprecation-Fenster, und die Sammlung kennzeichnet veraltete Anfragen in ihrer Beschreibung, bevor es zu Funktionsstörungen kommt.
Was gibt die Anfrage „GET /orders/{id}/fulfillments“ zurück?
Sie ruft den Produktionsstatus pro Artikel für einen aufgegebenen Auftrag ab, wobei Schritte wie Drucken, Fixieren, Waschen und Nähen erfasst werden, die jeweils als „ausstehend“, „in Bearbeitung“, „fertig“ oder „abgelehnt“ gemeldet werden. Die Postman-Sammlung enthält ein Beispiel, sodass die Form der Antwort überprüft werden kann, bevor sie in eine Integration eingebunden wird.
Herunterladen & starten
Holen Sie sich die Sammlung. Senden Sie Ihre erste Anfrage.
Importieren Sie die Sammlung, geben Sie Ihre Zugangsdaten für den Vertriebskanal ein und senden Sie innerhalb weniger Minuten Ihre erste Anfrage – Sie benötigen keinen Integrationscode, um loszulegen.