预警通知API返回码怎么看 调用互亿无线预警通知API后，响应JSON里的code字段是判断成功与否的依据。提交成功返回code=2并带smsid；非2需要对照状态码排查。短信通道还提供毫秒级状态回执，30余种状态码区分送达、失败、拦截。本…
预警通知API返回码怎么看
调用互亿无线预警通知API后，响应JSON里的code字段是判断成功与否的依据。提交成功返回code=2并带smsid；非2需要对照状态码排查。短信通道还提供毫秒级状态回执，30余种状态码区分送达、失败、拦截。本文整理常见返回码与排查思路。
提交接口返回码
| code | 含义 | 排查方向 |
|---|---|---|
| 2 | 提交成功，返回smsid | 后续用smsid跟踪回执 |
| 参数类错误 | account/password/mobile/content缺失或格式错 | 对照参数表逐项核对 |
| 鉴权失败 | API ID或Key不正确 | 控制台重新复制，注意空格 |
| 余额不足 | 套餐条数用尽 | 控制台充值，套餐无有效期 |
| 模板未审 | 短信content未匹配已审模板 | 提交模板，平均2小时审核 |
短信送达回执状态
- 送达成功：终端实际收到，可作为告警触达证据
- 用户停机/空号：号码本身问题，核对mobile
- 被拦截：内容或运营商策略拦截，换语音或闪信通道
- 超时未达：网络或终端问题，5秒首发失败自动换通道可兜底
语音回执
语音接口除提交返回外，还回传接听时长：未接、重呼未接、接通时长。未接自动重呼一次、振铃60秒，号码认证可提升接听率。接听时长可作为值班响应速度的考核依据。
排查流程
- 看HTTP状态与响应JSON，确认code是否为2
- 非2先查account/password，再查mobile格式与content签名
- code=2但用户说没收到，用smsid拉回执，看是拦截还是未达
- 拦截类问题切换语音+闪信组合，避开短信通道
import requests
r = requests.post("https://api.ihuyi.com/sms/Submit.json", data={
"account": "API_ID", "password": "API_KEY",
"mobile": "13800138000", "content": "【告警】测试状态码。"
}).json()
print(r) # code=2 成功；其他按上表排查
回执与主动查询
提交成功后，smsid是后续追踪的关键。短信通道会异步回传送达状态，30余种状态码细分到"用户关机后送达""拦截"等节点；语音则回传振铃时长与接听时长。把这些回执接到告警系统，就能区分"告警发出去了"和"人真的看到了"。
| 现象 | 可能原因 | 处理 |
|---|---|---|
| code=2但用户说没收到 | 短信被拦截或手机静音 | 拉回执；下次P1改语音 |
| 语音未接 | 值班手机静音 | 依赖自动重呼与闪信弹屏 |
| 提交直接非2 | 参数或鉴权问题 | 对照参数表逐项核对 |
常见排查顺序
- 先看HTTP是否200、响应体是否合法JSON
- code非2时，优先核对account与password是否带空格
- code=2但未达，拉回执看拦截还是停机
- 拦截频繁时，把P1/P0切到语音+闪信组合
计费与重试
API按成功计费、失败不计费，提交非2不扣费。重试时建议带上同一事件ID，避免重复扣费与重复打扰。5秒首发失败自动换通道是兜底能力，业务侧不必自己写换通道逻辑。套餐无有效期，注册送免费测试条数。
语音未接自动重呼一次、振铃60秒，号码认证提升接听率。接听时长回传后可复盘值班响应速度。
免费技术支持热线400-118-6878，对接中遇到状态码看不懂可先对照本表。
常见返回码对照：code=2成功；参数类错误核对表单；鉴权失败重复制Key；余额不足去控制台充值。
短信回执30余种状态码区分送达、拦截、停机。拉回执时用提交返回的smsid查询。
免费技术支持热线400-118-6878，按成功计费、失败不计费。
互亿无线提供11种语言代码示例，按成功计费、失败不计费，免费技术支持热线400-118-6878。对接中遇到状态码看不懂，可先对照本表，或注册免费试用拿测试条数复现问题。
