RESTful风格理解

RESTful介绍

RESTful是一种常见的REST应用,是遵循REST风格的web服务,REST式的web服务是一种ROA(面向资源的架构)。

简单的说:RESTful是一种架构的规范与约束、原则,符合这种规范的架构就是RESTful架构。

Restful风格api的特征

1)基于“资源”,数据也好、服务也好,在RESTFul设计里一切都是资源: URL中不能有动词,都是名词.
2)无状态。一次调用一般就会返回结果,不存在类似于“打开连接-访问数据-关闭连接”这种依赖于上一次调用的情况。http请求一样
3)URL中通常不出现动词,只有名词
4)URL语义清晰、明确
5)使用HTTP的GET(获取)、POST(创建)、DELETE(删除)、PUT(更新)来表示对于资源的增删改查
6)出参使用JSON不使用XML.

7)URL中首先小写字母。

8)URL路径名词均为复数

7)可选:HTTP状态码,在REST中都有特定的意义:200,201,202,204,400,401,403,500。比如401表示用户身份认证失败,403表示你验证身份通过了,但这个资源你不能操作。

常见RestFul风格的api示例

http://api.config.net.cn/v1/books //GET: 获取所有书籍

http://api.config.net.cn/v1/books?page=2&page_size=10 //GET: 获取每页10条第二页中的书籍

http://api.config.net.cn/v1/books/ID //GET:获取指定Id的书

http://api.config.net.cn/v1/orders/2021/06/28 //GET:2021-6-28日的订单

http://api.config.net.cn/v1/orders //POST: 创建一个订单

http://api.config.net.cn/v1/books //PUT: 更新一个书籍

http://api.config.net.cn/v1/orders/20210628 //DELETE:删除一个订单

posted @ 2021-08-12 10:35  RealGang  阅读(227)  评论(0编辑  收藏  举报