Restful API与传统API设计区别:
1、不使用url参数:
传统API设计:/api/list?pageIndex=2
Restful API设计:/api/list/2
2、用method表示操作类型
传统API设计:
post请求: /api/create-blog
post请求:/api/update-blog?id=100
get请求:/api/get-blog?id=100
Restful API设计:
post请求: /api/blog
post请求:/api/blog/100
get请求:/api/blog/100
3、传统API设计:把每个url当做一个功能
Restful API设计:把每个url当做一个唯一的资源
简单说Restful API就是API的规范。
目的:
1、为了实现前后端分离。
2、减少沟通成本,让API通俗易懂,提高API的可读性。
3、多端公用一套接口
在 REST 架构风格中,每一个 URI 代表一种资源。因此,URI 是每一个资源的地址的唯一资源定位符。所谓资源,实际上就是一个信息实体,它可以是服务器上的一段文本、一个文件、一张图片、一首歌曲,或者是一种服务。RESTful API 规定了通过 GET、 POST、 PUT、 PATCH、 DELETE 等方式对服务端的资源进行操作。
GET /zoos:列出所有动物园
POST /zoos:新建一个动物园
GET /zoos/ID:获取某个指定动物园的信息
PUT /zoos/ID:更新某个指定动物园的信息(提供该动物园的全部信息)
PATCH /zoos/ID:更新某个指定动物园的信息(提供该动物园的部分信息)
DELETE /zoos/ID:删除某个动物园
GET /zoos/ID/animals:列出某个指定动物园的所有动物
DELETE /zoos/ID/animals/ID:删除某个指定动物园的指定动物