Idempotence
Les POST de création métier exigent le header :
Idempotency-Key: <clé unique côté client>
Règles
| Règle | Détail |
|---|---|
| Obligatoire | Sur les créations (ex. POST /v1/notorieties) |
| Longueur max | 256 caractères |
| Scope | Par clé API |
| Rejeu | Même clé → même ressource (200 au lieu de 201) |
Bonnes pratiques
- Générez une clé par intention métier (ex. UUID lié à votre
case_idCRM). - Ne réutilisez pas une clé pour un body différent.
- Conservez la clé si vous retentez après timeout réseau.
curl -sS https://naas.allaw.fr/v1/notorieties \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: crm-case-42-notoriety" \
-d '{"data":{"requester":{"fullName":"Marie Dupont","capacity":"heir","email":"[email protected]"}}}'