先手动发一条看看效果 刚注册完账号，拿到API ID和Key，想先手动发一条短信看看效果，不必急着写代码。用Postman构造一次HTTP请求，就能快速验证参数是否正确、返回是否成功，也方便在对接前先确认签名与模板是否匹配。互亿无线预警通知…
先手动发一条看看效果
刚注册完账号，拿到API ID和Key，想先手动发一条短信看看效果，不必急着写代码。用Postman构造一次HTTP请求，就能快速验证参数是否正确、返回是否成功，也方便在对接前先确认签名与模板是否匹配。互亿无线预警通知API采用标准HTTP POST接口，在Postman里配置几步即可完成调试，是很多团队跑通接口的起点。
本文按请求配置、参数填写、响应判断三步，说明从打开Postman到收到测试短信的完整过程。
步骤一：新建请求并选择方法
打开Postman，点击新建请求，按以下步骤配置：
- 请求方法选择POST。
- URL填入短信提交接口：https://api.ihuyi.com/sms/Submit.json。
- 切换到Body标签，选择x-www-form-urlencoded。
步骤二：填写请求参数
在Body中按下表填写键值对：
| Key | Value示例 | 说明 |
|---|---|---|
| account | 你的API_ID | 控制台获取 |
| password | 你的API_Key | 控制台获取 |
| mobile | 13800138000 | 接收手机号 |
| content | 【互亿测试】这是一条测试告警。 | 需匹配已审核模板 |
调试语音接口时，URL换成 https://api.ihuyi.com/voice/vm，content填播报文本；调试闪信时URL换成 https://api.ihuyi.com/flash/Submit.json。共用文档见 https://www.ihuyi.com/doc/msg/sms/api/Submit.html 。注意Body选的是x-www-form-urlencoded，不要误用raw JSON，否则参数可能解析不到。
步骤三：发送并判断响应
点击Send后，在下方Response区域查看返回。成功时返回JSON中code为"2"，并带有smsid：
{
"code": "2",
"msg": "提交成功",
"smsid": "20260927130000123456"
}
常见返回含义：
- code=2：提交成功，记录smsid用于后续回执查询。
- 认证类错误：检查account与password是否填写正确、是否有多余空格。
- 内容错误：确认content与已审核模板一致，签名【】是否正确。
- 号码错误：确认mobile为有效手机号。
调试技巧
把Postman用例固化下来
调试通过后，不要关掉Postman就完事。建议把短信、语音、闪信三个请求分别保存，并在请求名里标注用途，例如"短信-P2告警""语音-P1告警"。团队新人接手时，导入这个Collection就能立刻复现发送流程，不必重新猜参数。还可以在Postman里写一个简单的测试脚本，自动校验返回code是否为2，方便每次改动后回归。互亿无线提供11种语言代码示例，Postman调通后可对照迁移到生产代码。
常见报错对照
调试中遇到返回错误，先对照文档判断类别。认证类错误检查Key；内容类错误检查模板与签名；号码类错误检查手机号格式。把这些对照记在团队文档里，新人上手会快很多。
调试时建议把每次请求的URL、参数和返回都留个截图，遇到问题便于和技术支持一起定位。
把常用参数保存为环境变量，在Postman中新建Environment，把API_ID、API_Key、测试手机号存为变量，请求里用{{account}}引用，避免每次手填。调试完成后，可把请求右键保存为Collection，团队成员共享同一套调试用例。调试语音时，建议先用自己的手机号接收，确认TTS播报语速与内容清晰后再切换到值班号码。互亿无线提供11种语言代码示例，Postman调通后可直接对照翻译成自己的项目代码。注册免费试用，领取测试条数后即可在Postman里发出首条测试告警。
