Requêtes idempotentes

Les réseaux échouent. Si une requête d'envoi expire, vous ne pouvez pas savoir si elle a été acceptée. Envoyez POST /v1/messages et POST /v1/batches avec un en-tête Idempotency-Key, et réessayez avec la même clé.

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-55102-shipped" \
  -d '{"to": "+14155550123", "text": "Order 55102 has shipped."}'

Règles

• Une clé est toute chaîne jusqu'à 255 caractères. Utilisez quelque chose qui nomme l'événement : un id de commande et étape, ou un UUID créé avant le premier essai.
• Une requête acceptée (202) est mémorisée pendant 24 heures par compte. La même clé avec le même corps renvoie la première réponse à nouveau, avec l'en-tête Idempotent-Replayed: true, et n'envoie rien.
• La même clé avec un corps différent répond 409 idempotency_conflict.
• Les requêtes qui échouent avec une erreur ne sont pas mémorisées, vous pouvez donc les corriger et réessayer avec la même clé.