swagger相关内容

.Net Core 3.1 删除 Swagger UI 上的架构

我有 .Net 3.1 Web Api,我想删除这部分“架构";在 Swagger 用户界面上. 怎么做? 解决方案 不需要模式过滤器.经过几天的努力,我发现: 所有需要做的都在 app.UseSwaggerUI(options =>{options.DefaultModelsExpandDepth(-1);}); 注意:它是 DefaultModels(复数)而不是 Defa ..
发布时间:2022-01-22 18:24:33 其他开发

嵌套对象中的 OpenApi 必需属性不起作用

我需要描述一个 api,它在请求正文中有一个带有必填字段的对象,其中一个字段是一个对象本身,它具有另一组必填字段. 我正在使用 open api v3 和 swagger 编辑器 (https://editor.swagger.io/)在我将 .yaml 文件放到编辑器上后,我生成了一个 html 客户端(> 生成客户端 > html).然后我打开在获取此架构的 .zip 文件中生成的静态页 ..
发布时间:2022-01-22 18:24:25 其他开发

使用 JWT Bearer 令牌进行身份验证 Swagger

我们正在开发一个带有 JWT Bearer 身份验证的 .Net Core 2.1 Web API.应用程序本身将生成并分发要发送到后端的令牌. 虽然我们已经启动并运行了所有内容,即我们可以从 Angular 发送不记名令牌并使用 Postman 进行测试,但 Swagger 不会发送不记名令牌.我们添加了 Swagger 配置以使用 SecurityDefinition,如下所示,我将发布 ..
发布时间:2022-01-22 18:24:03 C#/.NET

禁用“试一试"在招摇

这个问题被问了很多不同的语言.经过大量(无果)浏览后,我感觉很愚蠢,但无论如何我都会问 本文档指的是在看似 Javascript 的内容中添加 Swagger 插件https://github.com/swagger-api/swagger-ui/issues/3725 我尝试将该代码添加为注入的 Javascript 资源: c.InjectJavaScript(thisAssem ..
发布时间:2022-01-22 18:23:39 C#/.NET

告诉 Swagger 请求正文可以是单个对象或对象列表

我正在使用 Swagger 和 Scala 来记录我的 REST API.我想为 POST、PUT 和 DELETE 启用批量操作,并希望相同的路由接受单个对象或对象集合作为正文内容. 有没有办法告诉 Swagger 参数是 A 类型值的列表或 A 类型的单个值? 类似于 REST 的可变参数. 解决方案 有没有办法告诉 Swagger 参数是 A 类型值的列表或 A 类型 ..
发布时间:2022-01-22 18:23:13 其他开发

如何更改 Swagger-UI “默认"小路

我尝试更改我的 json 文件中的 basePath,这似乎只更改了 swagger-UI 的底部“baseurl".我想摆脱作为我的 swagger-UI 的组标题出现的“默认".有没有人能够解决这个问题?我正在使用 Swagger ~2.0. 解决方案 Default 不是路径,而是标签. 在 Swagger 2.0 中,分组是使用标签完成的.每个操作都可以分配给零个或多个标签. ..
发布时间:2022-01-22 18:23:05 其他开发

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

我正在使用带有 ASP.NET Core Web API 的 Swashbuckle 6 (Swagger).我的模型以 DTO 作为后缀,例如, 公共类 TestDTO {公共 int 代码 { 获取;放;}公共字符串消息 { 获取;放;}} 如何在生成的文档中将其重命名为“Test"?我尝试添加一个带有名称的 DataContract 属性,但这没有帮助. [HttpGet]公共 IAc ..
发布时间:2022-01-22 18:22:27 C#/.NET

Spring Boot + Springbox 招摇错误

我有一个spring boot项目想通过springbox与swagger集成. 我的 Spring Boot 应用程序启动并运行良好. 但是我添加了springbox后,它无法通过单元测试. 这是我在项目中添加的详细信息. 对于pom.xml,添加 io.swagger ..
发布时间:2022-01-22 18:22:06 Java开发

如何在 OpenAPI 3.0 中定义标头参数?

在 OpenAPI (Swagger) 2.0 中,我们可以像这样定义标头参数: 路径:/邮政:邮政:参数:- 在:标题名称:X-用户名 但在 OpenAPI 3.0.0 中,参数被请求体替换,我找不到定义标头参数的方法,这些参数将进一步用于身份验证. 在 OpenAPI 3.0.0 中定义请求标头的正确方法是什么? 解决方案 在 OpenAPI 3.0 中,header 参数的 ..
发布时间:2022-01-22 18:22:00 其他开发

突然 Springfox Swagger 3.0 无法与 spring webflux 一起使用

应用程序几天前正在使用 Springfox Swagger 3.0.突然停止工作.一周前创建的 Jar 文件仍在工作,但现在当我们尝试构建一个新的 Jar 文件时,即使没有任何代码/库更改,它也无法正常工作.我什至参考了以下网址,但仍然面临问题. 404 错误与 swagger-ui 和 spring webflux 下面给出我的配置: POM 文件: ..
发布时间:2022-01-22 18:21:21 其他开发

从现有的 REST api 生成 Swagger 文档

给定一个现有的带有 JAX-RS 注释的 API,它接受 &返回带有杰克逊注释类型的json,有没有办法可以生成一些YAML Swagger文档?我的计划 B 是编写一些代码,使用反射来查找带​​有 REST 注释的类型,制作它们的参数的哈希图 &返回,然后为 Jackson 注释爬取这些类,并以这种方式生成文档. 我更愿意使用已经存在的解决方案来编写一次性的东西.我发现这个 Swagger ..
发布时间:2022-01-22 18:21:04 Java开发