Idempotence
Retenter après un timeout sans générer ni facturer deux fois.
createTask et retry acceptent le header Idempotency-Key. La clé est liée à la requête logique du compte pour createTask, et à la tâche source avec l’action de relance pour retry, afin d’éviter toute double génération ou facturation.
POST /api/v1/jobs/createTask
Idempotency-Key: order-8814-render-1
POST /api/v1/jobs/retry
Idempotency-Key: retry-order-8814-1Fenêtre de 24 heures
Une clé reste active 24 heures. Créez-en une par requête logique et réutilisez-la lors de chaque nouvelle tentative, y compris après un délai d’attente réseau. La longueur maximale est de 128 caractères.
La clé engage la requête
L’empreinte comprend model, input canonique, callBackUrl. La même clé avec un autre payload renvoie HTTP 409. Un ordre différent des clés JSON ou des espaces différents restent équivalents.
Soumissions simultanées
Une contrainte unique en base garantit qu’une seule tâche naît lorsque deux requêtes arrivent ensemble. Pour un rare conflit 409, attendez quelques centaines de millisecondes puis renvoyez la même clé. Consultez l’état actuel avec recordInfo et le taskId reçu.
Consultez le contrat OpenAPI 3.1 pour la définition complète des champs.