Häufige Fragen
Gibt es eine Sandbox zum Testen?
Nein. Schreibende Aufrufe wirken im Live-System. Prüfe Änderungen vorher mit den Vorschau-Endpunkten (…/preview), die nichts schreiben und zeigen, was passieren würde.
Wie melde ich mich an der API an?
Du legst im Händlerportal einen API-Schlüssel mit genau den nötigen Berechtigungen an und sendest ihn bei jeder Anfrage als Bearer-Token im Header Authorization. Basis-Adresse ist https://gateway.shirtee.cloud.
Wie vermeide ich doppelte Bestellungen bei Wiederholungen?
Sende bei POST /api/orders den Header Idempotency-Key. Eine Wiederholung mit gleichem Schlüssel und gleichem Inhalt liefert die erste Bestellung zurück. Anderer Inhalt mit gleichem Schlüssel wird mit 422 und IDEMPOTENCY_KEY_REUSED abgewiesen.
Wie viele Anfragen sind erlaubt?
Derzeit 300 Anfragen pro Minute und Schlüssel. Der Wert kann sich ändern. Verlasse dich auf die Header RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset, und warte bei 429 mindestens RateLimit-Reset Sekunden.
Gibt es Webhooks für Statusänderungen?
Nein. Status werden abgefragt. Wie oft und womit, steht im Guide "Status abfragen statt Webhooks".
Wie werte ich Fehler aus?
Werte das Feld extra.error aus, nicht detail. Die Meldungstexte können sich ändern, die Codes bleiben.
Kann ich Lagerartikel und Anlieferungen per API verwalten?
Ja. Du legst Lagerartikel an, kündigst Anlieferungen ans Lager an, liest Versandlisten ein und hängst Dokumente an. Der Ablauf steht im Guide "Anlieferung ins Lager melden".
Lässt sich die API mit KI-Agenten wie Claude Code oder Codex nutzen?
Ja. Es gibt die öffentliche OpenAPI-3.1-Spec, llms.txt und llms-full.txt sowie ein Anweisungs-Snippet für dein Repository. Details im Guide "Mit KI-Agenten arbeiten".