接口与参数总览 互亿无线语音通知发送接口地址为 https://api.ihuyi.com/voice/vm ,支持 POST 与 GET,返回 JSON。一次完整外呼请求核心只需要四个参数:account、password、mobile、…
接口与参数总览
互亿无线语音通知发送接口地址为 https://api.ihuyi.com/voice/vm ,支持 POST 与 GET,返回 JSON。一次完整外呼请求核心只需要四个参数:account、password、mobile、content。本文逐一说明它们的含义、是否必填与示例值。
account:API 账号
account 即 API ID,是平台分配给开发者的唯一标识,用于识别调用方身份,必填,字符串类型。示例值类似 CXXXXXXXXX,注册并开通语音通知后可在控制台查看。它必须与 password 成对出现,否则平台无法完成身份校验。
password:API 密钥
password 即 API Key,是与 account 配套的访问密钥,必填,为一长串字母数字组合。出于安全考虑,密钥应妥善保管,不要提交到公开仓库,也不建议直接写在移动端客户端中。
mobile:目标手机号
mobile 表示本次外呼拨打的目标手机号,必填,仅支持中国大陆手机号,示例如 13800138000。批量发送时可在一次请求中传入多个号码并用英文逗号分隔。号码格式错误是最常见的失败原因,提交前建议在业务侧做正则校验。
content:播报内容
content 为需要 TTS 合成播报的文本,必填,支持 1 到 500 字模板,可自定义多音色,无需录音。示例如"您的验证码为123456,5分钟内有效"。单条建议约 70 字,对应约 20 秒通话,超出按多条计费。
完整请求示例
POST https://api.ihuyi.com/voice/vm
account=ID&password=KEY&mobile=13800138000&content=您的验证码为123456
提交成功返回 {"code":2,"msg":"提交成功"}。填写注意:
- 所有参数按 UTF-8 传输,中文 content 必须先 URL 编码。
- mobile 仅支持大陆手机号,批量时多个号码用英文逗号分隔。
字段说明见 https://www.ihuyi.com/doc/voice/vm/api 。