什么是 API？什么又是 RESTful API？

应用程序编程接口（API）定义您与其他软件系统进行通信必须遵循的规则。开发人员公开或创建 API，以便他们的应用程序可以以编程方式与其他应用程序进行通信。例如，工时单应用程序公开一个要求提供员工全名和日期范围的 API。当其收到此信息时，其会对员工的工时单进行内部处理，并返回该日期范围内的工作小时数。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

您可以将 Web API 想象为客户端和 Web 上资源之间的大门。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

客户端

客户端是要访问 Web 上信息的用户。客户端可以是使用 API 的个人或软件系统。例如，开发人员可以编写从天气系统访问天气数据的程序。或者，您可以在浏览器上直接访问天气网站访问相同的数据。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

资源

资源是不同的应用程序向其客户端提供的信息。资源可以是图像、视频、文本、数字或任何类型的数据。向客户端提供资源的设备也称为服务器。企业使用 API 分享资源，既能提供 Web 服务，还能确保安全、可控，身份验证。此外，API 帮助企业确定哪些客户端可以访问特定的内部资源。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

RESTful API 有以下优势：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

可扩展性

采用了 REST API 的系统可以高效扩展，因为 REST 优化了客户端-服务器交互。无状态可减轻服务器负载，因为服务器不必保留过去的客户端请求信息。管理良好的缓存可部分或完全消除某些客户端-服务器交互。所有这些功能都支持可扩展性，并且不会导致通信瓶颈进而降低性能。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

灵活性

RESTful Web 服务支持客户端-服务器完全分离。该服务简化并分离了多种服务器组件，以便可以独立改进每个部分。平台或技术在服务器应用程序端更改，不会影响客户端应用程序。分层应用程序功能可进一步提升灵活性。例如，开发人员可以更改数据库层，而无需重新编写应用程序逻辑。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

独立性

REST API 与所使用的技术相互独立。您可以在不影响 API 设计的情况下以多种编程语言编写客户端和服务器应用程序。您也可以在不影响通信的情况下更改任何一端的基础技术。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

RESTful API 要求请求包含以下主要组件：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

唯一的资源标识符

服务器通过唯一的资源标识符识别每个资源。对于 REST 服务，服务器通常使用统一资源定位符 (URL) 执行资源识别。URL 指定资源的路径。URL 类似于您访问任何网页时在浏览器中输入的网站地址。URL 也称为请求端点，并向服务器清晰指明客户端请求的内容。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

方法

开发人员通常使用超文本传输协议 (HTTP) 实施 RESTful API。HTTP 方法通知服务器需要对资源执行什么操作。以下为四种常见的 HTTP 方法：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

GET文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

客户端使用 GET 访问位于服务器上指定 URL 上的资源。它们可以缓存 GET 请求，并在 RESTful API 请求中发送参数以指示服务器在发送之前筛选数据。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

POST文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

客户端使用 POST 向服务器发送数据。它们将数据表征包含到了请求中。多次发送相同的 POST 请求会造成多次创建相同资源的不良影响。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

PUT文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

客户端使用 PUT 更新服务器上的现有资源。与 POST 不同，在 RESTful Web 服务中多次发送相同的 PUT 请求具有相同的效果。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

DELETE文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

客户端使用 DELETE 请求删除资源。DELETE 请求可以更改服务器状态。但是，如果用户没有合适的身份验证，则请求失败。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

HTTP 头

请求头是客户端和服务器之间交换的元数据。例如，请求头表示请求和响应的格式，提供有关请求状态的信息等等。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

数据文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

REST API 请求可能包含 POST、PUT 和其他 HTTP 方法成功运行所需的数据。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

参数文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

RESTful API 请求可以包含参数，这些参数向服务器提供更多有关需采取行动的详细信息。以下为一些不同类型的参数：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

• 指定 URL 详细信息的路径参数。
• 请求有关资源的更多信息的查询参数。
• 对客户端进行快速身份验证的 Cookie 参数。

REST 原则要求服务器响应包含以下主要组件：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

状态行

状态行包含三位数字状态代码表示请求成功或请求出现故障。例如，2XX 代码表示成功，但 4XX 和 5XX 代码表示错误。3XX 代码表示 URL 重定向。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

以下为一些常见的状态代码：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

• 200：通用成功响应
• 201：POST 方法成功响应
• 400：服务器无法处理的不正确请求
• 404：未找到资源

信息正文

响应正文包含资源表征。服务器根据请求头包含的内容选择合适的表征格式。客户端可以以 XML 或 JSON 格式请求信息，这些格式定义如何以纯文本方式编写数据。例如，如果客户端请求名为 John 的人员的姓名和年龄，则服务器返回如下 JSON 表征：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

'{"name":"John", "age":30}'文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html

头

响应也包含有关响应的头或元数据。它们提供有关响应的更多背景内容，包含服务器、编码、日期和内容类型等信息。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/arc/64777.html