外部API接口说明
Rev.
日期 | 人员 | 说明 | |
2.0 | 2012-08-31 | Heimi | 用户名密码在外部服务器上,通过此API实现认证系统与外部数据源无缝对接。 商家版路由器、运营版认证网关(在线)通用 |
2013/3/18 | Hyq | 优化接口说明 | |
⏹ 相关说明
1. 字符编码: UTF-8
2. 接口采用HTTP协议GET访问方式(不支持POST方式)
3. 认证系统按指定方式调用外部的API,从外部数据源去验证用户名/密码的有效性
⏹ 用户验证API接口说明
【配置方式】
“商家管理后台->[指定热点]->认证配置”功能页面:
(1)认证方式:选择“外部API认证”;
(2)认证对接URL:填写第三方认证页面地址,如www.163/wifiapi.php
(3)操作验证码:填写一段字符串,用于双方通讯时的密钥;
【数据处理】
当用户在认证页面上输入用户名密码,点击登录时,系统将在后台触发API,把相关参数传递到外部服务器进行校验,如:
www.163/wifiapi.php?gw_id={gw_id}&username={username}&password={password}&rnd={rnd}&opkey={opkey}
参数说明:
参数 | 变量名 | 说明 |
gw_id | {gw_id} | 热点名称 |
username | { username} | 登录的用户名 |
password | { password} | 登录的密码,已经过md5加密 |
rnd | {rnd} | 随机码 |
opkey | {opkey} | 随机码和操作验证码合并后的MD5值 |
【外部服务器响应】
外部API接收传递的参数,与数据库校验处理后,以如下格式返回结果:
<wifiap>
<res>success</res>
<expiretime>7200</expiretime>
<bw_up>20</bw_up>
<bw_down>100</bw_down>
</wifiap>
<res>结果代码 | 说明 |
error_0 | 操作验证码不匹配 |
error_1 | gw_id不正确 |
error_2 | 其他参数为空或不正确 |
error_3影视资源站采集api接口数据 | 未知错误,请联系管理员 |
error_4 | 用户名密码不正确 |
success | 用户有效,可登录上网。 |
<expiretime>:该次登录的有效时长(以秒为单位),不设置则不限制该次登录的时长,自动继承系统的硬性断开和空闲断开时间。
<bw_up>:用户的最大上传带宽(KB/s)
<bw_down>:用户的最大下载带宽(KB/s)
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论