商家認證開發(fā)手冊V2[1].0

1、商家認證說明rev.日期人員說明2.02012-08-31heimi強制用戶跳轉(zhuǎn)到商家網(wǎng)站，把控制權(quán)完全交付商家。商家版路由器、運營版認證網(wǎng)關(guān)(在線)通用n 相關(guān)說明1. 字符編碼: utf-82. 接口采用http協(xié)議get訪問方式3. 認證系統(tǒng)強制用戶跳轉(zhuǎn)到商家網(wǎng)站，把控制權(quán)交給商家n 商家認證接口說明1、 跳轉(zhuǎn)接口：認證系統(tǒng)將強制用戶跳轉(zhuǎn)到商家指定的頁面配置方式：在“商家管理后臺熱點管理認證頁面配置認證配置”頁面中，填寫“認證url”，如注意：url中不能帶任何參數(shù)數(shù)據(jù)處理：后臺將自動在“認證url”后添加參數(shù)，如： &gw_addr=http%3a%2f%2f%3

2、a2060%2fwifidog%2fauth&redirect= http%3a%2f%&clientip=00&clientmac=00:34:d3:34:11:fe&rnd=隨機碼&opkey=md5(rnd&操作驗證碼) 參數(shù)說明：參數(shù)參數(shù)名稱說明商家網(wǎng)站url強制跳轉(zhuǎn)到達的url如gatewayname熱點名稱英文或數(shù)字gw_addr認證設(shè)備的內(nèi)網(wǎng)地址該參數(shù)已通過url編碼redirect跳轉(zhuǎn)前用戶訪問的網(wǎng)址如 該參數(shù)需通過url編碼clientip用戶的ip地址clientmac用戶的mac地址rnd隨機碼檢驗隨機字符串opkey隨機碼和操作驗證碼合并后的md5

3、值2、 授權(quán)接口：商家網(wǎng)站驗證成功后，調(diào)用此接口取授權(quán)令牌提交方式： gatewayname=$gatewayname &action=getoken&rnd=隨機碼&opkey=md5(rnd&操作驗證碼)&username=用戶名&bw_up=$bw_up&bw_down=$bw_down參數(shù)說明：參數(shù)參數(shù)名稱說明gatewayname熱點名稱返回接口1傳遞的 gatewaynameaction動作固定值“getoken”rnd隨機碼返回接口1傳遞的 rndopkey商戶驗證信息rnd和操作驗證碼連接起來進行md5username登錄的用戶名用戶標識bw_up用戶上傳帶寬可選值，留空即不限

4、制，繼承全局值（如有）。單位：kb/sbw_down用戶下載帶寬可選值，留空即不限制，繼承全局值（如有）。單位：kb/s返回結(jié)果：successjdiejskejdkwpokslrmnqwiosdpzei結(jié)果代碼說明error_0操作驗證碼不匹配error_1gatewayname不正確error_2其他參數(shù)為空或不正確error_3未知錯誤，請聯(lián)系管理員success用戶有效，可登錄上網(wǎng)。3、 上網(wǎng)跳轉(zhuǎn)取得token后，商家即可讓客戶跳轉(zhuǎn)到如下頁面開始上網(wǎng)：$gw_addr?token=$token&url=$url參數(shù)參數(shù)名稱說明gw_addr認證設(shè)備的內(nèi)網(wǎng)地址如：:2060接口1取得的值（url解碼）$token授權(quán)令牌接口2取得的值$url用戶自動跳轉(zhuǎn)的地址可以是認證前訪問的網(wǎng)址（接口1中跳轉(zhuǎn)前的網(wǎng)址），也可以是商家指定的網(wǎng)址。注意：網(wǎng)頁白名單中必須加入商家服務(wù)器地址實現(xiàn)