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:删除一个订单