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/ } }