用Postman调试预警通知接口：从请求到响应

刚拿到 APIID 和 APIKEY，还没写代码，想先看看接口到底怎么返回？Postman 是调试 HTTP 接口很高效的工具。本文一步步带你用 Postman 打通互亿无线预警通知接口，从填参数到看响应，再到排查常见报错。

Postman 调试预警通知接口的准备

先在互亿无线控制台注册账号，获取 APIID 与 APIKEY，并确认已赠送测试额度。打开 Postman，新建一个请求，方法选 POST，地址填通知短信接口 https://api.ihuyi.com/sms/Submit.json 。建议把 APIID、APIKEY 存进 Postman 的环境变量，避免每次手填出错。

从请求到响应的操作步骤

1. 切换到 Body 标签，选择 x-www-form-urlencoded。
2. 添加 account 字段，值填你的 APIID；添加 password 字段，值填 APIKEY。
3. 添加 mobile 字段，填自己的手机号用于接收测试。
4. 添加 content 字段，填测试文案，例如"【互亿】接口调试测试"。
5. 点击 Send，查看下方 Response 区域返回的 JSON。

POST https://api.ihuyi.com/sms/Submit.json
Body (x-www-form-urlencoded):
account  = 你的APIID
password = 你的APIKEY
mobile   = 13800000001
content  = 【互亿】接口调试测试

响应示例:
{"code":2,"msg":"提交成功","smsid":1234567890}

调试中的常见现象

• code=2 表示提交成功，手机应在数秒内收到短信；smsid 是流水号，后续对账用。
• 返回参数错误，先检查 account/password 是否填反、content 是否为 UTF-8 编码。
• 语音接口地址是 https://api.ihuyi.com/voice/vm ，参数同样是 account、password、mobile、content。
• 调试用的手机号务必是本人号码，避免对他人造成打扰。

语音与闪信接口的调试差异

调试语音时把地址换成 https://api.ihuyi.com/voice/vm ，content 控制在 70 字左右，发送后留意来电而不是短信。调试闪信则用 https://api.ihuyi.com/flash/Submit.json ，参数与短信一致，差别在于闪信会直接弹屏显示。三者共用同一套认证，调通一个再换地址即可。

Postman 调试之后

Postman 跑通后，把这条请求导出为代码片段（Postman 支持生成 Python、PHP、Go 等语言代码），再搬到业务系统里稍加封装即可。建议把 APIID、APIKEY 放到环境变量中管理，不要写死在请求里。接口文档可参考短信接口文档。

把 Postman 用出效率

调试时建议把常用请求存成 Collection，短信、语音、闪信各存一条，账号密码放进环境变量，换环境只改变量即可。每次改了参数顺手保存，下次回归直接点 Send，不用重新填。

响应里要看什么

• code 等于 2 才是提交成功，msg 是简短说明，smsid 是流水号。
• code 不是 2 时，对照返回码说明看是参数、余额还是权限问题。
• 语音测试注意接听时段，content 控制在 70 字左右，避免播报超时。

Postman 还能配合 Tests 写断言，例如自动判断 code 是否为 2，把手动看响应变成自动校验，回归联调时省事不少。接口文档参数可对照短信接口文档。

把调试经验固化下来

联调通过后，建议把 Postman Collection、环境变量、常用测试文案整理进团队文档。新同事接手时照着跑一遍就能通，不必每次都从头猜参数。

用 Postman 几分钟就能验证整条链路，比直接写代码猜参数高效得多。还没账号的可以注册免费试用。