API 端点

端点是指服务器响应的 HTTP 方法和 URL 路径的组合：GET /orders和 POST /orders是同一资源上的两个端点。文档、访问规则、速率限制和测试通常都按端点进行组织，因此端点是人们在评估 API 规模时考虑的单位。

工作原理

路径指定资源名称，路径参数指定一个实例（ /orders/{id} ），查询字符串缩小或限定搜索结果的范围，方法则指定如何处理结果。服务器会将每个传入的请求路由到为该方法和路径模式注册的处理程序，如果请求匹配路径但不匹配方法，则会返回 405 而不是 404。

误解

端点就是一个 URL。同一个 URL，不同的方法对应不同的端点，规则也不同——例如，GET /orders/7可能是公开的，而 DELETE /orders/7则需要管理员令牌。仅仅测试一种方法就假设其他方法的行为相同，这种做法正是授权漏洞得以通过审核的原因。

点击这里试试

每个文档页面都会列出其端点，包括方法、路径以及每个端点可以返回的状态代码；Pizza API 的 DELETE /menu是一个 GET 路径，但对每个 DELETE 请求都返回 405。

相关内容

• What a REST API is
• HTTP 405 Method Not Allowed

资料来源

• HTTP semantics — RFC 9110
• OpenAPI Initiative

其他术语

• REST API — 将系统建模为可寻址资源的 API，可通过标准 HTTP 方法进行操作。
• 查询参数 — URL 中问号后面的键值对，用于过滤、排序、分页或调整端点返回的内容。
• 路径参数 — URL 路径中的可变部分，例如/orders/42中的 42，用于标识一个特定的资源。
• HTTP 标头 — 每个请求和响应都会发送名称-值元数据，与请求体分开。
• HTTP 状态码 — 每个 HTTP 响应开头的三位数，在响应体之前，表示发生了什么。
• 内容谈判 — 客户端和服务器通过标头而不是单独的 URL 来约定响应格式。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日