如何为Logic App（标准版）生成OpenAPI/Swagger文档

架构老林

2026-9-2

Logic App（标准版）Swagger文档生成方法

Consumption类型Logic Apps可直接调用listSwagger终结点生成Swagger文档，但标准版Logic App采用单租户托管架构，没有原生暴露同名接口，可通过以下几种方式生成对应Swagger文档：

门户直接导出（操作成本最低）
进入Azure门户中目标标准版Logic App资源，打开需要生成文档的具体工作流设计页，点击顶部菜单栏的「导出」按钮，选择导出为OpenAPI 2.0（即Swagger）格式，即可直接下载生成完成的Swagger定义文件。
基于工作流原始定义转换生成
先通过Azure CLI或资源管控接口拉取目标工作流的完整结构化定义JSON，提取其中Request类型触发器的请求方法、访问路径、入参结构、返回响应结构等核心元数据，按照Swagger 2.0规范做字段映射即可生成标准文档，也可以借助通用OpenAPI格式转换工具完成批量映射，减少手动工作量。
本地开发环境直接获取
如果使用VS Code的Logic Apps标准版扩展做本地开发，本地启动工作流运行时后，直接访问本地服务的/swagger/json路径，就能拿到运行时自动生成的当前工作流Swagger内容，该内容和云上部署的工作流结构完全一致，可直接使用。