单元测试招摇输出
我在 ASP.NET MVC WebAPI 项目中使用 Swagger.该项目安装了 Swashbuckle nugget 包并生成 Swagger UI 和 Swagger/docs/v1.我遇到的一个始终如一的问题是开发人员会通过不仔细命名他们的 webAPI 操作来破坏 swagger 文件.我想添加一个单元测试，以防止我通过在部署后转到 Swagger UI 站点并看到在 swagger
..
swashbuckle相关内容
动作错误的swagger .net核心API模棱两可的HTTP方法
使用 .net Core 2 API 实现 Swashbuckle/Swagger 我现在在访问 swagger.json 时收到 500 错误: NotSupportedException:不明确的 HTTP 操作方法 -EBisAPI.Controllers._class.HandleError (EBisAPI).行动需要一个Swagger 的显式 HttpMethod 绑定 我
..
使用 Swashbuckle Aspnetcore 将 `host`、`basePath` 和 `schemes` 添加到 swagger.json
我正在使用官方文档逐步方法来配置 Swagger UI 并在我的 ASP.NET 核心 API 应用程序中生成 Swagger JSON 文件. 开始使用 Swashbuckle 和 ASP.NET Core 如果我查看生成的 swagger.json 文件 - 它缺少三个重要属性 host、basePath 和 schemes 请帮助我了解我可以添加哪些代码，以便生成的 swa
..
如何设置 Swashbuckle 与 Microsoft.AspNetCore.Mvc.Versioning
我们有 asp.net 核心 webapi.我们添加了 Microsoft.AspNetCore.Mvc.Versioning 和 Swashbuckle 以拥有 swagger UI.我们将控制器指定为: [ApiVersion("1.0")][Route("api/v{version:apiVersion}/[controller]")]公共类 ContactController : 控制器
..
在 UI 中为控制器中的操作添加嵌套分组部分
是否可以在操作分组中包含子部分?我们目前使用基于控制器的微分来分组功能，但托管了大量控制器并且可以使用进一步的嵌套. 换句话说，我知道动作可以按以下方式分组/排序，但可以多次分组: c.GroupActionsBy(apiDesc => apiDesc.HttpMethod.ToString());c.OrderActionGroupsBy(new DescendingAlphabet
..
当授权标签不包含角色时，我没有得到范围复选框，Ajax 授权请求也没有发送范围
更新 2:如果我从这里更改我的控制器授权标签 [授权] 到这里 [授权(角色=“读取")] 然后我得到范围选择的复选框，并且 ajax 令牌请求包含正确的范围并成功完成.然而，我仍然以红色感叹号结束.看起来 Swagger 或 Swashbuckle 要求角色与范围定义匹配?使用 Swashbuckle 时是否可以使用未定义角色的应用程序流?如果是这样，您如何使其工作?我是否必须在操作过滤
..
Swashbuckle MapType<类型>不适用于参数
我有一个将 ShortGuid 类作为参数的 API 端点，如下所示: [HttpGet("api/endpoint")]公共异步任务GetTablesAsync(ShortGuid id){} 生成一个大摇大摆的定义: “参数":[{“名称":“指导"，“在":“查询"，“必需":假，“类型":“字符串"，“格式":“uuid"},{“名称":“值"，“在":
..
Swashbuckle + XmlComments 在本地工作，但在服务器上生成招摇失败
我有一个 webapi 项目，我正在使用 swashbuckle 框架来清除 api 文档. 我已按照说明使用我的控制器和 DTO 构建文档 xml 文件，并且在本地运行良好. 但是，在生成 swagger 文档时，会抛出 500 错误.我已经确认如果我删除我的 xml 注册行，就会生成并成功返回 swagger 文档. 这是我的注册行: GlobalConfiguration
..
Swagger:支持可选路线
我有一个带有可选参数的路由: [Route("{categoryId?}")]公共 HttpResponseMessage 获取(int?categoryId=null) 但是，当我没有为 categoryId 提供值时，调用会在请求本身中包含 {categoryId?}... http://myhost/api/%7BcategoryId%7D 解决方案 Swagger 不支持可选路
..
如何将自定义模型绑定器与 Swashbuckle、Swagger 和 NSwag 一起使用?
我有一个包含以下端点的 ASP.NET Core Web API. [HttpGet][路线(“模型/{ids}")][产生(typeof(IEnumerable))]公共 IActionResult 获取([ModelBinder(typeof(CsvModelBinder))] IEnumerable身份证){//获取模型返回确定(模型)；}
..
Swashbuckle - 将模型和示例值从另一个项目的模型添加到 Swagger UI
我正在使用 Swagger 记录我的 .NET C# API，当我的模型在另一个项目中时，Swagger 只是崩溃并且不加载任何内容. 当我从 Visual Studio 加载示例 WebAPI 项目时，它使用同一项目中的模型并且可以正常工作: 但是当我使用其他项目中的模型时，它会在加载任何内容之前崩溃. 我有一个 API 项目和一个业务项目.我的模型是存储在我的商业项目中的视图
..
您如何在“请求和响应模型"中添加招摇的评论?
您可以像下面的示例一样对方法添加注释，但是向请求和响应模型添加注释呢? //////我的总结/////////备注在这里.//////必填参数:示例:///返回评论///好的 解决方案 是的，就像 Dimitar 说的
..
带有花饰的标头中的 API 密钥
我想使用 Swashbuckle (swagger for .net) 对 WebAPI 项目进行基于 API 密钥的身份验证. 我已将 swashbuckle 配置如下: 配置.EnableSwagger(c =>{c.ApiKey("apiKey").Description("API 密钥认证").Name("X-ApiKey").In("标题");c.SingleApiVersion
..
Asp.Net core Swashbuckle 设置 operationId
如何在 Asp.Net Core 2.1 项目中设置 swagger operationId 属性?根据 this 帖子我应该使用 SwaggerOperationAttribute 但我在 Swashbuckle.AspNetCore 库中找不到它.还有一个 IOOperationFilter 公共接口 IOperationFilter{无效应用(操作操作，OperationFilterCon
..
将查询字符串参数添加到我的 Swagger Specs
..
参数的 Swagger 默认值
如何为以下 API 生成的 swagger 中的属性定义默认值? 公共类 SearchQuery{公共字符串 OrderBy { 获取；放;}[默认值(订单方向.降序)]public OrderDirection OrderDirection { get;放;} = 订单方向.降序；}public IActionResult SearchPendingCases(SearchQuery quer
..
k__BackingField 在 C# 中删除(通过 Swashbuckle/Swagger 看到)
我在我的 ASP.NET webapi 项目中使用所有默认设置的 Swashbuckle 5.它序列化我的方法的输出，以便向我显示回复的模式.我收到的文档如下所示: 响应类(状态 200)模型模型架构[{"k__BackingField": "字符串","k__BackingField": "字符串",“k__BackingField":0}] 这是通过以下 C# 代
..
Swagger 无法与多个版本的 ASP.NET WebApi 应用程序一起正常工作
请帮帮我，一开始看起来很容易，现在我在项目中迟到了: 我正在尝试为 ASP.NET WebApi 项目以及 Swagger 设置 API 版本控制.API 版本控制工作正常，调用不同的版本返回正确的结果(见下文). 相反，Swagger 无法同时提供这两个版本.在调试时，我注意到当在 SwaggerConfig.cs 中调用 c.MultipleApiVersions(...) 时，a
..
Swashbuckle 参数说明
我正在使用 SwaggerResponse 属性来装饰我的 api 控制器操作，这一切正常，但是当我查看生成的文档时，参数的描述字段为空. 是否有基于属性的方法来描述动作参数(而不是 XML 注释)? 解决方案 用最新的Swashbuckle，或者说至少是Swashbuckle.AspNetCore 变体，参数的描述字段现在可以正确显示为输出. 需要满足以下条件: XML
..
Swagger 2.0 不支持:带路径的多个操作
我在 WebApi 2 应用程序中集成了 swagger.当应用程序具有单个控制器时，它可以正常工作.当我在应用程序中添加第二个控制器时.我收到以下错误: 发生错误.","ExceptionMessage":"Swagger 2.0 不支持:路径为 'api/Credential' 和方法为 'GET' 的多个操作.请参阅配置设置 - \"ResolveConflictingActions\
..