Restful API理解

Posted 2021-07-30 小志的博客

目录

• • 一、API的理解
  • 二、Restful的理解
  • 三、Restful API 的理解
  • 四、Rest成熟度模型

一、API的理解

• API（Application Programming Interface，应用程序接口）是一些预先定义的函数，或指软件系统不同组成部分衔接的约定。

二、Restful的理解

• REST（英文：Representational State Transfer，简称REST）描述了一个架构样式的网络系统，比如 web 应用程序。
• RESTFUL是一种网络应用程序的设计风格和开发方式，基于HTTP，可以使用XML格式定义或JSON格式定义。RESTFUL适用于移动互联网厂商作为业务接口的场景，实现第三方OTT调用移动网络资源的功能，动作类型为新增、变更、删除所调用资源。

三、Restful API 的理解

	请求路径（传统）	请求方式（传统）	请求路径（Restful API）	请求方式（Restful API）
查询	/user/query?name=tom	GET	/user?name=tom	GET
新增	/user/insert?id=1	POST	/user	POST
修改	/user/query?id=1&name=jack	POST	/user/1	PUT
删除	/user/query?id=1	GET	/user/1	DELETE

• Restful 使用URL描述资源；
• Restful 使用HTTP方法描述行为，使用HTTP状态码表示不同的结果；
• Restful使用json交互数据；
• Restful只是一种风格，并不是强制的标准。

四、Rest成熟度模型

• Level 0 ：表示使用Http作为传输方式；
• Level 1 ：表示引入资源概念，每个资源都有对应的URL；
• Level 2 ：表示使用HTTP方法进行不同的操作，使用HTTP状态码来表示不同的结果；
• Level 3 ：表示使用超媒体，在资源的表达中包含了链接信息；

注：目前大多数的项目只到Level 2级别。