Insomnia

简介

轻量 API 客户端，适合 REST 与 GraphQL 调试。

下列说明侧重开发者如何在本站 API 目录选型后，用该工具完成联调与文档协作；具体功能与版本以官方产品为准。

类型

API 调试

相关链接

https://insomnia.rest/

能做什么

Insomnia 提供简洁的请求编辑、环境管理、GraphQL 支持与插件生态，适合本地快速试探 API，资源占用通常低于全功能协作套件。

典型工作流

• 新建 Request → 选方法/URL/Body
• 用 Environment 管理 base URL 与 Token
• GraphQL 页写 query 与 variables
• 导出请求供同事或转入 CI

何时用

个人开发者、需要离线或偏好桌面轻量客户端时。若强依赖团队协作与内置 Mock 门户，可对比 Postman。

注意点

同样遵守密钥卫生；升级大版本前备份工作区；企业代理环境需配置证书信任。

与 API 目录配合

从本站 API 详情页复制文档链接，在 Insomnia 中对照官方示例逐项复现。GraphQL 类接口可单独建 Folder，避免与 REST 环境变量混用导致 base URL 错误。

团队实践

桌面客户端适合个人快速试验；确定接口稳定后再迁入 Postman 集合或 OpenAPI 仓库。插件市场可扩展 OAuth 自动刷新，减少手动 copy token。夜间批量跑回归时，Insomnia 占用资源少，适合在笔记本上长时间开着。请求历史可按项目归档，避免与私人试验混在一起。