接口设计规范及测试

RESTful API设计规范

为什么会有RESTFUL API

前端设备层出不穷（手机、平板、桌面电脑、其他专用设备……），促使前后端分离，方便不同的前端设备与后端进行通信，导致API架构的流行。

RESTful架构，因结构清晰、符合标准、易于理解、扩展方便，是目前流行的一种互联网软件架构。

RESTful API是目前比较成熟的一套互联网应用程序的API设计理论。

RESTful API目标

1、完成前后端分离

2、不同类型前端设备共用一套接口

3、统一接口规范（post、put、get、patch、delete）

4、尽可能的缩小沟通的成本，开最少的会，确定大部分的事。

5、花最少的时间写文档，保证90%的开发人员看懂所有内容。

6、哪怕不看文档，也能知道各种接口逻辑。

什么是REST？

由Roy Thomas Fielding在他2000年的博士论文中提出：
       在符合架构原理的前提下，理解和评估以网络为基础的应用软件的架构设计，得到一个功能强、性能好、适宜通信的架构。

他对互联网软件的架构原则，定名为REST。

如何理解REST

REST是一种架构风格，其核心是面向资源。

REST提出设计概念和准则为：

1. 网络上的所有事物都可以被抽象为资源(resource)

2. 每一个资源都有唯一的资源标识(resource identifier)，对资源的操作不会改变这些标识

3. 所有的操作都是无状态的

---

REST= Representation + State + Transfer 表现层状态转化

资源在网络中以某种表现形式进行状态转移：
          Resource&#x