1. 概述
在 API 设计中，接口（Endpoint）是一个非常核心的概念。无论是开发还是调用 API，理解接口的含义和作用都是非常必要的。
本文将深入讲解 API 接口中“接口”的定义，它在 API 设计与开发中的作用，以及其与 HTTP 方法、协议之间的关系。我们还会探讨接口与 URI 的区别，帮助你更清晰地理解这两个概念的边界。
2. 什么是接口（Endpoint）？
在 API（应用程序编程接口）的语境中，接口指的是一个具体的 URL 地址，它指向某个特定的资源。当我们与 API 交互时，不同的接口可以执行不同的操作，比如请求数据、触发流程等。
举个例子，假设我们有一个用户管理的 API，可能包含如下接口：
如上图所示，所有请求都基于相同的 Base URL，但根据接口路径的不同，请求会被分发到对应的 Web Server 上。例如：
https://myserver1.com的请求会到达“Web Server 1”https://myserver2.com的请求会到达“Web Server 2”
服务器根据接口路径执行不同的操作。比如 /users 接口用于管理用户集合，而 /users/{id} 则用于管理某个具体用户。
接口在 API 设计中非常重要，它定义了 API 可以暴露的资源和操作。
2.1. 支持多种协议的接口
一个接口本质上是 URL + HTTP 方法 的组合。HTTP 方法决定了该接口支持的操作类型。因此，一个接口可以通过支持不同的 HTTP 方法来实现多种协议。
以 /users 这个接口为例，它表示的是用户集合资源，可以支持以下几种操作：
| HTTP 方法 | 描述 |
|---|---|
| GET | 获取所有用户 |
| POST | 添加新用户 |
| PUT | 替换整个用户集合 |
| DELETE | 删除一个或多个用户 |
可以看到，同一个路径 /users，通过不同的 HTTP 方法实现了多种功能。这正是 RESTful API 中接口灵活性的体现。
3. 接口 vs URI
URI（Uniform Resource Identifier）是统一资源标识符，它是一个字符串，用于标识某个资源或名称。
接口是一个具体的 URL，代表 API 中某个特定资源或操作。 它通常由 URL 和 HTTP 方法组成，比如 GET /users。
而 URI 是一个更广泛的概念，它可以是：
- URL（Uniform Resource Locator）：表示资源的网络位置，例如
https://example.com/users - URN（Uniform Resource Name）：表示资源的唯一名称，比如
urn:isbn:0451450523
✅ 总结一下：
| 对比项 | 说明 |
|---|---|
| 接口（Endpoint） | 指向 API 中某个特定资源或操作，通常由 URL 和 HTTP 方法组成 |
| URI | 更广泛的概念，标识任何资源，不局限于 API |
4. 总结
本文介绍了 API 接口（Endpoint）的基本概念，以及它在 API 设计中的重要性。接口是一个具体的 URL，可以绑定不同的 HTTP 方法，从而实现多种操作。我们也对比了接口与 URI 的区别，帮助你更清晰地理解这两个概念。
掌握接口的设计与使用，对于构建清晰、易用、可维护的 API 非常关键。在实际开发中，良好的接口设计不仅有助于前后端协作，也能提升系统的可扩展性和可测试性。