# API-Änderungsprotokoll

Änderungen an der Entwickler-API, beginnend mit den neuesten. Bestehende Anfrage- und Antwortformate werden hier ohne vorherige Ankündigung nicht geändert; neue Felder und Endpunkte werden zusätzlich hinzugefügt.

## 19. November 2026

- **Neu:** Asynchrone Testausführungen: `POST /api/v1/generations` gibt sofort einen Auftrag zurück; dieser kann unter `GET /api/v1/generations/:id` abgerufen werden. [Dokumentation](/docs/async)
- **Neu:** Stapel von bis zu 500 Anproben anhand von Bild-URLs: `POST /api/v1/batches`, `GET` und `DELETE /api/v1/batches/:id` (stornierte Artikel werden erstattet). [Dokumentation](/docs/async#batches)
- **Neu:** Signierte Webhooks `generation.completed`, `generation.failed` und `batch.completed`, pro Anfrage (`webhook_url`) oder als Konto-Endpunkt mit Ereignisauswahl und einem Testereignis unter **API-Schlüssel > Webhooks**. [Dokumentation](/docs/async#webhooks)
- **Neu:** Mit `GET /api/v1/results/:id` können Sie ein gespeichertes Ergebnis mit Ihrem Schlüssel abrufen. Asynchrone Ergebnisse werden 7 Tage lang aufbewahrt.
- **Neu:** `DELETE /api/v1/customers/:customer_id` löscht die gespeicherten Ergebnisse und Datensätze eines Endnutzers. `customer_id` wird bei `/generate`, `/generations` und Batch-Elementen akzeptiert. [Dokumentation](/docs/async#delete-a-customers-data)
- **Neu:** Monatliches Guthabenlimit und Ablaufdatum pro Schlüssel, die bei der Erstellung des Schlüssels festgelegt werden. Überschreitung des Limits: `402 KEY_LIMIT_REACHED`. [Dokumentation](/docs/limits)
- **Neu:** Testmodus (`?mock=true`) für asynchrone Aufträge und Stapelverarbeitungen (bis zu 10 Elemente), kostenlos.
- **Schneller:** Die Kleideranalyse wird 30 Tage lang zwischengespeichert, sodass bei wiederholten Anproben desselben Produktfotos etwa 2 Sekunden eingespart werden.
- **Dashboard:** Suche nach Generationen anhand der Kunden-ID oder der Anfrage-ID, Zeitraumsfilter, Live-Ansicht und CSV-Export. Die Übersicht zeigt den Median und die p95-Zeit sowie die Kreditlaufzeit an.
- **Sicherheit:** Webhooks werden ausschließlich an öffentliche Adressen gesendet, die zum Zeitpunkt der Verbindung überprüft werden; es wird niemals Umleitungen gefolgt.

## 18. November 2026

- **Neu:** `Idempotency-Key`-Header bei `POST /api/v1/generate`; Wiederholungsversuche werden niemals doppelt abgerechnet. [Dokumentation](/docs/generate#retries-and-idempotency)
- **Neu:** `X-Request-Id` in jeder Antwort (und `request_id` in Fehlertexten) sowie `X-RateLimit-Limit` und `X-RateLimit-Remaining`.
- **Neu:** OpenAPI 3.1-Spezifikation unter `https://www.tryoncloud.com/api/v1/openapi.json`.
- **Neu:** Zahlen zum öffentlichen Dienst unter `GET /api/v1/status` und auf der [Statusseite](/status).
- **Dokumente:** Angegebene Ausgabeauflösung: ca. 1 Megapixel (1K-Klasse).

## 14. November 2026

- **Neu:** Webhook-Header `x-tryoncloud-signature-v2`, der den Zeitstempel zusammen mit dem Body signiert, sodass alte Zustellungen abgelehnt werden können. `x-tryoncloud-signature` bleibt unverändert. [Dokumentation](/docs/webhook)
- **Geändert:** Die Ratenbegrenzungen gelten nun für alle Server, mit einer kontoweiten Obergrenze von 600 Generierungsanfragen pro Minute und einer separaten Obergrenze für den Testmodus. [Dokumentation](/docs/limits)
- **Neu:** `GET /api/v1/credits`, um die verbleibenden Testzugriffe mit Ihrem API-Schlüssel zu überprüfen. [Dokumentation](/docs/credits)
- **Neu:** MCP-Server unter `https://www.tryoncloud.com/api/mcp` für Claude Code, Cursor und VS Code. [Dokumentation](/docs/mcp)
- **Neu:** JavaScript/TypeScript-SDK. [Dokumentation](/docs/sdk)
- **Neu:** Kostenloser Testmodus, `?mock=true` oder `X-Mock: true`. [Dokumentation](/docs/generate)
- **Neu:** `DELETE /api/v1/results/:id`, um ein gespeichertes Ergebnis vorzeitig zu löschen. [Dokumentation](/docs/delete-result)
- **Geändert:** Der Preis für Unternehmenskunden (ab 5.000 Testanproben) wurde von 0,08 $ auf 0,07 $ gesenkt. In Indien bleibt der Preis bei 6,50 ₹.
- **Geändert:** Downloads von `garment_url` werden nun bei jeder Weiterleitung und zum Zeitpunkt der Verbindungsherstellung überprüft; interne, private und Cloud-Metadaten-Adressen werden abgelehnt.
- **Dokumente:** Neue mehrseitige Dokumente mit Markdown-Versionen aller Seiten, eine [Datenverarbeitungsvereinbarung](/dpa) sowie eine Weiterverkaufsgenehmigung in den [Nutzungsbedingungen](/terms#developer-api).

## 12. November 2026

- **Geändert:** Neue Preise für jede Größenstufe: ab 50 Stück 0,11 $, ab 300 Stück 0,10 $, ab 1.000 Stück 0,09 $, ab 5.000 Stück 0,08 $.
- **Neu:** Benannte API-Schlüssel, bis zu 5 aktive, Datumsangaben zur letzten Nutzung, einzeln widerrufbar.

## 5. November 2026

- **Geändert:** `POST /generate` gibt immer `image/png` zurück, was dem dokumentierten `Content-Type` entspricht.
