swashbuckle 相关问题

如何在 Swagger .json 文件中包含ControllerXmlComments？

对于我的 .net core 8.0 api 项目，我使用 Swashbuckle.AspNetCore 6.5.0 到 .AddSwaggerGen()，它在 http://localhost:5229/swagger/my_api_name/swagger 生成并提供 .json 文件。 json t...

swagger 身份验证如何工作？

嗨，我已经为我的 .net core Web 应用程序开发了 swagger UI。我已经添加了身份验证。我已在 Azure AD 中注册了两个应用程序。一种用于 Swagger，一种用于后端 .Net core...

ASP.NET Core 6 中的 AddEndpointsApiExplorer 是什么

我正在将 ASP.NET Core API 项目从 v5 升级到 v6。 v5 中的服务配置： services.AddSwaggerGen(); v6 中的服务配置： builder.Services.AddEndpointsApiExplorer(); // 这是什么？ 建设者。

如何从 jsonresult 响应自动生成 OpenAPI 文档？

Swashbuckle可以根据代码自动生成API文档（有详细返回模型） [http获取] 公共 ActionResult> GetStudents() { 返回 CollegeReposi...

Swashbuckle.AspNetCore 必需的查询字符串参数

我有一个带有 Swashbuckle.AspNetCore 包的 ASP.NET Core v2.1 项目。 我的代码是： /// /// 为当前驱动程序设置新的android令牌 /// /// <

使用相同动词的多个路由到 .NET6 REST API 控制器

自从上次使用 .NET Core 2 以来，已经有一段时间了，它似乎毫无障碍地工作。 但自从开始使用 .NET6 以来，我似乎很难让 ApiController 具有多个路由。 相关

Azure 函数：OpenApi/swagger 忽略 System.Text.Json.Serialization.JsonPropertyName 属性

我有一个由http触发的简单的azure函数： [OpenApiOperation(操作Id: "GetX", 标签: new[] { nameof(GetXHttpTrigger) })] [OpenApiParameter(名称: "id", In =

如何显示来自baseRequestDto的swaggerUI请求示例？

我有一个带有 Swashbuckle 文档的 WebAPI 项目。我有另一个项目将我的抽象和基类放在那里，并且我实现了一个基类来包含一些必需的

ASP.Net MVC - Swashbuckle 无法识别任何控制器

我正在尝试使用 Swashbuckle 将 Swagger UI 集成到我的 ASP.Net MVC 项目中，但我遇到了 Swashbuckle 无法识别我的任何控制器/端点的问题。 为了简单起见，我创建...

ASP.NET Core 7 Web API Swagger UI / Swashbuckle 版本控制问题路线相关

我已在 .NET 7 测试项目（从版本 3/4 开始）中成功对 Swagger UI 进行了版本控制，但是当我将此方法应用于现有项目时，我开始出现不一致的行为。我

为什么我的Swagger index.html页面发布后是空白的？

我正在编写 ASP.NET Core Web API。我的环境是 ASP.NET Core 5.0，开发中使用 Windows 10 和 Visual Studio 19，生产中使用 Windows Server 2016 和 IIS。我正在使用 C# 进行开发，并且

为什么 Swashbuckle/Swagger 在参数中包含变量名称？

对于较旧的网络框架项目，我使用的是 Swashbuckle 5.6.0。当我使用类作为 get 参数时，会发生奇怪的事情。它将变量名称添加到参数中。 这意味着消费...

如何生成默认版本的swagger集合？

我正在尝试使用 Asp Versioning Mvc ApiExplorer 库创建版本控制的 swagger。 我遵循基本指南文档并应用了操作过滤器，但即使我指定了

在 .NET 6 中使用 Swashbuckle 和 OAuth 代码流，swagger UI 没有发送任何身份验证标头

我正在尝试使用 PCKE 获取 OAuth 代码流，以便与 .NET 6 中的 Swashbuckle (6.2.3) 和 swagger ui 一起使用。有一些成功发生的事情： 在 swagger UI 中，我可以单击“Authoriz...

防止 Swashbuckle 设置“接受”标头

我有一个 .NET 7 Web API 项目，在其中使用 Swashbuckle.AspNetCore 生成 Swagger UI。 我的端点之一可以根据响应状态代码返回不同的 Content-Type 值；

最小 API - 定义 Swagger 标头参数

我正在使用 Swagger 和 C# 创建一个最小的 API。我真的无法理解如何定义标头参数。类似于 [SwaggerHeaderParameter("apikey", "description...")...

如何让 Swagger UI 为 POST 正文内容提供文本框？

我们的 ASP.NET Core 应用程序有一个端点，它直接读取 Request.Body 流，而不是使用端点参数和 [FromBody]。 [HttpPost(“事件”)] 公共任务 PostEvent(字符串 cl...

使用 Swashbuckle 创建 OpenAPI 规范中控制器、方法和标签的嵌套结构

问题是，我有一个 ASP.Net Core Web API 应用程序，它使用 Swashbuckle 的 SwaggerGen 来生成 OpenAPI 规范。有控制器，例如EmployeesController和

.Net Core 将 Swashbuckle favicon 从自定义 html 更改为

我正在尝试为我们的.net core api 自定义 favicon 并将其设置为我们项目结构中的图像。我无法加载它，并且尝试了一些不起作用的方法...

Swashbuckle - 在 swagger 文档中将字符串视为枚举

我正在使用 FluentValidation，我只想从 Fluent 验证器接收我的自定义错误。这就是为什么我的请求类中的所有属性都是字符串。不过，我也想有更好的