API设计资料整理

API

API管理工具

目前管理方式: postman+apizza (postman 数据可以导入其他平台 + apizza可在线分享)

期望找到WEB管理平台

  1. API可以导出文档(markdown html word)
  2. API可以匿名访问
  3. 可导入postman 可导出postman
  4. 协作处理
  5. 自动测试

试用体验产品

eolinker, 不可匿名访问, 导出数据只能为eolinker格式的

YApi 功能过于简单

v2ex站看到-DOClever

接口认证

OAuth 2.0 oauth-php

自定服务与客户端相同算法认证

        // 签名认证 
            $signature = $this->request ( "signature" ); // app端生成的签名
            $token = $this->request ( "token" ); // app端生成的随机字符串

            if (! $signature || ! $token) {
                $this->wrong ( '缺少参数' );
            }

            $signature1 = md5 ( sha1 ( $token ) . C ( "SIGN_KEY" ) );

            if ($signature != $signature1) {
                $this->wrong ( '非法调用' );
            }

URL方式

RESTful [RESTful API 设计指南]

API版本管理

使用域名,如 v1.api.bugtags.com 来区分接口的版本

将版本信息放到 url 的 pathinfo 中,如 api.bugtags.com/v1/

将版本信息放到请求参数中,如 api.bugtags.com/user/1?_ver=1.0.1

将版本信息放到 http header 中,如 API_VER: 1.0.1

数据传输加密

https

相关API设计文章

API设计和代码结构组织

linux-sources.list

ubuntu16.04阿里云源

  deb http://mirrors.aliyun.com/ubuntu/ xenial main restricted universe multiverse
  deb http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted universe multiverse
  deb http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted universe multiverse
  deb http://mirrors.aliyun.com/ubuntu/ xenial-proposed main restricted universe multiverse
  deb http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse
  deb-src http://mirrors.aliyun.com/ubuntu/ xenial main restricted universe multiverse
  deb-src http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted universe multiverse
  deb-src http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted universe multiverse
  deb-src http://mirrors.aliyun.com/ubuntu/ xenial-proposed main restricted universe multiverse
  deb-src http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse

Continue reading “linux-sources.list”

每日英语

刷刷reddit金山词霸微博话题_每日英语

TED-中英双字幕

英语四级(大学校内才可考) 425为及格 总分 710

本页地址-微博短连接 http://t.cn/RCDGY0G

#每日英语 2018年2月12日08:57:23#
Nobody can go back and start a new begining, but anyone can start today and make a new ending.[没有人可以回到过去从头再来, 但是每个人都可以从今天开始, 创造一个全新的结局.]

Continue reading “每日英语”

ecshop安装出现appserver不存在

解决方法

路径中文件夹的名字不能重复

wwwroot/ecshop/source/shop

wwwroot/ecshop/source/appserver

上面有两个ecshop文件夹名字只要把上面的末尾shop改成如下名字即可, 具体原因详见下面 <调试过程>

wwwroot/ecshop/source/web

wwwroot/ecshop/source/appserver

Continue reading “ecshop安装出现appserver不存在”

利用vbox搭建WEB环境并共享windows文件夹

需求

由于开发环境为windows上传到线上总出现这样或那么的问题为了实现与线上环境相同又可以使用windows下的开发工具,使用vbox搭建web环境,然后通过共享文件夹把程序代码挂载到vbox中的liunx环境里, 来实现与线上环境相同.

Continue reading “利用vbox搭建WEB环境并共享windows文件夹”