RESTful理解

网络应用程序分为前端和后端两部分。随着前端设备层出不穷，对于统一的需求愈发强烈，继续出现一种统一机制方便不同前端设备与后端的通信。因此甚至出现“API First”的设计思想。 REST是Representational State Transfer,表述性状态转移，是一组架构约束条件和原则。首次出现在2000年RoyFielding的博士论文中（HTTP规范的主要编写者之一）。 RESTful的理念是“一切皆资源”。这里的资源不是指数据，而是数据和表现形式的组合。 ##协议 *** API与用户通信总是使用HTTP协议。当然，REST架构风格并不是绑定在HTTP上，只是HTTP是目前唯一与REST相关的实例。 ##域名 *** 尽量将API部署在专用域名之下。 版本 应该将API的版本号放在URL，或者将版本号放在HTTP头部，但是不如放在URL直接方便。 ##路径 *** 路径又称“终点”，表示API的具体网址。 在RESTful架构中，“一切皆资源”，每个网址代表一种资源，要求网址中只有名词。 ##HTTP动词 *** 非RESTful架构下的url设计： ``` * books books * book/add/ addbook * book/1/change changebook * book/1/delete changebook ``` 对于资源的具体操作类型由HTTP动词表示。 ``` get 查看 categories-----------------》 post 添加

         get            查看

categories/1/---------------》
delete 删除

          put           更新

常用的HTTP动词：

*GET ：从服务器取出资源（一项或多项）
*POST ：在服务器新建一个资源
*PUT ：在服务器更新资源（客户端提供改变后的完整资源）
*PATCH ：在服务器更新资源（客户端提供改变的属性）
*DELETE ：从服务器删除资源

不常用的两个HTTP动词：

*HEAD:获取资源的元数据
*OPTIONS:获取客户端可以改的信息

##状态码
***

*201 CREATED - [POST/PUT/PATCH]：用户新建或修改数据成功。
202 Accepted - []：表示一个请求已经进入后台排队（异步任务）
*204 NO CONTENT - [DELETE]：用户删除数据成功。
*301 资源的URL已被更新
*303 负载均衡
*304 资源未更改缓存
*400 INVALID REQUEST - [POST/PUT/PATCH]：用户发出的请求有错误，服务器没有进行新建或修改数据的操作，该操作是幂等的。
401 Unauthorized - []：表示用户没有权限（令牌、用户名、密码错误）。
403 Forbidden - [] 表示用户得到授权（与401错误相对），但是访问是被禁止的。
404 NOT FOUND - []：用户发出的请求针对的是不存在的记录，服务器没有进行操作
*406 Not Acceptable - [GET]：用户请求的格式不可得（比如用户请求JSON格式，但是只有XML格式）。
*410 Gone -[GET]：用户请求的资源被永久删除，且不会再得到的。
*422 Unprocesable entity - [POST/PUT/PATCH] 当创建一个对象时，发生一个验证错误。
500 INTERNAL SERVER ERROR - []：服务器发生错误，用户将无法判断发出的请求是否成功。
*503 服务端当前无法处理请求

返回结果
针对不同操作，服务器向用户返回的结果应该使用JSON。

*GET /collection：返回资源对象的列表（数组）
*GET /collection/resource：返回单个资源对象
*POST /collection：返回新生成的资源对象
*PUT /collection/resource：返回完整的资源对象
*PATCH /collection/resource：返回完整的资源对象
*DELETE /collection/resource：返回一个空文档

##用POST和PUT创建资源的区别
***
所创建资源的名称是否由客户端决定。PUT由客户端决定。
一些比较古老的浏览器只支持GET和POST方法。
</font>