restful规范快速记忆

restful规范：

十个规则：

用户发来请求，url必须：

1、因为是面向资源编程，所以每个URL代表一种资源，URL中尽量不要用动词，要用名词

2、尽量使用HTTPS，https代替http

3、在URL中体现是否是API

https://www.bootcss.com/api/mycss

https://api.bootcss.com/mycss

4.在URL中体现版本

https://www.bootcss.com/v1/mycss

https://v1.bootcss.com/mycss

5、在URL中的过滤条件

https://www.bootcss.com/v1/mycss？page=3

请求方法

6、根据method不同，进行不同的操作

GET/POST/PUT/DELETE/PATCH

返回状态码

7、响应时设置状态码

1**   信息，服务器收到请求，需要请求者继续执行操作

2**  成功，操作被成功接收并处理

3**  重定向，需要进一步的操作以完成请求

4**  客户端错误，请求包含语法错误或无法完成请求

5**  服务器错误，服务器在处理请求的过程中发生了错误

返回结果

8、返回值

GET请求 返回查到所有或单条数据

POST请求  返回新增的数据

PUT请求  返回更新数据

PATCH请求  局部更新  返回更新整条数据

DELETE请求  返回值为空

错误信息处理

9、返回错误信息

返回值携带错误信息

Hypermedia API

如果遇到需要跳转的情况 携带调转接口的URL

　　ret = {

                code: 1000,

                data:{

                    id:1,

                    name:'鹿晗',

                    depart_id:http://www.baidu.com/api/v1/depart/8/

                }

            }