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. Erstellen Sie die Sammlung für einen Vertriebskanal und fügen Sie bei der Veröffentlichung 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
Siehe 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.
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.