swagger相关内容

是否可以为SwaggerUI动态添加SwaggerEndpoint?

我们正在.NET Core中构建面向服务的体系结构.我们已经决定使用Ocelot作为我们的API网关.我已经将Ocelot与Consul集成在一起以进行服务发现.现在,我试图为所有下游服务创建一个统一的Swagger UI. 在发现服务之前,我们进行了以下Swagger设置: //启用中间件以将生成的Swagger用作JSON端点app.UseSwagger(c => {c.RouteTe ..

使用Swashbuckle Aspnetcore将`host`,`basePath`和`schemes`添加到swagger.json

我正在使用官方doc逐步方法来配置Swagger UI并在我的ASP.NET Core API应用程序中生成Swagger JSON文件. 开始使用Swashbuckle和ASP.NET Core 如果我查看生成的swagger.json文件-它缺少三个重要属性 host , basePath 和 schemes 请帮助我理解我可以添加什么代码,以便生成的swagger.json ..
发布时间:2021-04-11 18:37:24 C#/.NET

ASP Net Core 2.2仅向需要授权的方法添加储物柜图标-Swagger UI

版本: ASP Net Core Web API-2.2 Swashbuckle.AspNetCore-4.0.1 我目前有什么? 我已经在Web API项目中实现了大摇大摆.我在需要JWT授权的方法上使用 [Authorize] 属性. 所以我想要一种简单的方法来发送需要授权的请求.在我的 ConfigureServices 类中,添加了以下逻辑. services ..
发布时间:2021-04-11 18:31:48 C#/.NET

将Swagger UI添加到自定义.NET Web API

我想将Swagger UI集成到我的C#.Net Web API项目中.这与传统的Web API项目不同,在传统的Web API项目中,您可以安装SwashBuckle之类的工具,然后该工具将提取在控制器类中定义的HTTP路由并创建UI. 我拥有的是一个自定义实现,可以为不同的路由生成OpenAPI/Swagger 3.0 yaml文件. 我在通用控制器文件中定义了一个路由,该路由接受 ..
发布时间:2021-04-10 19:56:59 C#/.NET

如何在Swashbuckle 5中为ASP.Net调试错误500

我从Swashbuckle/Swagger得到了500错误,这与我能找到的最佳相关答案相反,我在错误响应中看不到任何其他信息. 我通过反复试验对控制器和操作进行注释来手动跟踪问题端点,直到隔离出不良的端点为止,但这很慢,并且没有告诉我为什么,某些端点具有问题.我该怎么做才能获得有关Swagger/Swashbuckle错误的有意义的调试信息? 我在ASP.Net 4.6.2 WebAp ..
发布时间:2021-04-10 19:42:44 C#/.NET

在没有ASP.NET模型验证的情况下,如何在Swagger中标记所需的属性?

我正在创建使用多个私有API(无法从外部访问)的公共API.已经为私有API编写了业务验证,但我不想为公共API重写它们.但是我确实希望招摇的文档是一样的. 这就是为什么我想知道是否可以在不使用ASP.NET的Required属性的情况下将属性标记为强制性的原因.但是大张旗鼓的文档表明它是强制性的.这可能吗? 解决方案 感谢Mohsin,我解决了我的问题.在提出以下代码之后,我创建了 ..
发布时间:2021-04-10 19:18:49 C#/.NET

Swagger UI Displays,但出现"ERROR"错误,指标

显示我的招摇用户界面,并且它显示了我的所有路线.一切看起来都很不错,除了右下角有一个红色的大ERROR指示灯.当我单击它时,会得到: {"schemaValidationMessages":[{"level":“错误",“消息":“无法从文件http://devxxxx.com:80/swagger/docs/v1中读取"}]} ..
发布时间:2021-04-10 18:50:32 Java开发

如何使用API​​ PLATFORM(符号4)将Login添加到swagger UI?

我安装了&配置LexikJWTAuthenticationBundle,它可以正常工作,但是我有一个小问题. 我已经包含用于放置JWT令牌的“授权"按钮,问题是我拥有令牌的唯一方法是使用以下命令: curl -X POST -H“内容类型:application/json" http://localhost:8000/api/login_check -d'{"username":"joh ..

如何在庞大的后端中实现新的媒体类型

我创建了一个大胆的规范,可以生成"application/zip" /config:得到:产生:-申请/邮编回应:200:#确定说明:所有配置文件架构:类型:字符串格式:二进制 我已经为此端点实现了处理程序,但出现此错误 http:紧急服务127.0.0.1:20366:applicationZip生产者尚未实现 此错误来自此代码 func NewSampleAPI(spec * ..
发布时间:2021-04-08 20:44:38 其他开发

Swagger ..无法呈现此定义提供的定义未指定有效的版本字段

无法呈现此定义提供的定义不指定一个有效的版本字段. 请指明有效的Swagger或OpenAPI版本字段.支持的版本字段大张旗鼓:"2.0",那些与openapi匹配的字段:3.0.n(例如,openapi:3.0.0). 我需要在哪里插入正确的版本来停止以下错误.Swagger编辑器工作正常,但是在启动特定项目时收到此错误.第一次使用Swagger.非常感谢 解决方案 您的.像 ..
发布时间:2021-04-08 20:42:54 前端开发

端点按资源大笔标注进行分组?

我正在使用Spring进行REST API开发.我有一些端点很多的API.当我打开swagger ui时,它看起来已经装满了. 我刚刚阅读了这篇文章,发现我们可以进行分组基于资源级别的端点. 我只想知道如何使用Spring的大笔注解来实现.非常感谢有人可以举一个例子. 我也想知道我们是否可以重新分组(以较高的级别分组)以上述方式得出的分组? 解决方案 ********** ..
发布时间:2021-04-08 20:40:46 其他开发

根据用户角色以醒目的方式列出api

我有一个要求,我想根据用户角色以醒目的方式列出api方法. 例如:- 具有基本访问权限的用户A可以使用有限的api方法. 具有管理员访问权限的用户B可以使用所有列出的api方法. 我不知道该怎么实现. 我正在使用 Swashbuckle.AspNetCore Version ="1.0.0" 解决方案 可能的解决方案: 在您的swagger配置中使用不同的组 ..
发布时间:2021-04-08 20:40:02 其他开发

如何将标题信息放入swagger json

我点击了swagger文档中的以下链接,为我的rest api创建了swagger json. https://swagger.io/docs/specification/2-0/describing-request-body/ 在我的rest api中,我具有请求正文和与服务请求一起出现的HTTP标头,例如Content-Type和Authorization. 我想知道是否可以 ..
发布时间:2021-04-08 20:39:11 其他开发