我是靠谱客的博主 缓慢棉花糖,最近开发中收集的这篇文章主要介绍云片:语音验证码接口部署说明文档,觉得挺不错的,现在分享给大家,希望可以做个参考。

概述

功能说明:

  • 通过电话直呼到用户手机并语音播放验证码,默认最多播放 2 次。如:您的验证码是 1234。 系统已提供的默认模板。

特别说明:验证码短信,请在手机验证环节,加入图片验证码, 以免被恶意攻击

 

HTTP 头信息:

Accept:application/json;charset=utf-8; Content-Type:application/x-www-form-urlencoded;charset=utf-8;

 

请求

 

URL:https://voice.yunpian.com/v2/voice/send.json
访问方式:POST

请求参数

参数名类型是否必须描述示例
apikeystring

用户唯一标识,在"账号设置"-"子帐号管理"中查看

9b11127a9701975c734b8aee81ee3526
mobilestring

接收的手机号,国际号码需包含国际地区前缀号码,国内号码可直接传号码

国内号码15205201314

国际号码

+93701234567

codestring验证码,支持 4~6 位阿拉伯数字1234

language

string

播放语言,非中国大陆地区,默认值为en,其中:

zh:中文;

en:英文;

id:印尼语;

vi:越南语;

tr:土耳其语;

ru:俄语;

de:德语;

fr:法语;

it:意大利语;

pt:葡萄牙语;

(中国大陆地区,固定为中文播放,参数无效)

en

uidstring该条短信在您业务系统内的 ID,如订单号或者短信发送记录流水号。默认不开放,如有需要请联系客服申请。10001
callback_urlstring本条语音验证码状态报告推送地址。 如推送地址固定,建议在"数据推送与获取”做批量设置。http://your_receive_url_address

 

附注:该接口加密时,需对手机号和验证码同时加密。

为防止骚扰用户,国内(+86号码段)每天22:00至次日8:00禁止发送语音验证码。

 

响应

名称类型描述
countinteger成功发送的语音呼叫次数
feeinteger扣费金额,一次语音验证码呼叫扣一条短信
sidstring记录 id,不超过32 位的唯一字符串

 

Json 返回示例:

 

调用成功的返回示例:

 

{
  "count": 1,
  "fee": 1,
  "sid": "3375655611"
}

 

调用失败的返回示例:

 

{
  "http_status_code": 400,
  "code": 8,
  "msg": "同一手机号30秒内重复提交相同的内容",
  "detail": "同一个手机号 15840685236 30秒内重复提交相同的内容"
}

 

防骚扰过滤

 

过滤规则:同一个手机号码,30 秒内最多发送 1 次,1小时内最多发送 3 次,24小时内最多发送 5次。

 

语言对照表

language

语言

播放内容

zh中文您的验证码是1-2-3-4
en英文Your verification code is 1-2-3-4
id印尼语Kode verifikasi Anda adalah 1-2-3-4
vi越南语Mã xác minh của bạn là 1-2-3-4
tr土耳其语Doğrulama kodunuz 1-2-3-4
ru俄语Ваш проверочный код 1-2-3-4
de德语Ihr Bestätigungscode lautet 1-2-3-4
fr法语Votre code de vérification est 1-2-3-4
it意大利语Il tuo codice di verifica è 1-2-3-4
pt葡萄牙语O seu código de verificação é 1-2-3-4

 

最后

以上就是缓慢棉花糖为你收集整理的云片:语音验证码接口部署说明文档的全部内容,希望文章能够帮你解决云片:语音验证码接口部署说明文档所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。

本图文内容来源于网友提供,作为学习参考使用,或来自网络收集整理,版权属于原作者所有。
点赞(72)

评论列表共有 0 条评论

立即
投稿
返回
顶部