Idempotence

Les requêtes en écriture acceptent un en-tête Idempotency-Key afin qu'une requête relancée ne s'applique jamais deux fois.

curl -X POST https://api.fabhub.app/v1/items \
  -H "X-API-Key: $FABHUB_API_KEY" \
  -H "Idempotency-Key: 0b9c4a2e-2f1d-4c7a-9b3e-2a1f5c8d7e6b" \
  -H "Content-Type: application/json" \
  -d '{"name":"Widget","itemType":"product"}'

Règles

• Générez une clé unique par écriture logique (un UUID convient bien).
• Ne réutilisez la même clé que pour des nouvelles tentatives exactes de cette écriture.
• Ne réutilisez pas une clé entre différentes charges utiles - cela renvoie 409 avec code: "CONFLICT".
• Les clés sont honorées pendant 24 heures.

Où cela s'applique

Idempotency-Key est obligatoire pour toutes les écritures POST et PATCH concernant les articles, commandes, contacts, documents de stock et webhooks. Les opérations DELETE sont naturellement idempotentes et ne nécessitent pas cet en-tête.

Avec le SDK

Le SDK accepte une option idempotencyKey sur chaque méthode d'écriture :

await fabhub.createItem(
  { name: 'Widget', itemType: 'product' },
  { idempotencyKey: crypto.randomUUID() },
);