Réessayer en toute sécurité avec l'API SMS
Vous envoyez des SMS via notre API et vous rencontrez parfois un délai d'attente dépassé ou une erreur réseau ? Vous ne savez alors pas si le message est déjà parti. Si vous réessayez, le destinataire risque de recevoir deux fois le même SMS. Avec le nouveau paramètre idempotency_key de la version 2 de l'API SMS, ce n'est plus possible.
Comment ça marche ?
Lors de l'envoi, transmettez une valeur unique dans idempotency_key, par exemple un UUID, une par message. Si vous renvoyez la même requête avec la même clé dans les 24 heures, nous n'envoyons rien. Vous recevez simplement la réponse d'origine, avec le même msgid, le même uuid et la même date. Dans ce cas, la réponse contient aussi l'en-tête Idempotency-Repeat: true, pour que vous sachiez qu'il s'agit d'une répétition.
Le paramètre est facultatif. Si vous ne le transmettez pas, rien ne change pour votre intégration existante.
Bon à savoir
- Une clé reste valable 24 heures à partir de la première requête. Ensuite, elle est considérée comme nouvelle et le message est envoyé à nouveau.
- Les clés sont propres à chaque compte : un autre client peut utiliser la même valeur sans conflit.
- Si vous utilisez la même clé pour un autre message, avec un autre numéro, un autre texte ou un autre expéditeur, nous refusons la requête avec le code 20.
- Si une répétition arrive alors que la première requête est encore en cours de traitement, vous recevez le code 21. Réessayez alors un peu plus tard.
- Si une requête a été refusée, par exemple faute de crédits suffisants, nous ne conservons pas la clé. Après la recharge, réessayez simplement avec la même clé.
- Une clé peut contenir au maximum 255 caractères. Si elle est plus longue, vous recevez le code 19.
Tous les détails figurent dans la documentation de l'API, à la section sur l'envoi d'un message.
