《商家认证开发手册V2.0》apidev2.0.docVIP

商家认证说明 Rev. 日期 人员 说明 2.0 2012-08-31 Heimi 强制用户跳转到商家网站，把控制权完全交付商家。 商家版路由器、运营版认证网关(在线)通用 相关说明 1. 字符编码: UTF-8 2. 接口采用HTTP协议GET访问方式 3. 认证系统强制用户跳转到商家网站，把控制权交给商家 商家认证接口说明 跳转接口：认证系统将强制用户跳转到商家指定的页面 配置方式： 在“商家管理后台》热点管理》认证页面配置》认证配置”页面中，填写“认证URL”，如/wifiapi.php 注意：URL中不能带任何参数 数据处理： 后台将自动在“认证URL”后添加参数，如： /wifiapi.php?gatewayname=_001 gw_addr=http%3A%2F%2F%3A2060%2Fwifidog%2Fauthredirect= http%3a%2f%2clientip=00clientmac=00:34:D3:34:11:FErnd=随机码opkey=md5(rnd操作验证码) 参数说明： 参数 参数名称 说明 商家网站URL 强制跳转到达的URL 如/wifiapi.php gatewayname 热点名称 英文或数字 gw_addr 认证设备的内网地址 该参数已通过url编码 redirect 跳转前用户访问的网址 如 该参数需通过url编码 clientip 用户的IP地址 clientmac 用户的MAC地址 rnd 随机码 检验随机字符串 opkey 随机码和操作验证码合并后的MD5值  授权接口：商家网站验证成功后，调用此接口取授权令牌 提交方式： /c/mo_api_autheduser.php? gatewayname=$gatewayname action=getokenrnd=随机码opkey=md5(rnd操作验证码)username=用户名[bw_up=$bw_upbw_down=$bw_down] 参数说明： 参数 参数名称 说明 gatewayname 热点名称 返回接口1传递的 gatewayname action 动作 固定值“getoken” rnd 随机码 返回接口1传递的 rnd opkey 商户验证信息 rnd和操作验证码连接起来进行MD5 username 登录的用户名 用户标识 bw_up 用户上传带宽 可选值，留空即不限制，继承全局值（如有）。单位：KB/s bw_down 用户下载带宽 可选值，留空即不限制，继承全局值（如有）。单位：KB/s 返回结果： wifiap ressuccess/res cjdiejskejdkwpokslrmnqwiosdpzei/token /wifiap res结果代码 说明 error_0 操作验证码不匹配 error_1 Gatewayname不正确 error_2 其他参数为空或不正确 error_3 未知错误，请联系管理员 success 用户有效，可登录上网。  上网跳转 取得token后，商家即可让客户跳转到如下页面开始上网： $gw_addr/wifidog/auth?token=$token[url=$url] 参数 参数名称 说明 gw_addr 认证设备的内网地址 如：:2060 接口1取得的值（url解码） $token 授权令牌 接口2取得的值 $url 用户自动跳转的地址 可以是认证前访问的网址（接口1中跳转前的网址），也可以是商家指定的网址。 示例：:2060/wifidog/auth?token=a6d6d4a2a6b54639xv6w6rwiewp5ghv1url= 注意： 网页白名单中必须加入商家服务器地址 实现流程： 商家认证成功后，调用api取登录令牌 WifiAP服务器 商家服务器 用户发起上网请求 用户 认证设备 Web认证跳转到商家网站 对此用户授权上网