参考

幂等请求

网络可能失败。如果发送请求超时，你无法知道它是否被接受。使用 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。
因错误而失败的请求不会被记住，因此你可以修复它们并使用相同的密钥重试。

上一步速率限制下一步代码示例