幂等与限流

幂等键 Idempotency-Key

发送短信接口必须在请求头中携带 Idempotency-Key：

• 相同幂等键重复提交，返回同一个批次，不会重复发送、不会重复扣费。
• 幂等键按应用隔离，不同应用之间不会互相命中。
• 同一个幂等键不能用于内容不同的请求。
• 网络超时或收到「服务暂时异常」时，保持幂等键不变重试即可。

请求签名与防重放

• 请求使用 AppId + HMAC-SHA256 签名，请求时间戳与服务器时间相差不能超过 ±300 秒，请校准服务器时间。
• 每次请求都要生成新的随机串（Nonce），重复的 Nonce 会被拒绝。

频率限制

超过限制返回 HTTP 429，请降低频率后重试。同一来源 IP 鉴权失败过多时也会被临时限制。

签名算法与完整的错误码请查看开发文档。