1分种读懂 RESTful API 到底是什么?

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,代表指定资源删除成功(这个不一定照搬,根据实际情况使用)

发布了10 篇原创文章 · 获赞 5 · 访问量 369

猜你喜欢

转载自blog.csdn.net/wanglei19891210/article/details/105087233
今日推荐