API 测试工具 - 在线 HTTP 请求测试器

1. 发送第一个请求

默认开启「服务端代理」：请求经本站服务器转发到目标地址，绕开浏览器同源策略。要复现浏览器直连行为（调试 CORS 问题）时，可在设置里关闭代理——此时目标接口必须自行允许跨域。

1. 选择方法（GET/POST/PUT/DELETE/PATCH），填入完整 URL。
2. 需要鉴权时在 Headers 表单添加键值对（如 Authorization: Bearer xxx），或用 Auth 页签选 Basic/Bearer 快捷模板。
3. POST 类请求切到 Body 页签，选 JSON 表单或原始文本填写内容。
4. 点击「发送请求」，响应区显示状态码、耗时、响应体（自动格式化）与响应头。

2. 效率功能

• 环境变量：把不同环境的 baseUrl/令牌存成环境（如 dev/staging/prod），URL 里用 {{变量名}} 引用，切换环境不改请求。
• 历史记录自动保存最近请求，点击即回填参数；常用请求可另存为集合。
• 「导入 cURL」直接粘贴命令行 curl 语句还原成可编辑请求；「复制为 cURL」反向导出给终端用。
• 超时默认 30 秒（设置可调）；超时与手动取消会给出不同提示。Raw+JSON 请求体在发送前做语法校验。

3. 看懂响应：状态码与常见失败

状态码首位的数字是第一线索：2xx 成功、3xx 重定向（注意是否被登录页劫持）、4xx 请求有问题（401 鉴权、403 权限、404 路径）、5xx 服务端出错。如果响应体是一段 HTML 而非 JSON，说明请求没打到接口上——典型原因是路径被前端路由兜底或网关返回了错误页；工具会在顶部标出 Content-Type 与体的错配，并尽量抽出 HTML 页面标题。JSON 响应还会列出顶层字段，便于快速扫结构。代理模式下还需确认目标服务器的防火墙未拦截本站出口 IP。

4. CORS 报错的三层排查法

浏览器控制台的 CORS 错误信息天生误导——它只说「被浏览器拦截」，不说服务端到底回了什么。三层排查：第一层，区分「简单请求」与「预检」——非简单请求（自定义头、JSON body）先发 OPTIONS，报错多半发生在预检；第二层，用本工具直接发同一个请求（绕开浏览器同源策略）看服务端真实响应头——Access-Control-Allow-Origin 到底回没回、回的是域名还是 *、是否漏了 Access-Control-Allow-Headers 里的自定义头；第三层，确认是不是「响应正常但被浏览器拦」——curl 能通、浏览器不通，问题 100% 在响应头而非请求。本工具的服务端代理模式就是为第二层设计的：让你看到服务端裸响应。

5. 鉴权失败的四个高频原因

• Token 前缀：Authorization: Bearer <token>——漏 Bearer、多空格、大小写错是最常见的三连。
• Header 名大小写：HTTP/1 里不敏感但网关/框架可能敏感，X-Auth-Token 与 x-auth-token 在某些层被视为不同头。
• Token 过期但无 401 细节：先 decode JWT 的 exp（本站 JWT 工具），再决定是刷新还是重登。
• Cookie 场景的 credentials: include 与 ACAO 通配符冲突：带 cookie 时服务端不能回 *，必须回显具体域名。

6. 代理、超时与本地验收

默认服务端代理可测未开 CORS 的接口；关代理则走浏览器直连，用于复现 CORS。超时与取消提示不同；Raw+JSON 体会在发送前做语法检查。历史与集合、环境变量 {{name}}、cURL 导入导出可加速回归。含密钥的请求发完后清历史与屏幕，避免演示泄漏。