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
| HTTP | Code | Bedeutung |
|---|---|---|
| 204 | Gelöscht. Das Bild und der dazugehörige Link funktionieren nicht mehr. | |
| 404 | NOT_FOUND | In Ihrem Konto ist kein Ergebnis mit dieser ID gespeichert. |
| 401 | NO_KEY, INVALID_KEY | Fehlender oder falscher Schlüssel |
| 429 | RATE_LIMITED | Über 120 Löschvorgänge pro Minute |
| 500 | DELETE_FAILED | Der 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.