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

 

posted @ 2019-04-16 17:07  hnlmy  阅读(208)  评论(0编辑  收藏  举报