返回码的含义 调用互亿无线语音通知接口 https://api.ihuyi.com/voice/vm 后，平台返回 JSON，其中 code 字段是判断请求是否被受理的关键。最常见的成功响应是 {"code":2,"msg":"提交成功"}…
返回码的含义
调用互亿无线语音通知接口 https://api.ihuyi.com/voice/vm 后，平台返回 JSON，其中 code 字段是判断请求是否被受理的关键。最常见的成功响应是 {"code":2,"msg":"提交成功"}，即 code 等于 2 代表外呼任务已成功提交到平台队列，等待线路外呼。需要注意的是，提交成功并不等于用户已接听，真正的呼叫结果要通过回调或状态查询获取。
常见错误码与排查思路
除 code=2 外，其余返回码均代表某种异常。下面整理了开发中最常遇到的几类错误及排查方向。
- 账号或密码错误：提示账号、密码不正确。优先检查 account 是否填了 API ID 而非登录用户名，password 是否填了 API Key 而非登录密码，以及复制时是否多带了空格。
- 手机号格式不正确：提示手机号为空或格式有误。确认 mobile 为 11 位大陆手机号，不含空格或国际区号；批量提交时多个号码用英文逗号分隔。
- 播报内容为空：提示内容不能为空。检查 content 是否正确 URL 编码，POST 时 body 是否完整传输，避免被业务层误过滤。
- 余额不足：提示账户余额不足。语音通知按成功计费、失败不计费，但仍需保证账户有可用套餐。套餐无有效期，最低 1500 元起购，注册送 10 条免费调试额度。
- 模板未报备或未审核通过：平台免报备签名、仅需报备模板，模板报备约 2 小时审核通过。若提示模板不合规，需检查 content 是否与报备模板一致。
排查建议
遇到非 code=2 返回时，先把完整 msg 字段打印出来，平台会在 msg 中给出具体原因。同时核对请求地址、方法、编码是否与文档一致。完整返回码对照表见 https://www.ihuyi.com/doc/voice/vm/api ，代码示例见 https://www.ihuyi.com/doc/voice/vm/demo 。