Search docs

Search the TryOnCloud API docs

API-Referenz

Ein Ergebnis löschen

DELETE /api/v1/results/:id: Ein gespeichertes Ergebnis vorzeitig löschen.

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

DELETE https://www.tryoncloud.com/api/v1/results/:id

Löscht ein gespeichertes Ergebnis endgültig, bevor es nach 7 Tagen automatisch gelöscht wird. Um ein gespeichertes Ergebnis herunterzuladen, senden Sie ein GET an dieselbe URL mit Ihrem Schlüssel.

Hinweis: POST /generate speichert nichts, außer die Ergebnisspeicherung ist in Ihrem Konto aktiviert. Asynchrone Aufträge und Batches behalten ihr Ergebnis immer 7 Tage lang, damit Sie es herunterladen können. Um alles zu einem Endnutzer auf einmal zu löschen, verwenden Sie DELETE /customers/:id.

:id ist der X-Result-Id-Header aus der Generierungsantwort oder das Feld result_id eines asynchronen Auftrags. Verwenden Sie ihn, um der Anfrage eines Endnutzers zur Löschung seiner Daten nachzukommen.

Anfrage

bash
curl -X DELETE https://www.tryoncloud.com/api/v1/results/RESULT_ID \
  -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Antworten

HTTPCodeBedeutung
204Gelöscht. Das Bild und der dazugehörige Link funktionieren nicht mehr.
404NOT_FOUNDIn Ihrem Konto ist kein Ergebnis mit dieser ID gespeichert.
401NO_KEY, INVALID_KEYFehlender oder falscher Schlüssel
429RATE_LIMITEDÜber 120 Löschvorgänge pro Minute
500DELETE_FAILEDDer Speicher hat die Löschung nicht bestätigt. Erneut versuchen

Die Ergebnis-ID eines anderen Kontos liefert ebenfalls den Wert 404, sodass IDs nicht abgefragt werden können.