swashbuckle 相关问题

带有 Swagger 的 Asp.Net Core：404 响应 swagger.json，没有任何错误

在我的 Swagger 页面上出现常见的“响应状态为 404 https://localhost:7247/swagger/v1/swagger.json”错误。 如果我手动打开并访问该页面，我不会收到任何 Asp.Net 错误...

使用 ASP.NET Core Web API 重命名 Swashbuckle 6 (Swagger) 中的模型

我正在将 Swashbuckle 6 (Swagger) 与 ASP.NET Core Web API 结合使用。我的模型以 DTO 作为后缀，例如， 公共类 TestDTO { 公共 int 代码 { 获取;放; } 公共字符串消息{获取;放; } ...

同时使用 Swagger UI Json 和文件

我需要你的帮助。 Swagger UI 无法在请求正文中包含 json 和文件。 我看了这个帖子。 关联 最后评论中的解决方案工作正常，但我在表单下有一个 json

Swagger 返回“规范中没有定义操作！”

我正在开发一个 .NET Core 3.1 Web API 应用程序，我盯着这个屏幕看了一会儿。 我已经在我的项目中安装了 Swashbuckle.AspNetCore -Version 5.5.0，并且我做了以下操作

无法从ISchemaFilter中的ServiceProvider获取FastEndpoint验证器实例的IValidator<T>

我正在使用 FastEndpoint 在请求中执行一些验证，因此，我需要获取 IValidator 的实例，以便使用反射获取其属性，但它对于某些 r 返回 null...

Swagger 参数默认值

如何定义从以下 API 生成的 swagger 中的属性的默认值？ 公共类搜索查询 { 公共字符串 OrderBy { 获取;放; } [默认值（订单方向.描述...

如何在.Net Core 中使用 NSwag 阻止默认 api 版本显示在 swagger 文档中？

在 .net core 中使用以下方法修复 Api 版本控制后 services.AddApiVersioning（选项=> { options.AssumeDefaultVersionWhenUnspecified = true; ...

Swagger - Web API - 可选查询参数

[HttpGet] [路线(“学生”)] [SwaggerOperation(标签 = new[] { "学生" })] [SwaggerResponse(HttpStatusCode.OK, 类型 = typeof(ResponseModel>))] [SwaggerResponse 示例(

在OperationFilter中检索API的响应内容类型

例如，考虑一个 API： var builder = WebApplication.CreateBuilder(args); builder.Services.AddEndpointsApiExplorer(); builder.Services.AddSwaggerGen(o => o.OperationFilter 例如，考虑一个带有 : 的 API var builder = WebApplication.CreateBuilder(args); builder.Services.AddEndpointsApiExplorer(); builder.Services.AddSwaggerGen(o => o.OperationFilter<CustomFilter>()); var app = builder.Build(); app.UseSwagger(); app.UseSwaggerUI(); app.MapGet("/", () => { }).WithOpenApi(); app.Run(); 此 API 可以返回内容类型为 application/json 和 application/xml 的响应。 我想创建一个自定义 OperationFilter 来生成具有 API 内容类型可能性的 OpenApi 响应 : public class Foo { } public class CustomFilter : IOperationFilter { public void Apply(OpenApiOperation operation, OperationFilterContext context) { var schema = context.SchemaGenerator.GenerateSchema(typeof(Foo), context.SchemaRepository); operation.Responses.Clear(); var response = new OpenApiResponse(); var apiResponseTypes = new[] { "application/json", "application/xml" }; // <- How get this from API metadata? foreach(string responseType in apiResponseTypes) { response.Content.Add(responseType, new OpenApiMediaType { Schema = schema }); } operation.Responses.Add("200", response); } } 如何检索OperationFilter中的API响应内容类型？ 要在自定义 OperationFilter 中检索 API 响应内容类型，您可以从操作方法的属性访问 ProducesAttribute。 public class CustomFilter : IOperationFilter { public void Apply(OpenApiOperation operation, OperationFilterContext context) { var schema = context.SchemaGenerator.GenerateSchema(typeof(WeatherForecast), context.SchemaRepository); operation.Responses.Clear(); var response = new OpenApiResponse(); // Get the ProducesAttribute from the action method var producesAttribute = context.MethodInfo.GetCustomAttribute<ProducesAttribute>(); if (producesAttribute != null) { foreach (var responseType in producesAttribute.ContentTypes) { response.Content.Add(responseType, new OpenApiMediaType { Schema = schema }); } } operation.Responses.Add("200", response); } }

.Net core Swagger使用FromForm时不显示参数说明

我有一个控制器方法： /// /// 测试接口 /// /// 来自表单 /// <

在OperationFilter中检索API的响应内容类型

例如，API 具有： var builder = WebApplication.CreateBuilder(args); builder.Services.AddControllers().AddXmlSerializerFormatters(); builder.Services.AddEndpointsApiExplorer(); 建造者.Servi...

构建失败后生成swagger.json文件

我有一个 ASP.NET Core 6 Web API，我尝试在构建后而不是在运行时生成 swagger.json 文件。 我试图使用 dotnet new tool-manifest 然后 dotnet tool install --vers...

在 Swagger/Swashbuckle 中切换文档扩展

要配置 Swagger 部分最初是否折叠，我可以使用 SwaggerUIOptions.DocExpansion。但是是否可以在页面上添加一个链接或按钮来展开或折叠所有

Swagger Swashbuckle 多态性不适用于接口类型

通过下面的代码，我试图提及替代模式；它们共享相同的接口，作为响应的类型。 启动.cs 服务.AddSwaggerGen(c => { c.UseOneOfFor多态性...

如何在 Swashbuckle 中为不同媒体类型指定响应正文示例？

我有一个 ASP.NET Core 7 Web api，带有各种输出格式化程序，如 CSV、XML、纯文本等。 我在 AddControllers 方法中添加这些格式化程序，例如： builder.Services.AddControllers（操作...

swagger swashbuckle 不支持嵌套类作为操作方法参数

我正在使用asp.net 5 我有两个嵌套的模型类，两个内部类都命名为 Command 公共类编辑模型 { 公开课命令 { 公共 int Id { 得到;放; }

招摇错误：schemaIds 冲突：检测到类型 A 和 B 的重复 schemaIds

使用Web API并使用swashbuckle生成swagger文档， 我在两个不同的命名空间中定义了两个具有相同名称的不同类。当我在浏览器中打开 swagger 页面时，它显示...

如何在授权 swagger ui 中添加自定义标头？

如下代码所示，在.NET中的Web API Project中实现，可以像图片一样通过登录在swagger中发行token。 但除了

使用 .NET 从 swagger UI 中删除默认的“字符串”

我在 .NET 5 中使用 Swagger 单击“尝试一下”后，Swagger 将在正文中显示一个“字符串”。 （请看下面的截图） 我希望它显示“{}”。 这就是我...

将嵌入的js/css文件注入Swashbuckle

可以通过将 js/css 放置在 /wwwroot 中，然后使用 InjectJavascript 和 InjectStylesheet 选项来包含它们。 但是我怎样才能注入作为嵌入资源存在的文件呢？它使用...