1. 什么是RESTful API?
1.1 RESTful API
RESTful API 就是按照 REST 架构的 API 方案
提出者(也是http协议联合创始人):
1.2 REST 架构
前提:一切皆资源、基于http (一切可感知的事务)
限制条件:无状态 (在服务器存储是无状态的)
优势:利用http 可以使用http的method:get、post、put、delete…
在REST架构下把他们全部(图片、文本、网页、数据等等)理解为资源,不同的架构有不同的战略出发点
1.3 REST 中文含义
Representational State Transfer
资源表征状态转移
2. RESTful API 是如何定义的?
2.1 RESTful API 如何设计
网址:https://reqres.in/
这里面明确了CRUD的各个接口定义规范,以及请求返回的状态码的定义规范
2.2 C-创建
请求方式:post
request:将model使用复数形式,可以理解为该model为一个整体的仓库
response: 状态码 201,代表创建成功(这个不一定照搬,根据实际情况使用)
2.2 R-读取
2.2.1 有返回结果
请求方式:get
request:将model使用复数形式,可以理解为该model为一个整体的仓库,指定过滤条件为 page=2
response: 状态码 200,代表查询成功(这个不一定照搬,根据实际情况使用)
2.2.2 无返回结果
请求方式:get
request:将model使用复数形式,可以理解为该model为一个整体的仓库,指定过滤条件为23
response: 状态码 404,代表查询成功无返回值(这个不一定照搬,根据实际情况使用)
2.3 U-更新
请求方式:put
request:将model使用复数形式,可以理解为该model为一个整体的仓库,指定过滤条件为2
response: 状态码 200,代表更新成功(这个不一定照搬,根据实际情况使用)
请求方式:delete
request:将model使用复数形式,可以理解为该model为一个整体的仓库,指定过滤条件为2
response: 状态码 204,代表指定资源删除成功(这个不一定照搬,根据实际情况使用)