响应

发送请求后，响应将显示在这里

什么是 HTTP API 测试工具？

HTTP API 测试工具是用于调试和测试 HTTP/HTTPS 接口的工具。它允许开发者手动构造 HTTP 请求（GET、POST、PUT、DELETE 等），设置请求头、请求体、认证信息，然后查看服务器返回的响应状态码、响应头和响应体。

IqsBot HTTP API 测试工具是一个免费、浏览器端运行的 API 调试工具，功能类似 Postman 和 Insomnia。你可以在网页中直接测试 API 接口，无需安装任何软件，支持：

多种 HTTP 方法：GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS
请求头配置：自定义 HTTP Headers
请求体配置：支持 JSON、Form Data、Raw Text 格式
认证支持：Bearer Token、Basic Auth、API Key
响应查看：状态码、响应时间、响应体、响应头、Cookies
请求历史：自动保存最近的请求记录

相比 Postman 等桌面应用，IqsBot HTTP API 测试工具的优势是纯浏览器端运行——无需下载安装，打开网页即用，并且跨域请求更灵活（依赖浏览器 CORS 策略）。

为什么需要 HTTP API 测试工具？

在前后端分离开发、微服务架构、第三方 API 集成等场景中，经常需要独立测试 API 接口：

后端开发：快速验证接口是否按预期返回数据
前端开发：模拟接口响应，调试前端逻辑
接口调试：排查 4xx、5xx 错误，分析请求和响应细节
API 文档验证：对照文档测试接口是否符合规范

使用 IqsBot HTTP API 测试工具，你可以：

快速调试：在浏览器中直接发送请求，无需切换工具
灵活配置：支持各种请求方法、请求头、请求体格式
实时反馈：立即查看响应状态码、响应时间、响应内容
历史记录：自动保存请求历史，方便重复测试
隐私安全：纯浏览器端运行，请求数据不会上传到服务器

如何使用 IqsBot HTTP API 测试工具

基础用法

选择 HTTP 方法：点击方法下拉框，选择 GET、POST、PUT、DELETE 等
输入请求 URL：在 URL 输入框中填写完整的接口地址（如 https://api.example.com/users）
配置请求头（可选）：切换到"请求头"标签页，添加自定义 Headers（如 Content-Type: application/json）
配置请求体（可选）：对于 POST、PUT、PATCH 请求，切换到"请求体"标签页，选择 JSON、Form Data 或 Raw Text 格式并填写内容
配置认证（可选）：切换到"认证"标签页，选择 Bearer Token、Basic Auth 或 API Key 认证方式并填写凭据
发送请求：点击"发送请求"按钮
查看响应：在右侧响应区查看状态码、响应时间、响应体、响应头等信息

请求头配置

在"请求头"标签页中：

点击"+ 添加请求头"按钮添加新的 Header 行
填写 Header 名称（如 Content-Type、Authorization、Accept）
填写 Header 值（如 application/json、Bearer xxx）
点击"×"按钮删除不需要的 Header

常用请求头示例：

Header 名称	值示例	说明
`Content-Type`	`application/json`	指定请求体格式为 JSON
`Content-Type`	`application/x-www-form-urlencoded`	指定请求体格式为表单
`Authorization`	`Bearer eyJhbGciOi...`	Bearer Token 认证
`Accept`	`application/json`	指定接受的响应格式
`User-Agent`	`IqsBot/1.0`	标识客户端信息

请求体配置

在"请求体"标签页中，先选择请求体类型：

None：无请求体（适用于 GET、DELETE 等请求）
JSON：JSON 格式请求体（适用于 RESTful API）
Form Data：表单格式请求体（适用于 application/x-www-form-urlencoded）
Raw Text：原始文本请求体（适用于自定义格式）

JSON 请求体示例：

{
  "name": "张三",
  "age": 25,
  "email": "zhangsan@example.com"
}

Form Data 请求体示例：

字段名	字段值
`username`	`zhangsan`
`password`	`123456`

认证配置

在"认证"标签页中，先选择认证类型：

None：无认证
Bearer Token：Bearer Token 认证（常见于 JWT）
Basic Auth：基本认证（用户名 + 密码）
API Key：API 密钥认证

Bearer Token 认证示例：

Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Basic Auth 认证示例：

用户名: admin
密码: password123

工具会自动将用户名和密码编码为 Base64 格式，并添加到 Authorization 请求头中。

API Key 认证示例：

Key 名称: X-API-Key
Key 值: abc123def456
位置: Header

查看响应

发送请求后，右侧响应区会显示：

状态码：HTTP 响应状态码（如 200、404、500）
状态文本：状态码的简短描述（如 OK、Not Found、Internal Server Error）
响应时间：从发送请求到接收完响应所花费的时间（毫秒）
响应大小：响应体的大小（字节、KB、MB）

