高级功能开发主要是针对一些有特别要求客户,目前我们支持开发的功能有:
(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 | 不能自己对自己操作 |

