swagger相关内容

单元测试Swagger输出

我在ASP.NET MVC WebAPI项目中使用Swagger.该项目已安装Swashbuckle块软件包,并生成Swagger UI和Swagger/docs/v1.我遇到的一个一致的问题是,开发人员将通过不仔细命名其webAPI操作来破坏swagger文件.我想添加一个单元测试,以防止我通过部署后转到Swagger UI网站并看到在swagger UI中显示HTTP 500来发现swagge ..
发布时间:2021-04-11 20:34:35 其他开发

Swashbuckle + XmlComments在本地工作,但无法在服务器上生成摇摇欲坠

我有一个webapi项目,并且我正在使用swashbuckle框架来刷新api文档. 我已经按照说明使用控制器和DTO来构建文档xml文件,并且在本地都可以很好地工作. 但是,生成摇摇欲坠的文档时,会引发500错误.我已经确认是否删除了xml注册行,生成了大张旗鼓的文档,并成功返回了. 这是我的注册热线: GlobalConfiguration.Configuration.E ..

Web API:具有不同HTTP动词的相同方法

在WEB API控制器中,我们可以使用不同的HTTP动词使用相同的方法名称吗? [HttpGet]公共字符串Test(){返回“成功获取";}[HttpPost]公共字符串Test(int i){返回“成功发布";} Swagger不接受此配置.访问API方法时出现此错误: 500:“消息":“发生错误.","ExceptionMessage":"Swagger 2.0不支持:路径' ..
发布时间:2021-04-11 20:31:11 C#/.NET

Swagger无法与ASP.NET WebApi应用程序的多个版本一起正常使用

请帮助我,起初看起来很简单,现在我在项目中很晚: 我正在尝试为Swagger设置ASP.NET WebApi项目的API版本控制.API版本控制工作正常,调用不同的版本会返回正确的结果(请参见下文). 相反,Swagger无法同时提供两个版本.调试时,我注意到在SwaggerConfig.cs中调用 c.MultipleApiVersions(...)时, apiDesc.Action ..
发布时间:2021-04-11 20:30:37 C#/.NET

如何配置Swashbuckle仅忽略特定api版本的模型属性

我需要向模型中添加属性,并且已经实现了此处选择的答案中的建议,可以删除我用模型的 SwaggerIgnorePropertyAttribute 属性标记的属性.我的问题是,如果我的应用程序有多个API版本,如何从特定版本的swagger doc/schema中删除它?我只在乎不要大惊小怪地看到添加的属性.即使我有多个版本的应用程序,我在整个应用程序中实际上只有一个版本的模型. 我添加了这样的 ..

浏览器刷新或计算机重启后,永久存储Swagger UI令牌

是否有任何方法可以在本地计算机或开发环境中将令牌永久硬编码到Swagger UI中? 我们正在测试Net Core Apis,并通过Angular 8运行它们:开发,重建,编写代码,每天测试Swagger API超过100次.寻找方法,将令牌存储在下面,因此不必保留重新进入.几分钟累加起来,可能会很麻烦,很耗时间. 也许我们可以从开发人员桌面中的外部文件中读取令牌.令牌保持不变,因此即 ..
发布时间:2021-04-11 19:13:42 C#/.NET

NSwag-如何添加评论?

我在ASP.Net WebAPI项目中使用NSwag生成一个灵活的界面-效果很好. 说我有一种方法想要添加一些解释-我该怎么做? 通过评论,我的意思是当API的用户查看文档时会看到的东西. 我已经用谷歌搜索,加油并...躲开了?-但找不到任何相关信息.也许我使用了错误的术语. 解决方案 您可以使用关注在您的 .csproj 中 ..
发布时间:2021-04-11 19:01:40 其他开发

Swagger使用自定义的swagger.json文件aspnet核心

很确定我缺少明显明显但看不到的东西. 如何使用更新后的swagger.json文件? 我将样板swagger/v1/swagger.json代码粘贴到editor.swagger.io系统中.然后,我更新了说明等,在模型中添加了示例,然后将内容另存为swagger.json.将文件移到我的api应用程序的根目录中,将文件设置为始终复制. public void ConfigureS ..
发布时间:2021-04-11 19:00:53 其他开发

文件上传时,Swagger UI执行按钮不起作用

我的API中的一个端点是用于上传文件并提交有关该文件的详细信息.该API在ASP.Net Core中实现.NSwag软件包已安装在我的项目中.实施OAS 3规范 在Swagger UI上,我可以提交数据而无需上传文件.如果使用文件浏览器选择了文件,则单击“执行"按钮后将不起作用. 我检查了Chrome Dev工具中的“控制台和网络"标签.没有网络移动.根本没有任何要求.在控制台中均未看 ..
发布时间:2021-04-11 18:58:08 其他开发

在Swagger中为ASP .NET Core 3.1添加标头过滤器

我已经遵循了: Web Api如何为Swagger中的所有API添加Header参数 和这个: 如何在Swagger中发送带有请求的自定义标头用户界面? 但是,这些IParameter,Parameter或NonBodyParameters都不在ASP .NET CORE 3.1上工作. 我想在我的招摇头上添加一个标头,该标头带有一个租户ID,最好从登录的用户那里获取 ..
发布时间:2021-04-11 18:56:46 C#/.NET

当传递到ASP.NET Core 2.2中的[FromForm]使用的模型时,GUID的列表为空

编辑: 骗子骗子.请参阅我自己的修复程序. 我目前在使用HTTP POST和 [FromForm] 将GUID列表传递给控制器​​操作时遇到一些问题. 导航列表为EMPTY.如果我尝试将其转换为字符串列表,而不是具有3个值,则列表中只会显示1个值,并且它是包含3个值但用逗号分隔的字符串. 我使用[FromForm]的原因是因为我需要上传文件,但还要将其他一些数据传递给操作. ..
发布时间:2021-04-11 18:55:26 C#/.NET

.NET Core 2.1 Swashbuckle组控制器(按区域)

我的情况很简单.我有一个非常大的.NET Core 2.1 MVC/WebApi,分为几个区域,分别代表系统的不同模块.我使用Swagger(SwashBuckle),效果很好.我的路由类似于 {area}/{controller}/{action} . 在Swagger UI中,每个动作都被分组到控制器中(标准行为).我的控制器和操作列表变得非常庞大且难以掌握.因此,我很想Swagger可 ..
发布时间:2021-04-11 18:54:30 其他开发

Swagger崩溃与圆形模型参考

我有一个.Net Core 2.2 OData API,我想为此实现Swagger文档. 我一直在关注此示例: https://github.com/Microsoft/aspnet-api-versioning/tree/master/samples/aspnetcore/SwaggerODataSample 我已经做到了一点.现在,我的模型以循环方式相互引用时面临一个问题,让我解释 ..
发布时间:2021-04-11 18:54:22 其他开发