Idempotent istekler

Ağlar başarısız olabilir. Bir gönderme isteği zaman aşımına uğrarsa, kabul edilip edilmediğini bilemezsiniz. POST /v1/messages ve POST /v1/batches isteklerini bir Idempotency-Key başlığı ile gönderin ve aynı anahtarla yeniden deneyin.

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."}'

Kurallar

• Bir anahtar, 255 karaktere kadar herhangi bir dizedir. Olayı adlandıran bir şey kullanın: bir sipariş kimliği ve adımı veya ilk denemeden önce oluşturulan bir UUID.
• Kabul edilen bir istek (202), hesap başına 24 saat boyunca hatırlanır. Aynı anahtar ve aynı gövde, Idempotent-Replayed: true başlığı ile ilk cevabı tekrar döndürür ve hiçbir şey göndermez.
• Farklı bir gövde ile aynı anahtar, 409 idempotency_conflict cevabını verir.
• Bir hata ile başarısız olan istekler hatırlanmaz, bu yüzden onları düzeltip aynı anahtarla yeniden deneyebilirsiniz.