预警通知API请求参数详解：account、mobile、content等全解析

预警通知API请求参数全解析

对接互亿无线预警通知API时，参数理解直接决定调试效率。本文把短信、语音、闪信三类接口的请求参数逐一拆开，说明含义、格式、是否必填，以及常见错误。短信与闪信共用文档 https://www.ihuyi.com/doc/msg/sms/api/Submit.html。

通用请求参数

三类接口地址

• 短信提交：https://api.ihuyi.com/sms/Submit.json
• 闪信提交：https://api.ihuyi.com/flash/Submit.json
• 语音提交：https://api.ihuyi.com/voice/vm

content字段的细节

短信content需带签名（如【告警】），模板需先在控制台提交审核，平均2小时通过；长短信按多条计费。语音content即播报文本，TTS合成约70字对应20秒，无需录音，标点会影响停顿。闪信content直接弹屏显示，不进收件箱。

请求与响应示例

curl -X POST "https://api.ihuyi.com/sms/Submit.json"   -d "account=API_ID"   -d "password=API_KEY"   -d "mobile=13800138000"   --data-urlencode "content=【告警】web-01 CPU 92%。"

# 成功响应
# {"code":2,"smsid":"20260924xxxxxx","msg":"提交成功"}

常见参数错误

1. account/password填反，或复制时带了空格，导致鉴权失败
2. mobile未带国家码或位数不对，校验不通过
3. content未带签名，短信通道被拒
4. 语音content过长，超过播报建议字数

请求方式与编码

接口支持POST表单提交，Content-Type为application/x-www-form-urlencoded。中文content必须做URL编码，命令行用curl的--data-urlencode，代码里用对应语言的URL编码函数，避免出现乱码。HTTPS加密传输，账号密码不会明文暴露。

• mobile：大陆手机号11位，按文本提交即可
• time：用于定时发送，不传则立即发送
• templateid：按通道要求使用，短信模板审核通过后分配

提交后的追踪

code=2只是"提交成功"，不代表用户一定看到。短信要等异步回执，语音要看接听时长。把smsid存到业务表，后续拉回执对账，才能形成完整闭环。mobile字段建议统一在网关层做格式校验。

三类接口地址固定：短信与闪信参数一致，语音content为播报文本。请求用POST表单提交，HTTPS加密。mobile为大陆11位手机号，time用于定时发送。对接前建议先用自己手机号跑通，确认回执可查再上生产。

可选templateid与time参数，按通道要求使用。中文content务必URL编码，避免乱码。

提交成功返回code=2与smsid，后续可用smsid跟踪回执。短信提供毫秒级状态回执，30余种状态码区分送达与拦截。互亿无线提供11种语言代码示例，免费技术支持。对接时建议先用测试条数把参数跑通，再上生产。注册免费试用，拿API ID和Key开始联调。