Permintaan idempoten

Rangkaian gagal. Jika permintaan untuk menghantar tamat masa, anda tidak dapat mengetahui sama ada ia diterima. Hantar POST /v1/messages dan POST /v1/batches dengan header Idempotency-Key, dan cuba semula dengan kunci yang sama.

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

Peraturan

• Kunci adalah sebarang rentetan sehingga 255 aksara. Gunakan sesuatu yang menamakan acara: id pesanan dan langkah, atau UUID yang dibuat sebelum percubaan pertama.
• Permintaan yang diterima (202) diingati selama 24 jam bagi setiap akaun. Kunci yang sama dengan badan yang sama mengembalikan jawapan pertama sekali lagi, dengan header Idempotent-Replayed: true, dan tidak menghantar apa-apa.
• Kunci yang sama dengan badan yang berbeza menjawab 409 idempotency_conflict.
• Permintaan yang gagal dengan ralat tidak diingati, jadi anda boleh membetulkannya dan mencuba semula dengan kunci yang sama.