zoukankan      html  css  js  c++  java
  • api接口

    接口特点汇总:


    1、因为是非开放性的,所以所有的接口都是封闭的,只对公司内部的产品有效;

    2、因为是非开放性的,所以OAuth那套协议是行不通的,因为没有中间用户的授权过程;

    3、有点接口需要用户登录才能访问;

    4、有点接口不需要用户登录就可访问;

    PHP Token(令牌)

    针对以上特点,移动端与服务端的通信就需要2把钥匙,即2个token。

    第一个token是针对接口的(api_token);
    第二个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
    其中的 
    1、 '2013-12-18' 为当天时间,
    2、'加密密钥' 为私有的加密密钥,手机端需要在服务端注册一个“接口使用者”账号后,系统会分配一个账号及密码,数据表设计参考如下:
    字段名 字段类型 注释 
    client_id varchar(20) 客户端ID 
    client_secret varchar(20) 客户端(加密)密钥 

    服务端接口校验,PHP实现流程如下:

    [python] view plain copy 在CODE上查看代码片派生到我的代码片
    1. 服务端接口校验,PHP实现流程如下:  
    2. <?php   
    3. // 1、获取 GET参数 值   
    4. $module = $_GET['mod']; $controller = $_GET['ctl']   
    5. $action = $_GET['act']; $client_id = $_GET['client_id'];   
    6. $api_token = $_GET['api_token‘];   
    7. // 2、根据客户端传过来的 client_id ,查询数据库,获取对应的 client_secret   
    8. $client_secret = getClientSecretById($client_id);   
    9. // 3、服务端重新生成一份 api_token   
    10. $api_token_server = md5($module . $controller . $action .  date('Y-m-d', time()) .  $client_secret);   
    11. // 4、客户端传过来的 api_token 与服务端生成的 api_token 进行校对,如果不相等,则表示验证失败   
    12. if ($api_token != $api_token_server) {   
    13.     exit('access deny');  // 拒绝访问 } // 5、验证通过,返回数据给客户端    
    14. ?>  

    再说第二个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、返回接口数据;

    接口用例如下:

    请求方式:  POST
    POST参数:title=我是标题&content=我是内容
    返回数据:
    {
           'code' => 1, // 1:成功 0:失败
          'msg' => '操作成功' // 登录失败、无权访问
          'data' => []
     }


    PHP Token(令牌)-相关链接

    [python] view plain copy 在CODE上查看代码片派生到我的代码片
    1. http://www.jb51.net/article/13756.htm  
    2.   
    3. http://wenku.baidu.com/view/8f4d96ddfab069dc5022014f.html?re=view 
  • 相关阅读:
    maven打包额外的资源文件
    阿里巴巴的程序员等级
    sql是最成功的第四代语言
    nginx的配置与应用
    浏览器的同源策略与跨域问题的解决方案
    算法:二分查找(基础)
    动态类型语言和静态类型语言
    【VS开发】单文档中往视图中加入控件
    【VS开发】使用VS2010创建MFC ActiveX工程项目
    【VS开发】使用VS2010创建MFC ActiveX工程项目
  • 原文地址:https://www.cnblogs.com/nuanxin/p/5946931.html
Copyright © 2011-2022 走看看