正黄集团博弘建设官方网站,最新新闻热点事件ppt,如何制作表白链接,物流企业网站建设与管理规划书一、什么是Rest?
REST不是rest这个单词#xff0c;而是几个单词缩写 -- REpresentational State Transfer 直接翻译#xff1a;表现层状态转移#xff0c;但这个翻译正常人根本看不懂#xff0c;找到的一种最好理解的说法是#xff0c;URL定位资源#xff…一、什么是Rest?
REST不是rest这个单词而是几个单词缩写 -- REpresentational State Transfer 直接翻译表现层状态转移但这个翻译正常人根本看不懂找到的一种最好理解的说法是URL定位资源用HTTP动词GET,POST,DELETE,DETC描述操作。
REST成熟度的四个层次 第一个层次Level0的Web 服务只是使用 HTTP 作为传输方式实际上只是远程方法调用RPC的一种具体形 式。SOAP和 XML-RPC都属于此类。 第二个层次Level1的Web 服务引入了资源的概念。每个资源有对应的标识符和表达。 第三个层次Level2的Web 服务使用不同的 HTTP 方法来进行不同的操作并且使用HTTP 状态码来表示不同的结果。如 HTTPGET 方法来获取资源HTTPDELETE 方法来删除资源。 第四个层次Level3的Web 服务使用 HATEOAS。在资源的表达中包含了链接信息。客户端可以根据链接来发现可以执行的动作。
二、Restful api接口有什么特征
REST描述的是在网络中client和server的一种交互形式REST本身不实用实用的是如何设计 RESTful APIREST风格的网络接口。
1.URL的根路径
http://api.chesxs.com/v1
2.需要有api版本信息
http://api.chesxs.com/v1
3.URL中只使用名词指定资源不用动词且推荐使用复数
服务Server提供的RESTful API中URL中只使用名词来指定资源原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。比如
http://api.chesxs.com/v1/cars // 获取某个账户下的车辆列表
http://api.chesxs.com/v1/fences // 获取某个账户下的围栏列表
4. 用HTTP协议里的动词来实现资源的添加修改删除等操作。即通过HTTP动词来实现资源的状态扭转 GET 用来获取资源
POST 用来新建资源也可以用于更新资源。比如POST http://api.chesxs.com/v1/car: 添加车辆
PUT 用来更新资源
DELETE 用来删除资源。比如DELETE http://api.chesxs.com/v1/cars 删除某辆车 在http parameter指定好友id
UPDATE http://api.chesxs.com/v1/fence 更新围栏信息 错误使用 GET http://api.chesxs.com/v1/deleteCar 删除车辆 5.GET应该是安全的不会改变资源状态 这个应该很好理解get的时候就只是获取资源而不涉及添加、更新、删除资源。
6.使用正确的HTTP Status Code返回状态码
常用的有404200500400等等。
7.过滤信息
如果记录数量很多服务器不可能都将它们返回给用户。API应该提供参数过滤返回结果。
下面是一些常见的参数。
?limit10指定返回记录的数量
?offset10指定返回记录的开始位置。
?page2per_page100指定第几页以及每页的记录数。
?sortbynameorderasc指定返回结果按照哪个属性排序以及排序顺序。
?producy_type1指定筛选条件
8.规范返回的数据
为了保障前后端的数据交互的顺畅建议规范数据的返回并采用固定的数据格式封装。
接口返回模板 {status:0,data:{}||[],msg:’’
} 总结看一个标准的restful api要可以做到
看Url就知道要操作的资源是什么是操作车辆还是围栏
看Http Method就知道操作动作是什么是添加post还是删除delete
看Http Status Code就知道操作结果如何是成功200还是内部错误500 参考文章https://www.cnblogs.com/bndong/p/6139598.html
