我们在 SAP API Business Hub 里能看到 OData，SOAP 和 Restful 三种“不同”类型的 API：

它们之间到底有什么区别和联系？

OData vs REST: What is REST?

REST（REpresentational State Transfer）是一种软件架构风格，它定义了如何使用 HTTP 协议在两个不同的系统之间发送消息。 REST 最初由 Roy Fielding 于 20 年前开发，现已发展成为用于在万维网上交换信息的最流行的架构。

REST 标准概述了 Web 服务的 6 种不同原则或架构约束：

• 统一接口：REST 系统中的所有组件必须遵循相同的规则和接口才能相互通信。每个资源都由一个 URI（统一资源标识符）唯一标识。
• 客户端-服务器：REST 将负责存储和发送信息的服务器与负责获取信息和适当使用信息的客户端分开。这种分离使双方更加独立和可扩展。
• 无状态：使用 REST 发出的每个请求都是无状态的：它包含服务器执行请求所需的所有信息。请求完成后，服务器不需要存储参数或状态。例如，如果客户端请求访问受限资源，则客户端必须在每次请求时将其身份验证令牌发送到服务器。
• 可缓存：REST 中的客户端和服务器都可以缓存资源，有助于减少流量并提高性能。
• 分层系统：REST 允许分层系统架构：客户端可能只与系统中的一个服务器通信，而其他服务器执行身份验证和数据存储等功能。客户端无法判断它是在与终端系统还是中介进行通信。
• 按需代码：可选地，REST 请求可以在必要时返回逻辑或可执行代码。

遵循上述原则的 API（应用程序编程接口）称为 REST（或 RESTful）API。

OData vs REST: What is OData?

根据 OData 网站的说法，OData（开放数据协议）“定义了一组用于构建和使用 RESTful API 的最佳实践。 OData 可帮助您在构建 RESTful API 的同时专注于业务逻辑，而无需担心定义请求和响应标头、状态代码、HTTP 方法、URL 约定、媒体类型、有效负载格式、查询选项等的各种方法。”

OData 最初由 Microsoft 创建，由非营利组织 OASIS（结构化信息标准促进组织）标准化。 IBM、SAP 和 Salesforce 等企业技术公司都在其内部 IT 环境中使用了 OData。

REST 是 OData 最重要的组件技术。根据 OData 3.0 标准，OData 用户应遵循 REST 原则，“除非有充分且具体的理由不这样做”。

OData 标准还定义了用于响应 REST 请求传输数据的数据模型。 OData 支持两种不同的数据传输协议：基于 XML 的 Atom 格式（用于发布和编辑 Web 资源）和 JSON（用于以人类可读的方式存储数据）。

最后，OData 包括有关如何执行操作（例如跟踪更改、定义可重用程序和发送多个（批处理）REST 请求）的指南。

二者区别

尽管如此，OData 和 REST 之间的区别如下：

REST 是一种通过 HTTP 协议交换信息的架构风格。 REST 标准定义了任何 REST API 都必须遵守的 6 条原则（1 条可选）。 OData 构建在 REST 框架之上，以定义构建 REST API 的最佳实践，包括 HTTP 消息格式、如何查询 API 等。 尽管 OData 鼓励用户始终遵循 REST 原则，但如果有令人信服的理由，可以放宽此要求。 此外，OData 指定数据应以 Atom 或 JSON 格式传输。