Idempotency

Tous les POST acceptent un header Idempotency-Key pour éviter les doublons en cas de retry réseau.

Principe

curl -X POST https://api.asap.cool/v1/contacts \
  -H "Authorization: Bearer asap_pk_live_..." \
  -H "Idempotency-Key: 3f9c1b2a-7d4e-4a1c-9b8e-2f6a0c5d1e7b" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme SAS", "email": "[email protected]" }'

• Utilisez un UUID unique par opération logique (pas par tentative réseau).
• La réponse complète est mémorisée 24 h, associée à la clé.
• Un second appel avec la même Idempotency-Key renvoie la réponse mémorisée (même status), sans recréer la ressource.

Conflit

Si vous rejouez la même Idempotency-Key avec un corps différent, l’API renvoie 409 conflict : la clé est déjà liée à une autre charge utile.

Recommandations

• Générez la clé avant d’envoyer la requête, et conservez-la pour le retry.
• Utilisez l’idempotency sur toute création sensible (facture, contact) où un doublon aurait un impact métier.