预警通知API快速接入：3分钟上线的完整流程

很多团队初次接触预警通知时，担心接入流程复杂、要申请资质、要排期测试。实际上，互亿无线预警通知接口是标准HTTPS POST接口，只要拿到APIID与APIKEY，一个curl命令就能发出首条告警短信或语音。本文梳理从注册到上线的完整流程，帮助开发者在很短时间内把预警通道跑通。

快速接入的整体流程

接入不需要安装额外组件，只要业务服务器能访问公网HTTPS即可。整个过程分为注册、取密钥、调试、上线四步。

1. 在互亿无线官网注册账号并完成实名认证；
2. 控制台获取APIID（account）与APIKEY（password）；
3. 在控制台报备短信签名与模板，语音内容直接用TTS文本；
4. 用curl或代码向接口发一条测试短信/语音；
5. 收到回复code=2即表示提交成功，在控制台查看发送状态。

三条核心接口地址

不同通道对应不同地址，但参数结构一致，开发者很快就能上手：

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

首条预警请求示例

用curl向语音接口发一条测试告警，无需录音，content由TTS合成：

curl -X POST https://api.ihuyi.com/voice/vm \
  -d "account=你的APIID" \
  -d "password=你的APIKEY" \
  -d "mobile=你的手机号" \
  -d "content=这是一条测试预警，请确认电话是否正常接听"

提交成功返回code=2与流水号，几分钟内手机会收到语音电话。短信接口同样支持POST/GET、UTF-8编码。

上线前的关键检查点

• 确认APIID与APIKEY已正确填入，不要把密钥提交到代码仓库；
• 短信签名与模板已报备，未报备的自定义短信可能审核不通过；
• content长度：短信500字以内按多条计费，语音约70字对应20秒播报；
• 按成功计费、失败不计费，注册即送免费测试额度，可先小额验证。

接入前的准备清单

正式写代码前，先把准备工作做齐，能避免联调阶段反复回头。准备清单包括：在互亿无线控制台注册账号并完成实名认证；获取APIID与APIKEY；在控制台配置短信签名与模板（自定义短信场景）；确认业务服务器能访问 api.ihuyi.com 的443端口；准备一个测试手机号用于验证。语音通知无需提前录音，content由TTS合成，这一步可以省掉录音环节。

三步接入流程

1. 用curl或控制台在线调试工具先发一条测试短信，确认APIID、APIKEY、手机号可用，返回code=2；
2. 在业务系统中封装一个发送函数，把account、password从环境变量读取，设置10秒超时；
3. 把函数挂到告警触发点：监控系统回调、定时任务、业务异常catch块里；
4. 配置回调地址接收送达状态，形成提交到送达的闭环。

联调阶段常见卡点

• 返回认证错误：多半是account与password填反，或APIKEY带了多余空格；
• 自定义短信审核不通过：签名与模板需在控制台先报备，审核通过后才能使用；
• 请求超时：检查业务服务器公网出口与DNS，必要时配置HTTPS代理；
• 中文乱码：请求按UTF-8编码提交，不要用GBK。

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

接入完成后建议先在测试手机号上跑通完整链路，再把发送函数挂到生产告警触发点；调试期间按成功计费、失败不计费，反复多次试发也不会产生额外成本。

预警通道接入本质上就是一次HTTPS调用，门槛很低。前往注册免费试用，领取测试额度后马上发出首条告警。