Search docs

Search the TryOnCloud API docs

Anleitungen

API-Änderungsprotokoll

Alle Änderungen an der Entwickler-API, beginnend mit den neuesten.

Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.

Ä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
  • 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
  • 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
  • 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
  • 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
  • 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
  • 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.
  • 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
  • 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
  • Neu: GET /api/v1/credits, um die verbleibenden Testzugriffe mit Ihrem API-Schlüssel zu überprüfen. Dokumentation
  • Neu: MCP-Server unter https://www.tryoncloud.com/api/mcp für Claude Code, Cursor und VS Code. Dokumentation
  • Neu: JavaScript/TypeScript-SDK. Dokumentation
  • Neu: Kostenloser Testmodus, ?mock=true oder X-Mock: true. Dokumentation
  • Neu: DELETE /api/v1/results/:id, um ein gespeichertes Ergebnis vorzeitig zu löschen. Dokumentation
  • 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 sowie eine Weiterverkaufsgenehmigung in den Nutzungsbedingungen.

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.