了解 API 和端点之间的区别

了解 API 和端点之间的区别

在软件开发领域，尤其是在 Web 服务和后端开发领域，经常会用到两个术语：API（应用程序编程接口）和端点。它们总是联系在一起，但尽管如此，它们却是两个截然不同的概念。本文旨在分别解释 API 和端点，并阐明它们之间的关系。

什么是 API？

应用程序接口 (API) 是一种用于软件构建的工具、协议和其他编程方法。它指定了数据的格式、应用程序如何共享数据以及应遵循的协议。换句话说，它涉及使用支持两个应用程序域之间交互的接口。

API 的主要特征：

• 定义：API 是指计算机程序之间交互的结构化规范集合，提供明确的指导和描述。
• 范围：因此，它提供了各种选项，并且可以引入多个端点、功能或方法。
• 目的：使用 API 实现的原因是，它允许一个系统向另一个系统提供统一的接口，以便后者可以在需要时使用其他系统。
• 示例：一些最广为人知的 API 类型是 RESTful、SOAP 和 GraphQL。

什么是端点？

与 API 相对，端点定义了 API 中的 URL 或 URI，用于提供或请求特定的数据或操作。它是客户端、开发者或其他用户访问 API 的精确参考点，无论这些客户端是浏览器、移动设备还是其他服务器。

端点的主要特征：

• 定义：端点是 API 中指定特定操作、线路功能或服务的特定点，通常为一次调用。
• 范围：它是 API 的一个组成部分，最常用于指代一种功能，包括简单地访问信息或处理对资源或事件的更改。
• 用途：API 目标是指进行 API 调用的 URL，可以简单到只是一个可以发出请求的 URL。它们指定到达特定资源或方法所需的坐标或条件。
• 示例：其中包括：

• 其中包括：

• GET /api/users– 返回用户列表。

• POST /customers– 这将创建一个新的客户或用户

• `GET /api/users/{id} – 使用唯一标识符返回有关特定用户的信息。

• `PUT /api/users/ {id} – 此端点允许使用其标识符更新一个特定用户。

• DELETE /api/users/{id}:用于根据用户的id删除特定的用户。

API 和端点之间的关系

打个比方，我们可以将 API 比作图书馆；而端点则可以比作图书馆里的具体书籍。API 提供了图书馆的组织结构，即图书馆的外壳和运作规则，而端点则是可以找到或访问特定信息的具体位置。

• API 作为图书馆：类似地，图书馆有一套书，API 也有一组端点，但这意味着它们每个都有自己的用途。
• 端点作为书籍：在 API 中，每个端点类似于图书馆中的一本书，因为 API 可以被视为一个图书馆，人们可以在其中找到有关特定主题的书籍，并且可以直接找到包含所需信息的相关书籍。

实际意义

这是帮助开发人员区分 API 和端点之间差异的重要知识。在设计或与 API 交互时，务必掌握以下几点：

• API 代表应用程序编程接口，它本质上形成了一种通信结构和一套指导方针。
• 端点被定义为可以请求信息和设施的某些单独的联系点。

这使我们能够识别需要进行设计更改以适应预期改进的区域，从而开发更高效、更有序的系统运行方式。它还有助于识别错误，因为开发人员可以判断问题是源自 API 的整体架构还是特定端点。

结论

因此，API 和端点是相互关联的，为了区分它们，有必要考虑它们在软件开发环境中的位置。API 是对标准的总体定义以及软件系统交换数据能力的规范，而端点是特定 API 内进行 API 交换的特定位置。