Idempotenz
Nach Timeouts sicher wiederholen, ohne doppelte Generierung oder Kosten.
createTask und retry unterstützen den Header Idempotency-Key. Bei createTask ist er an die logische Kontoanfrage gebunden, bei retry an Quell-Task und Wiederholungsaktion. So entstehen weder doppelte Generierungen noch doppelte Abrechnungen.
POST /api/v1/jobs/createTask
Idempotency-Key: order-8814-render-1
POST /api/v1/jobs/retry
Idempotency-Key: retry-order-8814-124-Stunden-Fenster
Ein Schlüssel gilt 24 Stunden. Erstellen Sie einen je logischer Anforderung und verwenden Sie ihn bei jedem Wiederholungsversuch einschließlich Netzwerk-Timeouts erneut. Die maximale Länge beträgt 128 Zeichen.
Schlüssel bindet die Anfrage
Der Fingerprint umfasst model, kanonisches input, callBackUrl. Derselbe Schlüssel mit anderem payload liefert HTTP 409. Abweichende JSON-Schlüsselreihenfolge oder Leerzeichen gelten als identisch.
Gleichzeitige Übermittlung
Treffen zwei Anfragen gleichzeitig ein, erzeugt ein Datenbank-Unique-Constraint genau einen Task. Bei einem seltenen 409-Rennen warten Sie einige hundert Millisekunden und senden denselben Schlüssel erneut. Den aktuellen Stand lesen Sie über recordInfo mit dem taskId.
Die vollständigen Felddefinitionen stehen im OpenAPI-3.1-Vertrag.