分享一款 API 调试工具,请求和配置都留在本机

12 阅读4分钟

调接口时,第一条请求往往很简单:选 GET,填地址,点发送。

麻烦通常出现在后面。同一个接口要测不同参数,开发和测试环境的地址不一样,几个请求都要带 Token。临时开了不少标签,过几天再来找,上次那条请求却没保存。

Postman、Apifox、cURL 都能处理这些事情。选工具时,除了能不能发请求,还可以看看:常用请求怎么整理,环境怎么切换,配置保存在哪里。

如果主要是个人日常调试,希望把请求留在电脑上,可以按下面这套流程组织。

先保存请求,再把公共配置提出来

请求起个具体的名字,比如“订单详情”,放到订单模块的集合里。地址、参数、请求头和正文一起保存,下次再测时只改需要变化的部分。

多个请求共用同一个服务地址,可以提成环境变量:

baseUrl = https://httpbin.org

请求地址:{{baseUrl}}/get

开发、测试环境分别设置变量值,切换环境后复用请求。这样公共地址不会散落在每个标签里。

敏感的 Token 也可以用变量管理,不过需要另外确认它如何保存。方便复用和保护敏感值,是两个都要考虑的问题。

这些操作,在一个本地工作区里完成

Muse Nexus 的 API 工具提供本机集合、请求标签和环境变量。日常的“打开请求—改参数—发送—看结果”,都在这个窗口里完成。

API 调试界面

官网演示截图,请求和响应为示例数据。

左侧用集合和文件夹组织请求,中间设置参数、请求头、鉴权和正文。请求可以保存到集合里,下次打开继续修改。

环境可以从顶部选择,变量面板里编辑对应的值。标记为敏感的变量由系统凭据存储保护,普通工作区配置保存在本机。

账号登录用于试用、会员资格等功能,目前不会把请求集合当作账号工作区同步到其他电脑。需要跨设备使用时,这个边界也值得提前了解。

请求发出去以后,结果怎么看

响应区可以切换美化、原始、预览和响应头视图,同时显示状态码、耗时和大小。

返回 JSON 时,美化视图方便查看结构;要确认服务到底返回了什么,切到原始内容。预期是 JSON,却收到一页 HTML 时,可以结合响应头里的 Content-Type 判断下一步从哪里排查。

工具也提供请求取消。接口一直没有返回,可以停止这次等待,再检查地址、网络或服务状态。

这里说的“保存在本机”,指的是请求工作区和配置。点发送以后,请求仍然会发往填写的目标地址,目标服务会收到相应参数和正文。

已有 cURL 或接口文档,也能接着用

有时后端给的是一条 cURL,或者项目里已经有 OpenAPI 文档。工具支持导入 cURL,以及导入 OpenAPI 的 JSON / YAML 文件,再继续调整请求。

请求正文可以选 JSON、文本、表单或 Multipart。上传文件时,Multipart 字段能分别设置文本和文件类型,不用手工拼请求正文。

这些功能对应的都是很具体的日常操作:复用别人给的请求、切换自己的测试环境、提交 JSON,或者上传一个测试文件。

可以从常用的几条请求开始试

如果你的需求主要是个人接口调试、保存集合和切换环境,这套本机工作区可以试试。拿自己熟悉的几条测试请求走一遍,比只看功能列表更容易判断是否顺手。

Muse Nexus 是我正在做的桌面工具集,API 调试是其中一个独立工具窗口。Windows 版已上架 Microsoft Store,首次登录有一个月全工具试用,之后完整功能需要会员。

截图和安装入口在 官网 lingban.xyz。