Restful API理解

一、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=tomGET/user?name=tomGET新增/user/insert?id=1POST/userPOST修改/user/query?id=1&name=jackPOST/user/1PUT删除/user/query?id=1GET/user/1DELETE

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

四、Rest成熟度模型

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

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