用 Postman 调试语音通知 API：从请求到响应全流程

一、新建 POST 请求

Postman 是调试语音通知接口最快的工具。打开 Postman 新建一个请求，方法选择 POST，地址填入 https://api.ihuyi.com/voice/vm。该接口同时支持 GET，但调试阶段推荐 POST，参数放在 Body 中更清晰，也便于后续复制到代码中使用。

二、配置 Headers

切换到 Headers 标签，添加 Content-Type，值为 application/x-www-form-urlencoded。如果使用 form-data 方式，Content-Type 会由 Postman 自动生成并附带 boundary，无需手动填写，手动填反而可能导致解析失败。

三、配置 Body

切换到 Body 标签，选择 x-www-form-urlencoded 或 form-data，按下表填写键值对：

account   您的APIID
password  您的APIKey
mobile    13800138000
content   您的验证码为1234

如果选 form-data，注意 content 的类型选择 Text；若 content 含中文，Postman 会按 UTF-8 提交，一般无需手动 URL 编码。建议先用纯数字验证连通性，再加中文测试播报。

四、发送与判断响应

1. 点击 Send 发送请求；
2. 下方 Body 区域返回 JSON，如 {"code":2,"msg":"提交成功"}；
3. code 等于 2 表示提交成功，被叫将在数秒内收到呼叫；
4. 若 code 非 2，根据 msg 提示修正凭证或号码后重发。

调试时建议把 Postman 请求保存为 Collection，方便团队共享与回归。接口参数见接口文档，DEMO 见代码示例页面。