針對
--->非開放性平台
--->公司內部產品
介面特點彙總:
1、因為是非開放性的,所以所有的介面都是封閉的,只對公司內部的產品有效;
2、因為是非開放性的,所以oauth那套協議是行不通的,因為沒有中間使用者的授權過程;
3、有點介面需要使用者登入才能訪問;
4、有點介面不需要使用者登入就可訪問;
針對以上特點,移動端與服務端的通訊就需要2把鑰匙,即2個token。
第乙個token是針對介面的(api_token);
第二個token是針對使用者的(user_token);
先說第乙個token(api_token)
它的職責是保持介面訪問的隱蔽性和有效性,保證介面只能給自家人用,怎麼做到?參考思路如下:
按伺服器端和客戶端都擁有的共同屬性生成乙個隨機串,客戶端生成這個串,伺服器也按同樣演算法生成乙個串,用來校驗客戶端的串。
現在的介面基本是mvc模式,url基本是restful風格,url大體格式如下:
模組名/控制器名/方法名?引數名1=引數值1&引數名2=引數值2&引數名3=引數值3
介面token生成規則參考如下:
api_token = md5 ('模組名' + '控制器名' + '方法名' + '2013-12-18' + '加密金鑰') = 770fed4ca2aabd20ae9a5dd774711de2
其中的
1、 '2013-12-18' 為當天時間,
2、'加密金鑰' 為私有的加密金鑰,手機端需要在服務端註冊乙個「介面使用者」賬號後,系統會分配乙個賬號及密碼,資料表設計參考如下:
欄位名字段型別
注釋client_id
varchar(20)
客戶端id
client_secret
varchar(20)
客戶端(加密)金鑰
(注:只列出了核心字段,其它的再擴充套件吧!!!)
服務端介面校驗,php實現流程如下:
01
<?php
02
// 1、獲取 get引數 值
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、根據客戶端傳過來的 client_id ,查詢資料庫,獲取對應的 client_secret
10
$client_secret
= getclientsecretbyid(
$client_id
);
11
12
// 3、服務端重新生成乙份 api_token
13
$api_token_server
= md5(
$module
.
$controller
.
$action
.
date
(
'y-m-d'
, time()) .
$client_secret
);
14
15
// 4、客戶端傳過來的 api_token 與服務端生成的 api_token 進行校對,如果不相等,則表示驗證失敗
16
if
(
$api_token
!=
$api_token_server
)
19
20
// 5、驗證通過,返回資料給客戶端
21
//。。。
22
?>
再說第二個token(user_token)
它的職責是保護使用者的使用者名稱及密碼多次提交,以防密碼洩露。
如果介面需要使用者登入,其訪問流程如下:
1、使用者提交「使用者名稱」和「密碼」,實現登入(條件允許,這一步最好走https);
2、登入成功後,服務端返回乙個 user_token,生成規則參考如下:
user_token = md5('使用者的uid' + 'unix時間戳') = etye0fgkgk4ca2aabd20ae9a5dd77471fgf
服務端用資料表維護user_token的狀態,表設計如下:
欄位名字段型別
注釋user_id
int使用者id
user_token
varchar(36)
使用者token
expire_time
int過期時間(unix時間戳)
(注:只列出了核心字段,其它的再擴充套件吧!!!)
服務端生成 user_token 後,返回給客戶端(自己儲存),客戶端每次介面請求時,如果介面需要使用者登入才能訪問,則需要把 user_id 與 user_token 傳回給服務端,服務端接受到這2個引數後,需要做以下幾步:
1、檢測 api_token的有效性;
2、刪除過期的 user_token 表記錄;
3、根據 user_id,user_token 獲取表記錄,如果表記錄不存在,直接返回錯誤,如果記錄存在,則進行下一步;
4、更新 user_token 的過期時間(延期,保證其有效期內連續操作不掉線);
5、返回介面資料;
介面用例如下:
1、發布日誌
url: blog/index/addblog?client_id=wt3734wy636dhd3636sr5858t6&api_token=880fed4ca2aabd20ae9a5dd774711de2&user_token=etye0fgkgk4ca2aabd20ae9a5dd77471fgf&user_id=12
請求方式: post
post引數:title=我是標題&content=我是內容
返回資料:
延伸閱讀:
移動端與php服務端介面通訊流程設計(增強版)
移動端與PHP服務端介面通訊流程設計 基礎版
非開放性平台 公司內部產品 介面特點彙總 1 因為是非開放性的,所以所有的介面都是封閉的,只對公司內部的產品有效 2 因為是非開放性的,所以oauth那套協議是行不通的,因為沒有中間使用者的授權過程 3 有點介面需要使用者登入才能訪問 4 有點介面不需要使用者登入就可訪問 針對以上特點,移動端與服務...
移動端與PHP服務端介面通訊流程設計 基礎版
非開放性平台 公司內部產品 介面特點彙總 1 因為是非開放性的,所以所有的介面都是封閉的,只對公司內部的產品有效 2 因為是非開放性的,所以oauth那套協議是行不通的,因為沒有中間使用者的授權過程 3 有點介面需要使用者登入才能訪問 4 有點介面不需要使用者登入就可訪問 針對以上特點,移動端與服務...
移動端與PHP服務端介面通訊流程設計 基礎版
針對 非開放性平台 公司內部產品 介面特點彙總 1 因為是非開放性的,所以所有的介面都是封閉的,只對公司內部的產品有效 2 因為是非開放性的,所以oauth那套協議是行不通的,因為沒有中間使用者的授權過程 3 有點介面需要使用者登入才能訪問 4 有點介面不需要使用者登入就可訪問 針對以上特點,移動端...