Idempotence
Les nouvelles tentatives sont sûres lorsque vous indiquez de quelle demande il s'agit.
Envoyez Idempotency-Key (8 à 128 caractères : lettres, chiffres, _ - . :) avec un POST qui crée quelque chose. Le premier appel réclame la clé et conserve sa réponse pendant 24 heures. Une répétition avec la même clé et le même corps rejoue la réponse conservée avec Idempotent-Replayed: true et le même statut. Une répétition avec un autre corps répond 409 IDEMPOTENCY_KEY_REUSED. Une répétition pendant que le premier appel est encore en cours répond 409 IDEMPOTENCY_KEY_IN_PROGRESS; une réclamation dont l'appelant a disparu peut être reprise après une minute. Les clés sont propres à l'espace de travail et à l'environnement.
curl https://api.taxpio.com/v1/tax/calculations \
-H "Authorization: Bearer tp_test_…" \
-H "Idempotency-Key: order-8812-t1" \
-H "Content-Type: application/json" \
-d '{"jurisdiction":"CA","program":"T1","tax_year":2026,"inputs":{…}}'