Réessayer sans risque

Certains appels ne doivent pas s’exécuter deux fois, comme l’achat d’un bloc d’exécutions ou l’effacement d’un appareil. Ils acceptent un en-tête Idempotency-Key, et leur entrée dans la référence de l’API le précise. Choisissez une valeur unique pour chaque changement que vous voulez faire. Un UUID convient bien. Envoyez la même valeur quand vous réessayez :

curl -X POST https://app.stockshift.io/api/v1/integrations/connections/01J8QZ4M.../channel/stock/push \
  -H "Authorization: Bearer $STOCKSHIFT_TOKEN" \
  -H "Idempotency-Key: 0199f2d4-6b1e-7c3a-9a51-2f0e8c1d4b7a"

Une répétition dans les 24 heures reçoit la première réponse sans que le changement se produise à nouveau : réessayer après l’expiration du délai est donc sans risque. Envoyer une clé déjà utilisée pour un autre appel donne une réponse 422 avec idempotency_key_reused.

Comment les SDK réessaient

Les SDK réessaient un 429 après Retry-After pour toutes les méthodes, car l’API n’a pas exécuté l’appel. Ils réessaient un 5xx ou une défaillance réseau pour GET, PUT et DELETE. Un POST ou un PATCH n’est réessayé que si vous lui donnez une clé d’idempotence :

await stockshift.post("/integrations/connections/{connection}/channel/stock/push", {
  path: { connection: connectionId },
  idempotencyKey: crypto.randomUUID(),
});

Pour commencer

Utiliser l'API

Événements et applications

Comment les SDK réessaient

​Comment les SDK réessaient

Comment les SDK réessaient