问题标签 [nswag]

我的服务器使用 .Net Core 2.1.402

这是我的 C# 类：

这是我的 C# 控制器

我使用nswag生成客户端服务，但目前上传多个文件存在错误（https://github.com/RSuter/NSwag/issues/1421#issuecomment-424480418），所以我扩展了更新方法来创建我的，这里是代码：

我想同时上传多个文件和数据，在这种情况下，所有图像都链接到 SampleDetailsDto。但是我们也可以想象这种情况也有这种情况：

是否可以将数据 + 多个文件发送到 .net Core Web Api？

谢谢

我正在使用 ASP.NET Core 和 NSwag 来托管和描述在 IIS 中托管的具有 Windows 身份验证的新 Web 服务。

在本地，我使用 https 运行 Web 服务，但是当我部署到测试环境时，Web 服务位于具有 SSL 卸载功能的负载均衡器后面。这意味着即使站点在浏览器中看起来是在 SSL 下运行的，但 IIS 中的实际绑定是 http。所以我的 Swagger UI 页面（和 swagger.json 定义）将支持的方案描述为 http。

我想要 Swagger.json 中的 Schemes 元素，我用它来读取“https”而不是“http”。谁能帮我找到我需要在代码中设置的属性以手动设置方案？

我有一个使用 NSwag 生成其 Swagger Json 的 .Net Core v2.1 Web API。

我有一个这样的响应模型-

生成的 Swagger JSON -

当在 JSON 上运行 swagger codegen 时，我在 C# 的 IO.Swagger 项目中得到以下 LoginResult 模型（选择了 targetFramework 5.0） -

有人可以帮助描述我如何让枚举生成与使用 swagger-codegen 的 IO.Swagger 生成的客户端代码中的原始 LoginResult 模型具有相同的名称等吗？

嗨，亲爱的 NSwag 社区！

我想扩展 NSwag 的 TS 生成模板以包括对响应的验证。例如，如果我的（导出的）DTO 看起来像这样：

NSwag 能否为我提供扩展模板以输出类似这样的代码所需的所有属性？

编写模板对 be 来说不是问题，但我不知道从哪里获取所有这些属性（就模板而言）。

最近我已经安装NSwag.AspNetCore到我的ASP.Net Core 2.1项目以生成 api 文档，这是我在Startup.cs文件中的源代码：

}

起初，我运行了这个项目，它成功了。但在第二次，在我安装NSwag.Annotation和卸载它之后。当我启动我的应用程序时，端点没有 Swagger UI：<myhost>/swagger并且状态为：404

任何人都可以帮忙吗？谢谢，

有没有一种方法可以指定自定义ISwaggerGenerator或调用某些方法或程序来生成 swaggerswaggerGenerator部分中的输出规范nswag.json？

标准fromSwagger生成器似乎只使用输出路径，所以作为最后的手段，我可​​以使用exec 任务来创建名为那里的文件。但是直接在nswag.json.

我的一些控制器需要在有效请求中定义自定义标头。
到目前为止，我知道添加标头的唯一方法是[FromHeader(Name = "X-Custom-Data")]在我的操作方法中显式定义一个参数。

但是，我有一个中间件在调用操作方法之前运行，并且在此中间件中评估标头。因此，我真的不需要动作本身中的标头值。

我现在正在寻找的是一种让 swagger 生成器知道此请求需要自定义标头而无需将其指定为方法参数的方法。

因为我找不到任何属性，[SwaggerResponse]但对于标题，我想问你们是否知道任何解决方案。

当我们将 NSwag 与 ASP.Net Core Service Fabric 服务的默认设置一起使用时，该服务更改了HttpSys侦听器 url（添加了路径后缀），生成的 swagger.json 和 UI 找不到/无法访问。

设置 HttpSys Listener 的 url 路径：

并为 ASP.Net Core 服务设置应用程序 NSwag：

我正在尝试在项目构建期间使用 NSwag 生成客户端。它这样做了，但是它将cs文件直接放在我要从中获取规范文件的webapi项目中的一个文件夹中。

我想将它输出到另一个项目。如果文件在它自己的程序集中，在此步骤中是否可以制作 nuget 包？不尝试共享 webapi 源代码。

有招摇，也有 nswag。

NSwag 做了一些客户端生成。

是否可以生成客户端并将其显示为 Swagger UI 上的链接供消费者下载和使用？