运维监控

语音通知 API 请求参数详解:account、password、mobile、content 全解析

文章详情

接口与参数总览 互亿无线语音通知发送接口地址为 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 。

立即开始使用语音通知 API

注册送10条调试额度 · 3分钟快速接入 · 免费技术支持