Mit KI-Agenten arbeiten

Wenn dein Team mit einem Coding-Agenten wie Claude Code oder Codex arbeitet, kann der Agent die Händler-API selbst verstehen und Integrationen bauen. Dafür gibt es drei maschinenlesbare Quellen, die ohne Schlüssel erreichbar sind.

Maschinenlesbare Quellen

Quelle	Adresse	Wofür
OpenAPI-Spec	`https://gateway.shirtee.cloud/public/merchant-api/openapi.json`	Vollständiger Vertrag: alle Operationen, Parameter, Beispiele, Antwortcodes und die nötigen Scopes (`x-customer-scopes`). Beste Quelle, um einen Client zu erzeugen.
`llms.txt`	`/llms.txt`	Kurzer Index dieser Dokumentation mit Links, gedacht für Sprachmodelle.
`llms-full.txt`	`/llms-full.txt`	Alle Anleitungen in einer Markdown-Datei. Passt in den Kontext eines Agenten.

Ein Anweisungs-Snippet für dein Repo

Lege diesen Abschnitt in die Projektanweisungen deines Agenten (AGENTS.md bei Codex, CLAUDE.md bei Claude Code):

## Shirtee Händler-API

- Spec: https://gateway.shirtee.cloud/public/merchant-api/openapi.json
- Konzepte: https://developers.shirtee.cloud/llms-full.txt
- Basis-Adresse: https://gateway.shirtee.cloud, Anmeldung per `Authorization: Bearer $SHIRTEE_API_KEY`.
- Das Token steht nur in der Umgebungsvariable. Es nie in Code, Logs, Tests oder Ausgaben schreiben.
- Es gibt keine Sandbox. Schreibende Aufrufe gehen live. Vor Änderungen die `.../preview`-Endpunkte nutzen
  und echte Bestellungen nur nach ausdrücklicher Freigabe anlegen.
- `POST /api/orders` immer mit `Idempotency-Key` senden und nur mit demselben Key wiederholen.
- Fehler nach `extra.error` auswerten, nicht nach `detail`. Nur `429` und `5xx` wiederholen,
  bei `429` mindestens `RateLimit-Reset` Sekunden warten.
- Unbekannte Felder in Antworten ignorieren.

Sicher arbeiten lassen

Ein Agent handelt schnell und in Schleifen. Das braucht Leitplanken:

Eigener Schlüssel pro Agent, mit den kleinsten nötigen Scopes. Zum Entwickeln genügen oft merchant_order:read und merchant_catalog:read. Schreibrechte erst, wenn du sie brauchst, siehe Scopes.
Kurze Gültigkeit. Ein Schlüssel für eine Entwicklungsphase darf nach Tagen ablaufen, siehe API-Schlüssel.
Keine Sandbox. Lass den Agenten Tests gegen die Vorschau-Endpunkte und gegen Lese-Operationen schreiben. Die Anlage echter Bestellungen bleibt eine bewusste Handlung.
Mengenbegrenzung beachten. Eine Agenten-Schleife erreicht schnell das Budget, siehe Mengenbegrenzung.
Token nie im Chat. Gib ihn per Umgebungsvariable, nicht im Gesprächsverlauf.

Und Chat-Assistenten?

Für Assistenten wie Claude oder ChatGPT, die Aufgaben in deinem Konto erledigen sollen, richtest du im Portal unter KI-Assistent & API eine eigene Verbindung ein. Sie läuft nicht über gateway.shirtee.cloud, siehe Überblick.