系统集成

重试时避免重复短信

实施场景 · 这是实施示例，并非真实客户的成功故事。效果取决于您的集成、手机、网络和运营商。

AI 生成的场景示意照片

需要解决的问题

网络可能在任务创建后、响应返回前中断。普通请求重试可能创建第二条短信。

每个业务事件使用固定 Idempotency-Key。重试时保持设备、号码、文本与 metadata 相同。将键保存在后端事件中，不要每次尝试生成新键。

测试并发调用和响应超时。已有键下修改内容应作为冲突处理，新的业务事件则需要新键。

您的后端通过 API 创建任务，已连接的 Android 使用 SIM 卡发送短信。请在系统中保存消息 ID，并通过 webhook 接收状态变化。排队并不等于已发送：手机必须在线，运营商也必须接受消息。

首先使用您自己的测试号码。检查 Android 权限、息屏连接、使用相同 Idempotency-Key 的重试以及未知状态处理。不要将 API 密钥放入浏览器代码或公开仓库。