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