Django(43)restful接口规范
2021-06-03 13:21
726 查看
restful接口规范
什么是接口规范?接口规范就是为了采用
不同的后台语言,也能使用同样的接口获取到
同样的数据。如何写接口:接口规范是规范化书写接口的,写接口要写
url、响应数据 注:如果将请求参数也纳入考量范围,那就是在写接口文档
url
restful接口的
url规范,遵循以下6个规范
1.用关键字标识接口url
比如登录的接口,可以用下面的
url,这样我们阅读的时候,一眼就能看出这个是登录接口
www.baidu.com/login/
注意:我们的URI不应该使用动作来描述,比如createUser
2.接口数据安全性决定优先选择https协议
3.如果一个接口有多版本存在,需要在url中标识体现
假如我们刚开发一个后台,那第一个版本就是
v1
api.baidu.com/v1/
后面接口需要升级,那么就将接口升级为
v2
api.baidu.com/v2/
4.接口操作的数据源称之为资源,在url中一般采用资源复数形式,一个接口可以概括对该资源的多种操作方式
获取全部书籍
api.baidu.com/books
获取指定的书籍
api.baidu.com/books/(pk)
5.请求方式有很多种,用一个url处理如何保证不混乱 - 通过请求方式标识操作资源的方式
获取所有书籍,使用
get请求
/books/
增加一本书籍,使用
post请求
/books/
删除一本书籍,使用
delete请求
/books/(pk)
整体更新一本书籍的内容,使用
put请求
/books/(pk)
局部更新一本书籍的一个字段,使用
patch请求
/books/(pk)
6.资源往往涉及数据的各种操作方式 - 筛选、排序、限制
api.baidu.com/books/?search=jkc&ordering=price&limit=3
响应数据
响应数据遵循以下4个规范
1.http请求的响应会有响应状态码,接口用来返回操作的资源数据,可以拥有操作数据结果的状态码
status 0(操作资源成功) 1(操作资源失败) 2(操作资源成功,但没匹配结果)
注:资源状态码不像
http状态码,一般是后台与前台或者是客户约定的
2. 资源的状态码文字提示
status ok '账号有误' '密码有误' '用户锁定'
3. 资源本身
data: { 业务数据 }
4. 不能直接返回的资源(子资源、图片、视频等资源),返回该资源的url链接
相关文章推荐
- RESTful 接口规范
- RESTful 接口规范
- 关于RESTful一些注意事项,和自己整理的接口开发规范
- DjangoRestFramework学习一之restful规范、APIview、解析器组件、Postman等
- RESTful 接口规范
- 无规矩不成方圆,聊一聊 Spring Boot 中 RESTful 接口设计规范
- 微服务RESTful 接口设计规范
- 了解什么是RESTful 接口规范
- restful接口规范
- “安居客“住房系统-基于Python-Django前后端分离开发(二)——基于RESTful架构的数据接口配置以及Redis高速缓存
- lement-ui、接口、restful规范、drf
- Restful是一种非常优美的http接口设计风格及设计规范
- 初识web API接口及Restful接口规范
- 从Feign使用注意点到RESTFUL接口设计规范
- RESTful接口API设计规范
- 接口开发规范 restful接口开发规范
- 关于RESTful一些注意事项,和自己整理的接口开发规范
- RESTful 接口规范
- 关于RESTful一些注意事项,和自己整理的接口开发规范
- RESTful 接口规范