北京福彩网 · 文档中心

语音验证码 - API文档


语音验证码API接口文档下载:  点击下载

1、概要

1.1 文档说明

本文档主要提供给互亿平台的用户对接接口的使用说明,开发者可以利用 ihuyi 提供的 HTTP 接口,调用 ihuyi 的语音验证码服务。

1.2 接口内容

本文档包含语音发送、余额查询、发送回执推送等。

1.3 提交方式

GET / POST

1.4 加密方式

1、采用http协议提交请求
2、通过MD5动态签名方式加密

1.5 API ID / API KEY

登录用户中心,进入【语音验证码】模块,在【产品总揽】页面右上角,如下图所示:

2、语音发送

2.1 接口描述

通过POST、 GET 方式进行短信提交,数据编码采用utf-8格式,24小时全天发送。

2.2 请求地址

http://www.kwsul.com.cn//webservice/voice.php?method=Submit

2.3 请求参数

参数名称 参数值描述 必填
account APIID(请登录用户中心【语音验证码】-【产品纵览】查看)
password 1、APIKEY(请登录用户中心【语音验证码】-【产品纵览】查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
mobile 接收手机号码,只能提交1个号码
content 验证码(4-6位数字)
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填)
format 返回格式(可选值为:xml或json,系统默认为xml)

用户通过http 或 http提交发送短信请求到服务器后,服务器会返回一串xml格式的字符串,SubmitResult结构说明如下:

参数名称 类型 描述
code int 返回值为2时,表示提交成功
smsid string 当提交成功后,此字段为流水号,否则为0
msg string 提交结果描述

2.4 响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?>
<SubmitResult xmlns="api.voice.ihuyi.com">
<code>2</code>
<msg>提交成功</msg>
<smsid>60495654</smsid>
</SubmitResult>

示例(失败)

<?xml version="1.0" encoding="utf-8"?>
<SubmitResult xmlns="api.voice.ihuyi.com">
<code>405</code>
<msg>用户名或密码不正确</msg>
<smsid>0</smsid>
</SubmitResult>

2.5 响应参数

code msg
0 提交失败
2 提交成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
403 手机号码不能为空
4030 手机号码已被列入黑名单
404 语音内容不能为空
405 用户名或密码不正确
4050 账号被冻结
4051 剩余条数不足
4052 访问ip与备案ip不符
406 手机格式不正确
407 短信内容含有敏感字符
4070 语音验证码内容必须为4-6位数字
408 您的帐户疑被恶意利用,已被自动冻结,如有疑问请与客服联系。

2.6 请求示例

http://www.kwsul.com.cn//webservice/voice.php?method=Submit&account=APIID&password=APIKEY&mobile=手机号码&content=1125

3、余额查询

3.1 接口描述

通过接口可以方便的查询你的账户语音验证码剩余条数。

3.2 请求地址

http://www.kwsul.com.cn//webservice/voice.php?method=GetNum

3.3 请求参数

参数名称 参数值描述 是否必填
account APIID(请登录用户中心【语音验证码】-【产品纵览】查看)
password 1、APIKEY(请登录用户中心【语音验证码】-【产品纵览】查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填)
format 返回格式(可选值为:xml或json,系统默认为xml)

用户通过http 或 http提交帐户余额查询请求到服务器后,服务器会返回一串xml格式的字符串,GetNumResult结构说明如下:

参数名称 类型 描述
code int 状态返回值
msg string 查询结果描述
num string 剩余数量

3.4 响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?>
<GetNumResult xmlns="api.voice.ihuyi.com">
<code>2</code>
<msg>查询成功</msg>
<smsid>856</smsid>
</GetNumResult>

示例(失败)

<?xml version="1.0" encoding="utf-8"?>
<GetNumResult xmlns="api.voice.ihuyi.com">
<code>405</code>
<msg>用户名或密码不正确</msg>
<smsid>0</smsid>
</GetNumResult>

3.5 响应参数

code msg
2 查询成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
405 用户名或密码不正确
4050 账号被冻结

3.6 GET请求示例

http://www.kwsul.com.cn//webservice/voice.php?method=GetNum&account=APIID&password=APIKEY 

4、发送回执推送

4.1 接口描述

用户先提供数据接收地址,然后绑定到北京福彩网系统后台,平台会以POST方式实时的将回执信息推送到此地址。

4.2 推送参数

参数名称 参数值描述
code 状态值(2成功 0失败)
msg 回执状态说明
mobilephone 手机号码
talktime 接听时间(秒)
voiceid 流水号(对应提交时返回的voiceid)
report_time 回执时间

注意: 成功接收请输出字符 "success" (不包含引号)结束推送,否则以接收失败处理。每个回执最多推送3次。每次间隔叠加60秒。

5、生成动态密码方式

以PHP为例,提交语音验证码的生成方式:

$time = time();
$password = md5($account.$apikey.$mobile.$content.$time);

例如:

APIID: test
APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
手机号:138xxxxxxxx
内容:1125
time:1451544941
结果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d138xxxxxxxx11251451544941');

查询剩余条数的生成方式:

$time = time();
$password = md5($account.$apikey.$time);

例如:

APIID: test
APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
手机号:138xxxxxxxx
time:1451544941
结果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d1451544941');

Unix时间戳参考地址:http://www.kwsul.com.cn//Tools/unixtime.aspx

工作时段:4008 808 898
其他时段:159 0212 6017
博发彩票导航站 天津时时彩开奖直播 南国七星彩票论坛社区 香港马会唯一官方网 甘肃十一选5开奖结果
辽宁快乐12玩法5保3 彩票走势网 重庆幸运农场视频直播 赢波彩票手机app 三分彩开奖号码
上海福利彩票时时乐 曾道人内幕玄机 澳门真人赌场网址 11选5任3算法公式 重庆时时彩快速开奖器
北京快乐8属于什么彩票 快乐十分钟技巧 阿飞六合图库彩 平安彩票注册 香港开奖结果历史记录