商家认证开发手册V2[1].0.doc

商家认证说明rev.日期人员说明2.02012-08-31heimi强制用户跳转到商家网站，把控制权完全交付商家。商家版路由器、运营版认证网关(在线)通用n 相关说明1. 字符编码: utf-82. 接口采用http协议get访问方式3. 认证系统强制用户跳转到商家网站，把控制权交给商家n 商家认证接口说明1、 跳转接口：认证系统将强制用户跳转到商家指定的页面配置方式：在“商家管理后台热点管理认证页面配置认证配置”页面中，填写“认证url”，如/wifiapi.php注意：url中不能带任何参数数据处理：后台将自动在“认证url”后添加参数，如：/wifiapi.php?gatewayname=_001 &gw_addr=http%3a%2f%2f%3a2060%2fwifidog%2fauth&redirect= http%3a%2f%2&clientip=00&clientmac=00:34:d3:34:11:fe&rnd=随机码&opkey=md5(rnd&操作验证码) 参数说明：参数参数名称说明商家网站url强制跳转到达的url如/wifiapi.phpgatewayname热点名称英文或数字gw_addr认证设备的内网地址该参数已通过url编码redirect跳转前用户访问的网址如 该参数需通过url编码clientip用户的ip地址clientmac用户的mac地址rnd随机码检验随机字符串opkey随机码和操作验证码合并后的md5值2、 授权接口：商家网站验证成功后，调用此接口取授权令牌提交方式：/c/mo_api_autheduser.php? 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用户上传带宽可选值，留空即不限制，继承全局值（如有）。单位：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认证设备的内网地址如：:2060接口1取得的值（url解码）$token授权令牌接口2取得的值$url用户自动跳转的地址可以是认证前访问的网址（接口1中跳转前的网址），也可以是商家指定的网址。注意：网页白名单中必须加入商