接口特點(diǎn)匯總:
1兑巾、因?yàn)槭欠情_放性的忠荞,所以所有的接口都是封閉的蒋歌,只對公司內(nèi)部的產(chǎn)品有效委煤;
2、因?yàn)槭欠情_放性的府框,所以O(shè)Auth那套協(xié)議是行不通的讥邻,因?yàn)闆]有中間用戶的授權(quán)過程院峡;
3系宜、有點(diǎn)接口需要用戶登錄才能訪問照激;
4盹牧、有點(diǎn)接口不需要用戶登錄就可訪問;
針對以上特點(diǎn)口柳,移動(dòng)端與服務(wù)端的通信就需要2把鑰匙踩寇,即2個(gè)token。
第一個(gè)token是針對接口的(api_token)俺孙;
第二個(gè)token是針對用戶的(user_token);
先說第一個(gè)token(api_token)
它的職責(zé)是保持接口訪問的隱蔽性和有效性荣茫,保證接口只能給自家人用场靴,怎么做到伟葫?參考思路如下:
現(xiàn)在的接口基本是mvc模式,URL基本是restful風(fēng)格宪郊,URL大體格式如下:
http://blog.snsgou.com/模塊名/控制器名/方法名?參數(shù)名1=參數(shù)值1&參數(shù)名2=參數(shù)值2&參數(shù)名3=參數(shù)值3
接口token生成規(guī)則參考如下:
api_token = md5 ('模塊名' + '控制器名' + '方法名' + '2013-12-18' + '加密密鑰') = 770fed4ca2aabd20ae9a5dd774711de2
其中的?
1膘盖、 '2013-12-18' 為當(dāng)天時(shí)間,
2蚌父、'加密密鑰' 為私有的加密密鑰,手機(jī)端需要在服務(wù)端注冊一個(gè)“接口使用者”賬號(hào)后喝滞,系統(tǒng)會(huì)分配一個(gè)賬號(hào)及密碼,數(shù)據(jù)表設(shè)計(jì)參考如下:
字段名字段類型注釋
client_idvarchar(20)客戶端ID
client_secretvarchar(20)客戶端(加密)密鑰
(注:只列出了核心字段右遭,其它的再擴(kuò)展吧!@暄荨!)
服務(wù)端接口校驗(yàn),PHP實(shí)現(xiàn)流程如下:
01
02// 1吨拗、獲取 GET參數(shù) 值
03$module=?$_GET['mod'];
04$controller=?$_GET['ctl']
05$action=?$_GET['act'];
06$client_id=?$_GET['client_id'];
07$api_token=?$_GET[''api_token];
08?
09// 2劝篷、根據(jù)客戶端傳過來的 client_id 哨鸭,查詢數(shù)據(jù)庫娇妓,獲取對應(yīng)的 client_secret
10$client_secret= getClientSecretById($client_id);
11?
12// 3、服務(wù)端重新生成一份 api_token
13$api_token_server= md5($module.?$controller.?$action.??date('Y-m-d', time()) .??$client_secret);
14?
15// 4只估、客戶端傳過來的 api_token 與服務(wù)端生成的 api_token 進(jìn)行校對着绷,如果不相等,則表示驗(yàn)證失敗
16if($api_token!=?$api_token_server) {
17????exit('access deny');??// 拒絕訪問
18}
19?
20// 5荠医、驗(yàn)證通過,返回?cái)?shù)據(jù)給客戶端
21//兼贡。娃胆。。
22?>
再說第二個(gè)token(user_token)
它的職責(zé)是保護(hù)用戶的用戶名及密碼多次提交缕棵,以防密碼泄露。
如果接口需要用戶登錄招驴,其訪問流程如下:
1、用戶提交“用戶名”和“密碼”虱饿,實(shí)現(xiàn)登錄(條件允許,這一步最好走h(yuǎn)ttps)氮发;
2、登錄成功后仇祭,服務(wù)端返回一個(gè) user_token颈畸,生成規(guī)則參考如下:
服務(wù)端用數(shù)據(jù)表維護(hù)user_token的狀態(tài),表設(shè)計(jì)如下:
字段名字段類型注釋
user_idint用戶ID
user_tokenvarchar(36)用戶token
expire_timeint過期時(shí)間(Unix時(shí)間戳)
(注:只列出了核心字段眯娱,其它的再擴(kuò)展吧!J曰铩!)
服務(wù)端生成 user_token 后疏叨,返回給客戶端(自己存儲(chǔ))百宇,客戶端每次接口請求時(shí),如果接口需要用戶登錄才能訪問携御,則需要把 user_id 與 user_token 傳回給服務(wù)端,服務(wù)端接受到這2個(gè)參數(shù)后涮坐,需要做以下幾步:
1誓军、檢測 api_token的有效性;
2昵时、刪除過期的 user_token 表記錄;
3救巷、根據(jù) user_id,user_token 獲取表記錄浦译,如果表記錄不存在,直接返回錯(cuò)誤精盅,如果記錄存在,則進(jìn)行下一步妻枕;
4她肯、更新 user_token 的過期時(shí)間(延期,保證其有效期內(nèi)連續(xù)操作不掉線)晴氨;
5碉输、返回接口數(shù)據(jù);
接口用例如下:
1枝哄、發(fā)布日志
URL: ?http://blog.snsgou.com/blog/Index/addBlog?client_id=wt3734wy636dhd3636sr5858t6&api_token=880fed4ca2aabd20ae9a5dd774711de2&user_token=etye0fgkgk4ca2aabd20ae9a5dd77471fgf&user_id=12
請求方式: ?POST
POST參數(shù):title=我是標(biāo)題&content=我是內(nèi)容
返回?cái)?shù)據(jù):
{
'code' => 1, // 1:成功 0:失敗
'msg' => '操作成功' // 登錄失敗阻荒、無權(quán)訪問
'data' => []
}