冪等請求

網路可能會失敗。如果發送請求超時，您無法知道它是否已被接受。請使用 Idempotency-Key 標頭髮送 POST /v1/messages 和 POST /v1/batches，並使用相同的金鑰重試。

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

規則

• 金鑰可以是任何最多 255 個字元的字串。請使用能命名事件的內容：訂單 ID 和步驟，或在第一次嘗試前生成的 UUID。
• 已接受的請求 (202) 會為每個帳戶記住 24 小時。相同的金鑰和相同的請求體會再次返回第一個回應，並帶有標頭 Idempotent-Replayed: true，且不會發送任何內容。
• 相同的金鑰但不同的請求體會回應 409 idempotency_conflict。
• 因錯誤而失敗的請求不會被記住，因此您可以修正它們並使用相同的金鑰重試。