Question

我们正在尝试为.NET Web API生成Swagger 1.2规范JSON。我尝试过使用Swashbuckle，但它似乎只生成Swagger 2.0规范JSON。

有没有人知道如何从.NET Web API生成Swagger 1.2 JSON（使用是否使用Swashbuckle）？

Answer 1

不确定为什么要在Swagger 2.0上使用Swagger 1.2，但你仍然可以使用Swashbuckle，只能使用它的旧版本，例如https://github.com/domaindrivendev/Swashbuckle/tree/v4.2.0。

Answer 2

可以使用swagger将swagger.json文件作为项目构建的输出生成。在您的webApi .csproj文件中，添加以下部分：

<Target Name="NSwag" AfterTargets="Build">
    <Exec Command="$(NSwagExe) webapi2swagger /infotitle:&quot;$(AssemblyName)&quot; /assembly:$(TargetPath) /output:$(OutDir)/$(AssemblyName).swagger.json" />
  </Target>

您还需要为您的API控制器方法分配属性，例如： [SwaggerResponse（HttpStatusCode.OK，类型= typeof（对象））]

如何使用.NET Web API生成Swagger 1.2 JSON

2 个答案: