多步骤 API 调用一直是痛点:Swagger UI 的 Try it out 只适合单次请求,一旦要「建资源→取 id→调后续接口」,就得转投 Postman 环境变量、临时脚本或逐渐偏离 OpenAPI 规范的 collection。Enlace 的思路是去掉这层脚本:不写脚本、不建环境文件、没有服务端执行组件,直接把 OpenAPI 文档当画布,把响应字段接到后续请求参数上,整条链在浏览器里直连你的 API 运行。
快速开始:适配器只做两件事——托管 UI 和托管 OpenAPI 文档。多数框架已能生成该文档(FastAPI 内置、@nestjs/swagger、swagger-jsdoc、Swashbuckle、springdoc 等),直接把这个对象交给 Enlace 即可,无需额外维护 openapi.json。FastAPI 用 pip install enlace-fastapi,注册路由后调用 app.openapi() 传入;NestJS 用 npm install @get-enlace/nest,通过 EnlaceModule.setSpec 传入 SwaggerModule.createDocument 的结果;Express 用 npm install @get-enlace/express,把 swagger-jsdoc 生成的 spec 传给 enlace({ spec })。ASP.NET Core 和 Spring Boot 适配器也已可用。现有 /docs、/redoc 不受影响。
画布上拖入端点、填写参数,用 JSONPath 把上一个响应的字段映射到下一个请求,带自动补全。独立分支并发执行,依赖步骤自动等待。
调试:双击连接线布设断点,用 Debug 模式暂停执行、在请求发出前检查;Run 模式会忽略断点,可保留断点做完整运行。失败重跑:链路中途失败时,Rerun failed 只重跑未完成部分,复用已成功结果;Debug failed 同样断点续跑。自动保存:浏览器记住上次会话的画布布局与状态,刷新不丢。导出导入:可导出 .enlace 文件,部分导出保留凭据结构但剥离密钥,完整凭据导出始终密码加密。
并发执行不依赖调度服务:Enlace 遍历依赖图,把就绪节点分组,在浏览器内逐层并发运行,无 worker、无队列、无外部调度器。
全程无代理:浏览器与适配器之间只传 UI 资源和 OpenAPI 文档,实际执行请求直连你的 API。适配器不代理流量,粘贴的 bearer token 只存在于该标签页的浏览器内存中,不进适配器日志、不落盘、不经过第三方。
Enlace 目前是 0.0.9 早期 beta,适配器覆盖 FastAPI、Express、NestJS、ASP.NET Core 和 Spring Boot。信任模型与 Swagger UI 的 Try it out 一致,只是从单次调用扩展到了整条链。
GitHub
🔗 原文:点击查看