RESTful API

叶随风...

HTTP REST API

什么是REST

API定义了应用程序如何交互，Web服务是API的一种实现，专门通过网络提供服务。
RESTful是实现Web服务的一种风格，它提供了一种设计Web服务的方法，使得服务易于使用、可伸缩和可维护。
简而言之，RESTful Web服务是一种特定类型的Web服务，它遵循REST架构原则；而Web服务是实现API的一种方式，可以采用RESTful或其他风格。

REST是以Web为平台的选择通过使用http协议和uri，利用client/server model对资源进行CRUD(Create/Read/Update/Delete)增删改查操作的一种架构风格。是腾讯公司或其他公司建立API时要遵守的一种规则/风格，当然也有其他规则可以用。
REST不是"rest"这个单词，而是Resource Representational State Transfer的缩写：通俗来讲就是：资源在网络中以某种表现形式进行状态转移。abap中可以通过实现IF_HTTP_EXTENSION接口并使用SICF（SAP Internet Communication Framework）来发布RESTful服务

Resource：资源，即数据（网络的核心）。
Representational：某种表现形式，比如用JSON，XML，JPEG等；
State Transfer：状态变化。通过HTTP动词实现。

Web端不再用之前典型的PHP或JSP架构，而是改为前段渲染和附带处理简单的商务逻辑。Web端和Server只使用上述定义的API来传递数据和改变数据状态。格式一般是JSON。

对于资源的具体操作类型，由HTTP动词表示。常用的HTTP动词有下面五个（括号里是对应的SQL命令）：

GET（SELECT）：从服务器获取资源(一项或多项)
POST（CREATE）：在服务器新建一个资源
PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）
PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）
DELETE（DELETE）：从服务器删除资源。

返回状态

状态码	描述
1xx	代表请求已被接受，需要继续处理
2xx	请求已成功，请求所希望的响应头或数据体将随此响应返回
3xx	重定向
4xx	客户端原因引起的错误
5xx	服务端原因引起的错误

什么是Web

Web是分布式信息系统为超文本文件和其他对象（资源）提供访问入口。
资源是Web架构的关键点,需要3个操作:识别(identify)，表示(represent)，交互(interact with)
通过这三个操作，又引出三个概念:

uri（统一资源标识符包括url和urn）识别资源；
representation （例如html，图片，视频等等）表示资源；
通过协议（包括http，ftp等等）与资源进行交互。

什么是API

API是"应用程序编程接口"(Application Programming Interface)的缩写。它是一种软件中间件，用于构建软件应用，允许不同的程序或服务之间相互通信。API定义了软件组件之间如何交互的规则和协议，使得开发者能够访问某个服务或应用程序的功能或数据，而无需了解其内部的实现细节。

API可以是本地的，也可以是基于网络的（Web API），通常使用HTTP协议进行通信。通过API，开发者可以请求服务、数据或功能，并以编程方式进行集成和自动化处理。例如，社交媒体平台的API允许第三方应用发布内容或获取用户数据；电子商务网站的API可以让用户通过自己的应用程序查询订单状态或管理库存。

API的主要类型包括：

本地库API：用于访问本地库或操作系统服务的接口。
Web API：通过HTTP协议提供服务的接口，常用于访问远程服务器上的数据或服务。
操作系统API：提供对操作系统功能的访问，如文件操作、进程管理等。
硬件API：允许软件与硬件设备进行交互，如传感器、摄像头等。
API的使用可以提高开发效率，促进技术创新，并且是现代软件开发中不可或缺的一部分。