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

接入互亿无线预警通知接口时，常打交道的就是account、password、mobile、content这几个请求参数。参数传错是联调阶段常见的问题：手机号格式不对、content超长、模板变量没配、密钥填反，都会导致发送失败。本文把核心请求参数逐一讲清楚，帮助开发者一次配对。

认证类参数：account与password

这两个参数是身份凭证，对应控制台的APIID与APIKEY，采用双重认证。

• account：即APIID，一串数字或字符标识，在控制台获取；
• password：即APIKEY，与APIID配套使用，注意不是登录密码；
• 两者必须同时正确，否则返回认证类错误码；
• 密钥走HTTPS传输，不要在HTTP明文环境中提交。

接收人与内容参数：mobile与content

mobile指定发给谁，content指定发什么，是业务核心。

• mobile：接收手机号，国内手机号格式，多号码可用指定分隔方式批量提交；
• content：短信内容或语音TTS文本；
• 短信500字以内按多条计费，超长会拆分；
• 语音content约70字对应20秒播报，无需录音；
• 模板变量方式发送时，content填变量值，多变量以英文竖线|分隔，并必填templateid。

参数请求示例

一次完整的短信POST请求如下：

curl -X POST https://api.ihuyi.com/sms/Submit.json \
  -d "account=APIID示例" \
  -d "password=APIKEY示例" \
  -d "mobile=13800138000" \
  -d "content=测试告警内容，请注意查收" \
  -d "templateid=模板ID"

另外，动态密码类场景还需要传time参数；GET方式提交时参数拼在URL后即可。

参数排查常见问题

• 返回认证错误：检查account/password是否填反、是否多余空格；
• 手机号错误：确认号码格式正确、不带加号或空格；
• 内容审核不通过：自定义短信需先报备签名与模板；
• 语音无声音：确认content不为空且TTS文本通顺。

模板相关参数：templateid与time

除了四个核心参数，接口还支持模板与动态场景参数。使用模板变量方式发送时，必须传templateid指定模板编号，此时content填的是模板变量值，多个变量之间用英文竖线分隔。例如模板有两个变量，content写成"变量一值|变量二值"。动态密码类场景还需要传time参数，用于防重放。

请求方式与编码说明

接口支持POST与GET两种方式，推荐POST，参数放在请求体里更安全。无论哪种方式，参数都按UTF-8编码。GET方式提交时把参数拼在URL后面即可，但中文与特殊字符需要做URL编码。content长度方面，短信500字以内按多条计费，超长会自动拆分；语音content约70字对应20秒播报。

参数搭配常见组合

• 自定义短信：mobile + content直接发，需先报备签名模板；
• 模板短信：mobile + content(变量) + templateid；
• 动态密码：mobile + content + templateid + time；
• 语音通知：mobile + content，content为TTS文本，无需录音。

完整字段可参考短信通知接口文档与语音通知接口文档。

把参数含义理解透，联调少走弯路。前往注册免费试用获取属于自己的APIID与APIKEY。