错误处理与排查
结合 HTTP 状态、业务响应和任务详情判断下一步。错误不应统一当成可以直接重发的请求。
常见响应与处理
| 情况 | 建议处理 |
|---|---|
| 400 参数或资源条件错误 | 核对模板、变量、号码模式、审核和余额条件 |
| 401/403 鉴权或权限问题 | 核对凭据状态、时间戳、签名、客户归属和 IP 配置 |
| 幂等冲突 | 相同 client_request_id 不得关联不同发送载荷 |
| 429 限流 | 按返回信息延迟重试，保留原业务 ID |
| 503 服务暂不可用 | 先查询已受理情况，再按相同业务 ID 判断重试 |
| submit_unknown | 核实受理情况；不要直接换 ID 重发 |
任务为什么还在等待回执？
提交和回执异步执行。回执可能延迟、无法匹配、处于离线等待或之后被纠正。使用查询和事件关联核对具体明细，必要时联系团队排查。
文件解析或确认失败
先看 failure_code、错误信息和样例。核对格式、号码列、变量表头、必填变量、有效号码和资金条件。重复上传前确认已有导入任务状态。
申请排查时提供什么？
提供 task_no、client_request_id、相关时间、脱敏请求字段和错误信息。不要在咨询表单或截图中提交 API Secret、密码或完整客户名单。