Request idempoten

Jaringan bisa gagal. Jika request timeout, Anda tidak tahu apakah diterima. Kirim POST /v1/messages dan POST /v1/batches dengan header Idempotency-Key, dan coba lagi 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."}'

Aturan

• Kunci bisa berupa string hingga 255 karakter. Gunakan yang menamai event: ID pesanan dan langkah, atau UUID yang dibuat sebelum percobaan pertama.
• Request yang diterima (202) diingat selama 24 jam per akun. Kunci yang sama dengan body yang sama mengembalikan jawaban pertama lagi, dengan header Idempotent-Replayed: true, tanpa mengirim apa pun.
• Kunci yang sama dengan body berbeda menjawab 409 idempotency_conflict.
• Request yang gagal dengan error tidak diingat, sehingga Anda bisa memperbaikinya dan mencoba lagi dengan kunci yang sama.