响应区有三个标签页：

响应体：显示响应内容，如果是 JSON 会自动格式化
响应头：显示服务器返回的所有响应头
Cookies：显示服务器设置的 Cookies（如果有）

请求历史

工具会自动保存最近的 10 条请求记录。点击历史记录中的任意请求，可以快速加载该请求的 URL、方法和认证信息。

保存和加载请求

点击"保存请求"按钮，可以将当前请求配置保存为 JSON 文件
点击"加载请求"按钮，可以从历史记录中加载之前保存的请求

使用示例

假设你要测试一个创建用户的 POST 接口：

选择方法：POST
输入 URL：https://jsonplaceholder.typicode.com/posts
配置请求头：
- Content-Type: application/json
- Accept: application/json

配置请求体：选择 JSON，填写：

{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

发送请求
查看响应：状态码 201 Created，响应体中包含创建的资源和分配的 ID

常见问题

Q: 我的请求数据会上传到服务器吗？

A: 绝对不会。 IqsBot HTTP API 测试工具完全运行在浏览器本地，所有请求都是从你的浏览器直接发送到目标 API 服务器。IqsBot 的服务器不会接收、存储或转发任何请求数据。这也是我们与许多在线 API 测试工具最大的区别。

Q: 保存的模板数据存储在哪里？

A: 模板数据存储在浏览器的 localStorage 本地缓存中。 具体来说：

存储位置：浏览器本地的 localStorage，键名为 http-api-tester-templates
数据持久性：只要不清除浏览器缓存或本地数据，模板会一直保留
设备隔离：模板数据仅保存在当前设备的当前浏览器中，不会跨设备同步
清除方法：
1. 在工具中手动删除模板（点击模板卡片右上角的"删除"按钮）
2. 清除浏览器的本地存储数据（浏览器设置 → 隐私和安全 → 清除浏览数据 → 勾选"本地存储数据"）

注意：如果你清除了浏览器的缓存或本地存储，已保存的模板数据将会丢失，且无法恢复。建议在重要模板配置完成后，使用"保存请求"功能将配置导出为 JSON 文件备份。

Q: 为什么请求失败，提示 CORS 错误？

A: 这是浏览器的跨域资源共享（CORS）策略导致的。 当你的浏览器向不同域名的 API 发送请求时，如果目标服务器没有设置允许跨域的响应头（如 Access-Control-Allow-Origin），浏览器会阻止响应。

解决方案：

使用浏览器插件：安装 CORS 绕过插件（如 "Allow CORS"）
使用代理服务器：让同源服务器代理请求（需要后端支持）
在目标服务器上配置 CORS：如果你有权限修改目标服务器，添加 CORS 响应头

注意：Postman 等桌面应用不受 CORS 限制，因为它们不是运行在浏览器中。

Q: 支持文件上传吗？

A: 当前版本暂不支持文件上传。 我们会在后续版本中添加对 multipart/form-data 格式的支持，包括文件上传功能。

Q: 支持环境变量和全局变量吗？

A: 当前版本暂不支持环境变量。 我们会在后续版本中添加环境变量、全局变量、测试脚本等高级功能。

Q: 和其他 API 测试工具（如 Postman、Insomnia）相比有什么优势？

A: 核心优势是轻量级和即用性——

无需安装：打开网页即可使用，无需下载安装桌面应用
跨平台：只要有浏览器就能使用，Windows、Mac、Linux 都支持
隐私安全：请求数据不上传服务器，敏感 API 密钥可以放心使用
免费无广告：完全免费，没有任何广告和弹窗干扰
快速调试：适合快速测试单个接口，不需要创建项目、集合等复杂结构

当然，如果你需要更高级的功能（如自动化测试、Mock Server、团队协作等），Postman 和 Insomnia 仍然是更好的选择。

Q: 如何测试需要登录的接口？

A: 先获取认证凭据，然后在"认证"标签页中配置。 常见流程：

使用登录接口获取 Token（如 JWT）
在"认证"标签页中选择 "Bearer Token"
填写获取到的 Token
发送需要认证的请求

如果是 Session 认证（Cookie），工具会自动保存服务器返回的 Cookies，并在后续请求中自动携带。

常见 HTTP 状态码说明

状态码	状态文本	说明
200	OK	请求成功
201	Created	资源创建成功
204	No Content	请求成功，但无返回内容
400	Bad Request	请求参数错误
401	Unauthorized	未认证，需要提供认证信息
403	Forbidden	无权限访问该资源
404	Not Found	资源不存在
500	Internal Server Error	服务器内部错误
502	Bad Gateway	网关错误
503	Service Unavailable	服务不可用