--->非开放性平台php
--->公司内部产品html
接口特色汇总：数据库
一、由于是非开放性的，因此全部的接口都是封闭的，只对公司内部的产品有效；api
二、由于是非开放性的，因此OAuth那套协议是行不通的，由于没有中间用户的受权过程；restful
三、有点接口须要用户登陆才能访问；mvc
四、有点接口不须要用户登陆就可访问；post
针对以上特色，移动端与服务端的通讯就须要2把钥匙，即2个token。加密
第一个token是针对接口的（api_token）；spa
第二个token是针对用户的（user_token）；设计
先说第一个token（api_token）
它的职责是保持接口访问的隐蔽性和有效性，保证接口只能给自家人用，怎么作到？参考思路以下：
如今的接口基本是mvc模式，URL基本是restful风格，URL大致格式以下：
http://blog.snsgou.com/模块名/控制器名/方法名?参数名1=参数值1&参数名2=参数值2&参数名3=参数值3
接口token生成规则参考以下：
api_token = md5 ('模块名' + '控制器名' + '方法名' + '2013-12-18' + '加密密钥') = 770fed4ca2aabd20ae9a5dd774711de2
其中的
一、 '2013-12-18' 为当天时间，
二、'加密密钥' 为私有的加密密钥，手机端须要在服务端注册一个“接口使用者”帐号后，系统会分配一个帐号及密码，数据表设计参考以下：
| 字段名 | 字段类型 | 注释 |
| client_id | varchar(20) | 客户端ID |
| client_secret | varchar(20) | 客户端(加密)密钥 |
（注：只列出了核心字段，其它的再扩展吧！！！）
服务端接口校验，PHP实现流程以下：
01 |
<?php |
02 |
// 一、获取 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 |
// 二、根据客户端传过来的 client_id ，查询数据库，获取对应的 client_secret |
10 |
$client_secret = getClientSecretById($client_id); |
11 |
12 |
// 三、服务端从新生成一份 api_token |
13 |
$api_token_server = md5($module . $controller . $action . date('Y-m-d', time()) . $client_secret); |
14 |
15 |
// 四、客户端传过来的 api_token 与服务端生成的 api_token 进行校对，若是不相等，则表示验证失败 |
16 |
if ($api_token != $api_token_server) { |
17 |
exit('access deny'); // 拒绝访问 |
18 |
} |
19 |
20 |
// 五、验证经过，返回数据给客户端 |
21 |
//。。。 |
22 |
?> |
再说第二个token（user_token）
它的职责是保护用户的用户名及密码屡次提交，以防密码泄露。
若是接口须要用户登陆，其访问流程以下：
一、用户提交“用户名”和“密码”，实现登陆（条件容许，这一步最好走https）；
二、登陆成功后，服务端返回一个 user_token，生成规则参考以下：
服务端用数据表维护user_token的状态，表设计以下：
| 字段名 | 字段类型 | 注释 |
| user_id | int | 用户ID |
| user_token | varchar(36) | 用户token |
| expire_time | int | 过时时间（Unix时间戳） |
（注：只列出了核心字段，其它的再扩展吧！！！）
服务端生成 user_token 后，返回给客户端（本身存储），客户端每次接口请求时，若是接口须要用户登陆才能访问，则须要把 user_id 与 user_token 传回给服务端，服务端接受到这2个参数后，须要作如下几步：
一、检测 api_token的有效性；
二、删除过时的 user_token 表记录；
三、根据 user_id，user_token 获取表记录，若是表记录不存在，直接返回错误，若是记录存在，则进行下一步；
四、更新 user_token 的过时时间（延期，保证其有效期内连续操做不掉线）；
五、返回接口数据；
接口用例以下：
一、发布日志
URL： http://blog.snsgou.com/blog/Index/addBlog?client_id=wt3734wy636dhd3636sr5858t6&api_token=880fed4ca2aabd20ae9a5dd774711de2&user_token=etye0fgkgk4ca2aabd20ae9a5dd77471fgf&user_id=12
请求方式： POST
POST参数：title=我是标题&content=我是内容
返回数据：
{ 'code' => 1, // 1:成功 0:失败 'msg' => '操做成功' // 登陆失败、无权访问 'data' => [] }