用途:Insomnia 是 Postman 的轻量替代品,用于 REST、GraphQL 和 gRPC API 的设计与调试,v9.0+ 强调本地优先(Local Vault)与 Git 同步。
主要能力:支持环境变量与层级环境配置(Base Environment 及 Staging、Production 等子环境),可通过响应链式引用从登录接口提取令牌并注入后续请求,例如在子环境配置中使用 {% response 'body', 'req_login_01', 'b64::JC5hY2Nlc3NfdG9rZW4=::46b', 'no-history', 60 %},后续请求以 {{ base_url }}/v1/users 加 Authorization: Bearer {{ auth_token }} 头引用。支持团队通过 Git 对集合、设计文档和测试进行版本管理。支持 gRPC 调用:新建请求选 gRPC,填写服务器地址如 grpc.infra.internal:50051,启用 Server Reflection 自动加载 Protobuf 方法定义,输入 JSON 负载后发送。
使用方式:Inso CLI 可用于 CI/CD 无头运行。安装命令为 npm install -g insomnia-inso;校验 OpenAPI 规范使用 inso lint spec "Company API Spec";对指定环境运行测试套件使用 inso run test "User Lifecycle Test Suite" --env "Staging" --ci。
适用场景:API 调试、自动化回归测试、OpenAPI 规范校验、gRPC 服务调用以及 Git 协作管理 API 集合。
限制与建议:不要将生产凭据明文存放在公开 Git 同步的集合中;避免跳过 OpenAPI lint;不要在各端点重复硬编码 URL,应统一引用 {{ base_url }}。常见问题:本地自签 SSL 证书导致校验失败,可在 Preferences > General 取消勾选 Validate SSL certificates;模板标签报 Request has no response 时,需先执行被引用的上游请求;Web 版受浏览器 CORS 限制,建议使用桌面客户端或配置 CORS 代理。其余细节暂未提供。