高级功能开发主要是针对一些有特别要求客户,目前我们支持开发的功能有:
(1).短信接口余额查询(您也可以在平台查询).
(2).短信接口密码修改(您也可以在平台修改)
(3).验证用户登陆
(4).接受回复短信(由推广和获取两种方式)
(5).短信接口远程开户(主要是针对代理客户,不用登陆平台)
(6). 短信接口远程充值
(主要是针对代理客户,不用登陆平台)
1.余额查询、密码修改、验证用户登陆
(1).调用接口地址(包括余额查询,密码修改,验证码用户登陆,可以调用此地址)
http://jiekou.56dxw.com/sms/HttpInterfaceR.aspx?comid=企业ID&username=用户名&userpwd=旧密码&newpwd=新密码&action=操作行为
(2).余额查询、密码修改、验证用户登陆参数说明
参数名 | 是否必写 | 说明 | 描述 |
---|---|---|---|
comid | 是 | 企业ID | |
username | 是 | 用户名 | |
userpwd | 是 | 密码 | |
newpwd | 是 | 新密码 | 如果操作行为参数为editpwd,userlogin 新密码参数可以为空 |
action | 是 | 操作行为 | 操作行为: [editpwd 密码编辑] [userlogin 用户登陆] [moneyc:返回余额] |
余额查询返回值说明
返回值 | 说明 |
---|---|
-1 | 代表用户名密码不正确 |
短信条数#语音条数 | 返回短信条数和语音条数 |
密码修改返回值说明
返回值 | 说明 |
---|---|
1 | 修改成功 |
-1 | 修改失败 |
-2 | 用户名或密码错误 |
验证用户登陆返回值说明
返回值 | 说明 |
---|---|
1 | 修改成功 |
-1 | 登陆失败 |
-2 | 用户名密码错误 |
2:接受回复短信
目前我们提供主动推送和主动获取二种回复方法,具体参考如下:
(1)主动推送:是指由客户提供地址,我们把回复的内容推送到指定的地址,客户只需要接收一下tel和msg参数即可。(一般用request接收,具体语言可能不同)
主动推送参数说明
参数名 | 是否必写 | 说明 | 描述 |
---|---|---|---|
tel | 是 | 回复的手机号 | |
msg | 是 | 回复的内容 |
(2).主动获取,是指调用短信接口回复地址来得到回复的内容,主动获取回复url地址
http://jiekou.56dxw.com/sms/HttpNoteBack.aspx? comid=企业ID&username=用户名&userpwd=密码&zid=子号(需要客服分配)&action=(根据下边参数填写,默认可为空)
主动获取参数说明(支持24小时内的短信获取,建议定时获取时间间隔10秒)
参数名 | 是否必写 | 说明 | 描述 |
---|---|---|---|
_cid | 是 | 企业ID | |
_username | 是 | 用户名 | |
_userpwd | 是 | 密码 | |
zid | 是 | 子号[需要客户申请开通] | |
action | 是 | 行为 当action=xml的时候回复调用是xml格式的,为text时回复为文本的格式 | 下载回复格式说明 |
主动获取返回值说明:
返回值 | 说明 |
---|---|
空 | 如果返回值为空,代表没有回复短信 |
-1 | 代表用户名密码不正确 |
-2 | 小号不能为空,否则无法接收回复信息 |
-3 | 没有回复的信息 |
-4 | 子号不能大于3,并且得是数字 |
3:调用接口新开用户(此接口只适合代理用户,并确认已经开通了此权限)
(1).调用接口地址
http://jiekou.56dxw.com/sms/AddUserAdd.aspx?aid=代理企业ID&aname=代理企业用户名&apwd=代理企业密码&uname=新开用户名&upwd=新开用户密码&cname=客户名称&ctel=姓名&cqq=QQ号&email=电子邮件&right=0(开户权限)
参数说明
参数名 | 是否必写 | 说明 | 描述 |
---|---|---|---|
aid | 是 | 代理企业ID | |
auserName | 是 | 代理用户名 | |
apwd | 是 | 代理用户密码 | |
nusername | 是 | 新开用户名 | |
npwd | 是 | 新开用户密码 | |
customername | 是 | 客户名字 | |
customertel | 是 | 客户电话 | |
customerqq | 是 | 客户QQ | |
customeremaill | 是 | 客户email | |
Sright | 是 | 权限 | 1代表开下级 |
返回值说明:
返回值 | 说明 |
---|---|
1 | 1代表填加用户成功 |
-1 | 所有参数均不能为空 |
-3 | 不是代理用户 |
-5 | 您的账户余额,已经不足开代理用户 |
-6 | 用户添加失败 |
-7 | 对各项长度做了限制,请输入您真实的值 |
-8 | 用户名已经存在 |
4:短信充值,此接口只适合代理用户(并且确认已经开通了此权限)
(1).调用接口地址
http://jiekou.56dxw.com/sms/ToNoteTo.aspx?aid=企业ID&aname=代理用户名&apwd=代理密码&uid=141&uname=新开用户名¬ec=冲值短信条数&action=0 (根据下边文档参数填写)
参数说明
参数名 | 是否必写 | 说明 | 描述 |
---|---|---|---|
aid | 是 | 代理企业ID | |
aname | 是 | 代理用户名 | |
apwd | 是 | 代理用户密码 | |
userid | 是 | 新开用户名 | |
username | 是 | 新开用户密码 | |
tomoney | 是 | 客户名字 | |
action | 是 | 客户电话 |
返回值说明
返回值 | 说明 |
---|---|
1 | 代表充值成功 |
-1 | 用户名 密码错误 |
-2 | 您不是代理用户 |
-3 | 您充值的金额大于您的账户余额 |
-4 | 更新代理账户余额失败 |
-5 | 账户充值失败 |
-6 | 更新普通账户余额失败 |
-7 | 代理账户上添加作额失败 |
-8 | 所有参数均不能为空 |
-9 | 开代理的条件(短信条数)不符合要求 |
-10 | 新开户的用户名,不存在 |
-11 | 该账户的余额小于您要减去的余额条数 |
-12 | 您不是代理用户 |
-15 | 不能自己对自己操作 |