API接口TOKEN设计

首先须要知道API是什么？

 

API（Application Programming Interface）即应用程序接口。你能够认为 API 是一个软件组件或是一个 Web 服务与外界进行的交互的接口。而咱们在这里要谈论的，是做为一家公司如何跟外界进行交互。从另外一个角度来讲，API 是一套协议，规定了咱们与外界的沟通方式：如何发送请求和接收响应。

 

API的特色：

 

　　一、由于是非开放性的，因此全部的接口都是封闭的，只对公司内部的产品有效；

 

　　二、由于是非开放性的，因此OAuth那套协议是行不通的，由于没有中间用户的受权过程；

 

　　三、接口分为须要用户登陆才能访问的和不须要用户登陆就可访问的；

 

针对以上特色，移动端与服务端的通讯就须要两种不一样的TOKEN，一种针对接口的api_token,一种针对用户的user_token;

 

一.api_token

 

　　 它的职责是保持接口访问的隐蔽性和有效性，保证接口只有可信任的来源才能够访问，参考思路以下：

 

　　按服务器端和客户端都拥有的共同属性生成一个随机串，客户端生成这个串，服务器也按一样算法生成一个串，用来校验客户端的串。

 

　　如今的接口基本是mvc模式，URL基本是restful风格，URL大致格式以下：

 

　　http://www.api.com/模块名/控制器名/方法名?参数名1=参数值1&参数名2=参数值2

 

　　接口token生成规则参考以下：

 

　　　　$api_token = md5 ('模块名' + '控制器名' + '方法名' + '2018-1-18' + '加密密钥') = 789fed3842aabd834e9a5dd7735532de2

 

　　　　1.'2018-1-18' 为当天时间

 

　　　　2.'加密密钥'为私有的加密密钥，手机端须要在服务端注册一个“接口使用者”帐号后，系统会分配一个帐号及密码，数据表设计参考以下：

 

　　　　　　字段名及字段类型

 

　　　　　　　

?

1 2 3

client_id  varchar(20) 客户端ID   client_secret varchar(20) 客户端(加密)密钥

　　

 

　　　　　　服务端接口校验，PHP实现流程以下：

 

<?php
 
    //获取GET参数值
 
    $module = $_GET['module']; $controller = $_GET['controller'] $action = $_GET['action']; $client_id = $_GET['client_id']; $api_token = $_GET[''api_token]; //根据客户端传过来的client_id，查询数据库，获取对应的client_secret
 
    $client_secret = getClientSecret($client_id); //服务端从新生成一个api_token
 
    $api_token_server = md5($module . $controller . $action . date('Y-m-d', time()) . $client_secret); //客户端传过来的api_token与服务端生成的api_token进行校对，若是不相等，则表示验证失败
 
    if ($api_token != $api_token_server) { exit('access deny'); //拒绝访问
 } //验证经过，返回数据给客户端
 
?>    

 

 

二.user_token

 

　　 它的职责是保护用户的用户名及密码屡次提交，以防密码泄露。

 

　　若是接口须要用户登陆，其访问流程以下：

 

　　　　一、用户提交“用户名”和“密码”，实现登陆（条件容许，这一步最好走https）；

 

　　　　二、登陆成功后，服务端返回一个user_token，生成规则参考以下：

 

　　　　　　user_token = md5('用户的uid' + 'Unix时间戳') = etye0fgkgk4ca2ttdsl0ae9a5dd77471fgf

 

　　　　　　服务端用数据表维护user_token的状态，表设计以下：

 

　　　　　　字段名及字段类型以下：

 

　　　　　　　　

?

1 2 3 4 5

user_id int(11) 用户ID   user_token varchar(36) 用户token   expire_time int 过时时间（Unix时间戳）

　　

 

　　服务端生成user_token后，返回给客户端（本身存储），客户端每次接口请求时，若是接口须要用户登陆才能访问，则须要把 user_id与user_token传回给服务端，服务端接受到这2个参数后，须要作如下几步：

 

　　　　   一、检测user_token的有效性；

 

　　　　二、删除过时的user_token表记录；

 

　　　　三、根据user_id，user_token 获取表记录，若是表记录不存在，直接返回错误，若是记录存在，则进行下一步；

 

　　　　四、更新user_token 的过时时间（延期，保证其有效期内连续操做不掉线）；

 

　　　　五、返回接口数据；

 

接口用例以下：添加测试接口

 

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

URL： http: //www.api.com/demo/index/add-demo?client_id=wt373uesksklwkskx36sr5858t6&api_token=880fed4ca2aabd20ae9eessa74711de2&user_token=etye0fgkgk4ca2asehxlejeje5dd77471fgf&user_id=12    请求方式： POST    POST参数：title=哈喽&content=个人世界    返回数据：    {         'code' => 1, // 1:成功 0:失败         'msg' => '成功/失败，无权访问'         'data' => []    }