和「只格式化 JSON」的区别
这篇讲的是 HTTP 接口请求:真的发一次 HTTP/HTTPS,拿回状态码、响应头和 body。若你已经拿到响应、只想树形展开 JSON,用 用浏览器调试 API 响应 里的格式化/JWT 路径更合适。
工具支持 GET/POST/PUT/PATCH/DELETE/HEAD/OPTIONS,参数、Header、Body 分栏编辑,响应区显示耗时、体积,JSON 可美化。自带「导入 cURL」「导出 cURL」,方便把浏览器或文档里的命令搬进来。
数据怎么走(必读)
点击发送后,浏览器会调用站点的 /api/v1/http-proxy 接口,由 WoDeTool 服务端代你请求目标 URL,再把结果返回页面。不是纯浏览器直连外站,也不会在页面里替你连公司 VPN 内网。
服务端会拒绝 localhost、解析到私网/保留地址的域名、以及非 http(s) 的 URL。内网 API 要用本机 Postman/curl,不能只靠这个工具。请求 body 上限约 256KB,响应 body 上限约 1MB,超出会截断并提示。代理接口有频率限制(开发与生产以实际限流为准)。
从 cURL 起步
Chrome「复制为 cURL」或运维文档里的命令,点「导入 cURL」粘贴,再点应用。工具会拆出方法、URL、Query、Header、Body;并自动去掉 Accept-Encoding,避免代理解压与浏览器显示不一致导致 body 为空。
默认示例 URL 为 https://httpbin.org/get,可先点发送确认链路通,再换成 staging 域名。URL 没写 https:// 时,页面会按 https 补全。
端到端实操流程(图示)
常见失败与边界
401/403 多半是鉴权:JWT 过期可读 解码 JWT 看过期;刷新 token 别长期留在截图或分享链接里,响应标「已截断」时别当完整日志归档,换更小分页或查服务器日志。
常见问题
QVPN 里能访问公司内网 API,这个工具行不行?
A不行。代理会拦私网解析和 localhost,内网请用本机 curl 或 Postman。
Q导入 cURL 后响应 body 是空的?
A确认导入时去掉了 Accept-Encoding,代理解压后页面才能显示正文。
Q和 Postman 环境变量、集合比?
A本页没有 env 文件;改 staging base URL 用 Params 或整段 URL,敏感 Header 手改。
Q返回 429 或「请求过多」?
A命中 /http-proxy 限流,降频或缩小 body,别拿这里压生产。
实操示例(分步)
1. 从 DevTools 复制:curl 'https://staging.example.com/api/v1/health' -H 'Authorization: Bearer eyJ...'
2. 打开 HTTP 接口请求 → 导入 cURL → 应用。
3. 确认方法 GET、URL 为 https://staging.example.com/api/v1/health,Authorization 行启用。
4. 发送,期望 200,耗时与 body 大小出现在状态行旁。
5. 响应为 JSON 时点「美化 JSON」,或复制到 JSON 格式化。
6. 若 401,解码 JWT 看 exp(见 decode-jwt-check-expiry),换 staging token 再发。
7. 若 502,导出 cURL 给后端,并用 HTTP 状态码 核对含义。
8. 用 URL 解析 核对下次要测的带 query 的 GET /search?q=... URL。