商家认证开发手册V2.0-wifiAP无线认证.docVIP

商家认证说明 Rev. 日期 人员 说明 2.0 2012-08-31 Heimi 强制用户跳转到商家网站，把控制权完全交付商家。 商家版路由器、运营版认证网关(在线)通用 2013/3/13 Hyq 优化接口说明 相关说明  商家认证接口说明 /wifiapi.php?gatewayname=_001 gw_addr=http%3A%2F%2F%3A2060redirect= http%3a%2f%2clientip=00clientmac=00:34:D3:34:11:FErndpkey= 81a78c253b13b678f630bd 【参数说明 参数 参数名称 说明 /wifiapi.php gatewayname 热点名称 与商家后台对应的“热点名称” gw_addr 认证设备的内网地址 该参数已通过url编码 redirect 跳转前用户访问的网址 如 该参数已通过url编码 clientip 用户的IP地址 商家版路由器为空 clientmac 用户的MAC地址 商家版路由器为空 rnd 随机码 校验随机字符串 opkey Md5(rnd+key) 随机码和操作验证码合并后的MD5值  授权接口 商家网站可自定义页面、自定义认证流程，用户验证成功后，调用此接口取得此用户的认证授权码。 【提交方式】 /c/mo_api_autheduser.php?gatewayname=$gatewayname action=getokenrnd=随机码opkey=md5(rnd操作验证码)username=用户名[bw_up=$bw_upbw_down=$bw_down] 参数说明： 参数 参数名称 说明 atewayname 热点名称 接口1的 gatewayname值 action 动作 固定值“getoken” rnd 随机码 接口1的 rnd值 opkey Md5(rnd+key) 随机码和操作验证码合并后的MD5值 username 登录的用户名 用户标识 bw_up 用户上传带宽 可选值，留空即不限制，继承全局值（如有）。单位：KB/s bw_down 用户下载带宽 可选值，留空即不限制，继承全局值（如有）。单位：KB/s 返回结果： wifiap ressuccess/res tokenjdiejskejdkwpokslrmnqwiosdpzei/token /wifiap res结果代码 说明 error_0 操作验证码不匹配 error_1 热点名不正确 error_2 其他参数为空或不正确 error_3 未知错误，请联系管理员 success 用户有效，可登录上网。此时才有token值。如果返回其它error值，请检查系统流程。 上网授权 取得token后，引导用户的浏览器跳转到如下地址授权上网： :2060/wifidog/auth?token= a6d6d4a2a6b54639xv6w6rwiewp5ghv1[url=http%3a%2f%2] 参数 参数名称 说明 $token 授权令牌 接口2取得的值 $url 用户自动跳转的地址 可以是认证前访问的网址（接口1中跳转前的网址），也可以是商家指定的网址。 注意：认证对接URL必须加入“外网白名单” 实现流程： 商家认证成功后，调用api取登录令牌 WifiAP服务器 Web认证跳转到商家网站 用户发起上网请求 用户 对此用户授权上网 认证设备 商家服务器