理解提交响应、发送记录与回执的关系,减少业务系统对发送状态的误判。
一次请求成功,并不等于最终送达
HTTP 请求完成说明接口有响应,业务返回结果说明本次提交的处理情况。短信还需要经过后续发送环节,因此不能直接把 HTTP 成功视为用户已收到。应先依据当前接口文档解析返回结果。
为每条消息保留可追踪的记录
记录业务编号、请求时间、目标号码和返回流水号,有助于把短信和订单、账户操作关联。日志应保护号码等个人信息,不记录明文密钥。查询问题时,流水号通常比仅凭一段文案更容易定位。
回执处理要考虑重复与延迟
回执可能与业务操作不是同时到达。处理时应根据业务需要做幂等更新,避免重复回调引发多次业务动作。实际字段和状态码以开通文档为准,不同产品的返回结构不要混用。
遇到超时,先核查再决定是否重试
请求超时只代表客户端没有及时获得结果,不足以证明平台未受理。先结合记录确认状态,再按约定策略决定补发。用户反映未收到时,可以从号码格式、内容、发送记录和回执逐项排查。