你需要知道的Restful API到底是什么？

你见过的接口是不是一般长这个样子

GET https://www.xxx.com/api/v4/articles/comments?order=12345

POST https://www.xxx/corp/dept -d "id=1593567812715112930"

GET https://www.xxx.com/api/v3/slive/materiel/getStickers?type=20&id=675

那这样的接口你见过吗？

PUT https://www.xxx/corp/dept/ {"deptName":"米其林","parentDeptId":"1656489546542150255"}

POST https://www.xxx/corp/dept/1593567812715112930

DELETE https://www.xxx/corp/dept/1593567812715112930

GET https://www.xxx/corp/dept/1593567812715112930/1652693969591146437

类似上面这样的接口，我们可一眼看出它就是Restful API。

简单理解来讲，Restful API，就是一种接口设计风格。与编程无关，与平台无关。

现在，让我们来理解一下它的架构：

1.什么是REST

REST全称是Representational State Transfer，中文意思是：性状态转移。

REST指的是一组架构约束条件和原则。如果一个架构符合REST的约束条件和原则，我们就称它为RESTful架构。它的特点有：

• 每一个URI代表一种资源，独一无二；
• 客户端和服务器之间，传递这种资源的某种表现层；
• 客户端通过HTTP动词，对服务器端资源进行操作，实现"表现层状态转化"。

2.为什么要使用RESTful风格？它的优势有什么？

它的优势有：

• 前后端分离，减少流量；
• 前端无关化，后端只负责数据处理；
• 由于接受json格式，防止了注入型等安全问题；
• 服务器性能优化。

3.RESTful API设计规范是什么样的？

通常一个RESTful API的path组成如下：

/{version}/{resources}/{resource_id}

version：API版本号，有些版本号放置在头信息中也可以，通过控制版本号有利于应用迭代。

resources：资源，RESTful API推荐用小写英文单词的复数形式。

resource_id：资源的id，访问或操作该资源。

当然，有时候可能资源级别较大，其下还可细分很多子资源也可以灵活设计URL的path，例如：

/{version}/{resources}/{resource_id}/{subresources}/{subresource_id}

另外还有一些URI设计技巧，如：

• 使用_或-来让URI可读性更好
• 使用?用来过滤资源
• ,或;可以用来表示同级资源的关系

4.RESTful API常用的HTTP动词有：

GET（SELECT）：从服务器取出资源（一项或多项）。

POST（CREATE）：在服务器新建一个资源。

PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）（修改全部数据）

PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）（修改部分数据）

DELETE（DELETE）：从服务器删除资源。

RESTful API已经越来越普及，对RESTful 的基本了解还是有必要的，希望本文能对各位理解REST有所帮助。