Restful规范(概念)

2023-12-20 18:34:53

在前后端分离的应用项目模式中,后端需要提供API接口,REST就是适用这种模式的API接口的设计风格。REST全称是Representational State Transfer,表征性状态转移。

十条规范

1.数据的安全保障

url链接一般采用https协议进行传输

2.接口特征表现

在API地址中带接口标识,咱们一般放在地址栏中(放在域名中)

https://api.baidu.com
https://www.baidu.com/api

3.多版本共存:在url链接中带版本标识

-https://api.weibo.com/2/
-https://api.weibo.com/v2/
-https://api.weibo.com/?version=2
-https://api.weibo.com/v1/login ?--->需要的参数name和pwd
-https://api.weibo.com/v2/login --->需要的参数name和pwd和code

4.数据即是资源,均使用名词(可复数)

前后端交互的数据我们称之为资源

?-https://127.0.0.1/api/v1/users
-https://127.0.0.1/api/v1/get_users ?# 不符合规范

5.资源操作由请求方式决定(method)

?? ?-获取资源用get
? ? -新增资源用post
? ? -修改资源使用put
? ? -删除资源使用delete
? ? https://api.baidu.com/books ? ? ?- get请求:获取所有书
? ? https://api.baidu.com/books/1 ? ?- get请求:获取主键为1的书
? ? https://api.baidu.com/books ? ? ?- post请求:新增一本书书
? ? https://api.baidu.com/books/1 ? ?- put请求:整体修改主键为1的书
? ? https://api.baidu.com/books/1 ? ?- patch请求:局部修改主键为1的书
? ? https://api.baidu.com/books/1 ? ?-delete请求:删除主键为1的书

6.url中带搜索或者过滤条件? ? ??

https://api.example.com/v1/zoos?name=猴子 get请求

7.响应状态码

响应中带状态码

http响应状态码:1xx,2xx,3xx,4xx,5xx

自己定制的状态码(用的多): 100成功,每个公司有的不一样

8.返回中带错误信息

{code:100,msg:成功}

9.返回结果,符合以下规范

GET /collection:返回资源对象的列表(数组) ? ? ? [{name:xx,age:19},{name:xx,age:19},{}]
GET /collection/resource:返回单个资源对象 ? ? ? ?{name:xx,age:19}
POST /collection:返回新生成的资源对象 ? ? ? ? ? ? {name:yy,age:19}
PUT /collection/resource:返回完整的资源对象 ? ? ? {name:xx,age:20}
PATCH /collection/resource:返回完整的资源对象 ? ? {name:xx,age:20}
DELETE /collection/resource:返回一个空文档 ? ? ? ?

10.返回数据中带url链接

"url": "http://blog.sina.com.cn/zaku",

文章来源:https://blog.csdn.net/flclyz/article/details/135111210
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。