Aller au contenu
CargoDuo logoCargoDuo
Tarifs
Se connecter
Contact
Documentation développeursPremiers pas

Idempotence

Réessayez POST /v1/pack sans créer une deuxième tâche.

Envoyez un en-tête Idempotency-Key avec POST /v1/pack (ou POST /v1/projects/{id}/pack). Réessayez avec la même clé : vous obtenez la même tâche, facturée une seule fois.

Bash
curl -X POST https://runner.cargoduo.com/v1/pack \
  -H "Authorization: Bearer $CARGODUO_API_KEY" \
  -H "Idempotency-Key: order-1042-v1" \
  -H "Content-Type: application/json" \
  -d @request.json
RègleDétail
Fenêtre24 heures, par organisation
CléToute chaîne de 128 caractères au plus : un UUID ou votre numéro de commande
RejeuLa tâche d'origine, avec Idempotent-Replayed: true. 200 si elle est terminée, 202 sinon
Trop longue400 idempotency_key_invalid

Une clé par requête logique. Un corps modifié nécessite une nouvelle clé.

Voir aussi

Créer une tâche de chargementValide la requête, réserve sur vos crédits le prix maximal possible et met une tâche en file d'attente.ErreursUn format d'erreur unique, des codes stables, des règles claires pour réessayer.