移動端與PHP服務端介面通訊流程設計 基礎版

2021-07-09 20:48:56 字數 3875 閱讀 5870

針對

--->非開放性平台

--->公司內部產品

介面特點彙總:

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 進行校對,如果不相等,則表示驗證失敗

16if($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 有點介面不需要使用者登入就可訪問 針對以上特點,移動端...