Skip to main content
注册
首页/文档中心/开发者中心/语音验证码 API

语音验证码 API

语音验证码 API 用于向目标手机号发起语音电话并播报验证码，适合短信验证码未及时接收、关键校验需要补充触达的场景。

查看旧 OpenAPI 原文

接口概览

项目说明
接口用途向指定手机号发起语音验证码播报。
请求方式GET。
编码要求统一使用 UTF-8。
频率限制同一被叫号码 30 秒内最多发送 1 条。
适用场景短信未达补充验证、登录注册、找回密码、关键操作校验。

请求地址

GET https://api.smsbao.com/voice
?u=USERNAME
&p=PASSWORD_OR_APIKEY
&m=PHONE
&c=CODE
接口地址
普通接口http://api.smsbao.com/voice?u=USERNAME&p=PASSWORD&m=PHONE&c=CODE
安全接口https://api.smsbao.com/voice?u=USERNAME&p=PASSWORD&m=PHONE&c=CODE

请求参数

参数必填示例说明
u是tom短信宝平台注册用户名。
p是32 位 MD5 或 ApiKey平台登录密码 MD5 后的 32 位值，或后台 / 客服提供的 ApiKey。
m是13818313333目标手机号码。
c是321123需要语音播报的验证码。

返回结果

返回含义处理方式
0提交成功。继续结合发送记录、用户接听情况和业务日志判断结果。
其他内容错误提示或错误码。对照错误码、号码、余额、频率限制和账号配置排查。

常见错误码

错误码含义处理建议
30错误密码。检查密码 MD5 值或 ApiKey 是否正确，避免测试账号和正式账号混用。
40账号不存在。确认用户名是否正确，账号是否可正常登录。
41余额不足。检查账户余额、套餐状态或产品余额。
43IP 地址限制。检查接口调用服务器 IP 是否在允许范围内。
50内容含有敏感词。检查短信内容、签名、模板变量和营销合规要求。
51手机号码不正确。检查号码格式、国家区号、分隔符和空格。

注意事项

  • 同一被叫号码 30 秒内最多发送 1 条，业务侧也应增加冷却时间和防刷策略。
  • 语音验证码通常作为短信验证码的补充方式，不建议无条件连续触发。
  • 请在业务日志中记录请求时间、手机号脱敏信息、验证码业务单号和接口返回结果。
  • 涉及费用和适用号码范围时，以语音验证码价格说明和控制台配置为准。