API测试工具

API测试工具 是一个免费的、基于浏览器的工具，用于即时测试 REST API 端点。使用自定义方法、请求头、身份验证和请求体发送 HTTP 请求 —— 然后检查响应状态、耗时、响应头和格式化的响应体。无需安装或注册。所有请求都直接从您的浏览器发送，确保您的数据私密。

什么是 API 测试器？

API 测试器（也称为 API 客户端或 REST 客户端）是一个允许开发人员和测试人员向 Web API 端点发送 HTTP 请求并检查响应的工具。它对于 API 开发、调试、集成测试和文档验证至关重要。与 Postman 或 Insomnia 等全功能桌面应用程序不同，此在线 API 测试器无需安装 —— 只需打开页面即可开始测试。

支持的 HTTP 方法

主要特点

• 多种 HTTP 方法： 支持 GET, POST, PUT, PATCH 和 DELETE 请求，覆盖所有 REST API 操作。
• 自定义请求头： 使用动态键值编辑器添加任意数量的请求头。可以切换单个请求头的开启/关闭而无需删除。
• 身份验证支持： 内置支持 Bearer 令牌、Basic 认证和 API 密钥身份验证 —— 无需手动构建 Authorization 请求头。
• 请求体编辑器： 发送 JSON, XML, 表单编码或纯文本请求体，自动设置相应的 Content-Type 请求头。
• 响应查看器： 查看响应状态码、响应时间、响应大小、响应头以及带有 JSON 语法高亮的格式化响应体。
• 请求历史记录： 自动保存最后 30 条带有状态码和耗时的请求。点击任何历史项即可立即重放。
• cURL 导入/导出： 从文档导入 cURL 命令，或将您的请求导出为 cURL 命令以便共享或在脚本中使用。
• 100% 客户端运行： 所有请求都直接从您的浏览器发送。您的 API 密钥、令牌和数据绝不会触及我们的服务器。

如何使用此工具

1. 输入 API URL： 在 URL 字段中输入或粘贴完整的 API 端点 URL（例如 https://jsonplaceholder.typicode.com/posts/1）。
2. 选择 HTTP 方法： 根据您要执行的操作，从下拉菜单中选择 GET, POST, PUT, PATCH 或 DELETE。
3. 添加请求头和请求体： （可选）在“请求头”选项卡中添加请求头（如 Authorization 或 Content-Type），在“请求体”选项卡中为 POST/PUT/PATCH 请求添加请求体。
4. 发送请求： 点击发送按钮（或按回车键）执行请求。该工具将显示带有状态码、耗时、响应头和格式化响应体的响应。
5. 分析响应： 查看响应状态码（带颜色区分）、响应时间、大小、响应头和响应体。JSON 响应会自动格式化并进行语法高亮。

常见应用场景

API 开发与调试

在开发过程中测试您的 API 端点，以验证它们是否返回正确的响应代码、请求头和数据。通过测试不同的请求配置，快速迭代您的 API 设计。

集成测试

验证您集成的第三方 API 是否响应正确。在编写集成代码之前，测试身份验证流程、检查响应格式并验证错误处理。

API 文档验证

确认 API 文档示例是否确实按描述工作。从文档中导入 cURL 命令并验证响应是否与文档记录的一致。

Webhook 测试

发送带有特定载荷的 POST 请求来测试 Webhook 端点。验证您的 Webhook 处理器是否正确处理不同的载荷格式。

了解 HTTP 状态码

• 2xx (成功)： 请求已成功处理。200 OK 表示请求成功，201 Created 表示创建了新资源，204 No Content 表示成功但无响应体。
• 3xx (重定向)： 请求已被重定向。301 Moved Permanently 和 302 Found 表示资源已移动到不同的 URL。
• 4xx (客户端错误)： 请求存在错误。400 Bad Request 表示数据无效，401 Unauthorized 表示缺少身份验证，403 Forbidden 表示权限不足，404 Not Found 表示资源不存在。
• 5xx (服务器错误)： 服务器遇到错误。500 Internal Server Error 表示通用的服务器故障，503 Service Unavailable 表示服务器暂时不可用。

CORS 与基于浏览器的 API 测试

由于此工具在您的浏览器中运行，API 请求受 CORS（跨源资源共享） 策略的约束。如果目标 API 不包含 Access-Control-Allow-Origin 响应头，浏览器将拦截响应。大多数公共 API 都支持 CORS，但内部或私有 API 可能不支持。在这种情况下，请考虑从后端环境进行测试，或配置 API 服务器以允许 CORS。

常见问题解答

什么是 API 测试器？

API 测试器是一个允许您向 REST API 端点发送 HTTP 请求并检查响应的工具。它通过在格式化视图中显示响应状态码、响应头、响应时间和响应体，帮助开发人员调试、测试和验证 API 行为。

这个 API 测试器可以免费使用吗？

是的，这个 API 测试器完全免费，无需注册。所有请求都直接从您的浏览器发送，因此您的数据保持私密，绝不会存储在我们的服务器上。

我可以测试需要身份验证的 API 吗？

可以。您可以添加带有 Bearer 令牌、API 密钥或 Basic 认证凭据的 Authorization 请求头。只需在请求头部分添加一个键为“Authorization”且值为您的令牌的请求头，或者为了方便，使用内置的“认证”选项卡。

为什么我的 API 请求因 CORS 错误而失败？

当目标 API 服务器不允许来自不同域的 Web 浏览器的请求时，就会发生 CORS（跨源资源共享）错误。这是一种服务器端安全策略。您可以要求 API 提供者添加 CORS 响应头，或者改从后端服务器使用该 API。

支持哪些 HTTP 方法？

此工具支持五种最常见的 HTTP 方法：用于检索数据的 GET，用于创建资源的 POST，用于替换资源的 PUT，用于部分更新的 PATCH，以及用于删除资源的 DELETE。

更多资源

• HTTP 请求方法 - MDN Web Docs
• HTTP 响应状态码 - MDN Web Docs
• 跨源资源共享 (CORS) - MDN Web Docs