swagger-ui相关内容

如何从 Swagger UI 中删除控制器列表

我使用的是 springfox-swagger-ui 2.8.0,它随 Swagger UI 3.7.0 一起提供. 我想去掉 api 文档页面前面的控制器列表,对我来说很没用(每个选项卡都是空的). 我已经尝试使用@ApiIgnore 注释控制器类,但是当然这也删除了我需要的其余 api 文档. 基本上,我想删除这个: 同时保持这个: 我翻遍了在线文档、GitHub ..
发布时间:2021-09-01 20:23:02 Java开发

无法从 Swagger UI 中的文件问题读取

我已经在我的应用程序中加入了 swagger-ui. 当我尝试查看 swagger-ui 时,我很好地获得了 API 的文档,但一段时间后它在按钮上显示了一些错误图标. 错误信息如下: [{"level":"error","message":"无法从文件中读取http://MYIP/swagger/docs/v1"}] 我不确定是什么原因造成的.如果我刷新它就可以工作并在几 ..
发布时间:2021-09-01 20:23:00 其他开发

swagger UI 替代品列表

是否有 Swagger UI 替代方案?我已经知道了: http://swaggerui.herokuapp.com/#!/pet/addPet http://public.redfroggy.fr/swagger2 解决方案 是的,有几个. ReDoc [swagger.io 上的文章] [GitHub] [demo] - 重新发明的 OpenAPI/Swagger 生成的 ..
发布时间:2021-09-01 20:22:57 其他开发

如何更改操作在 Swashbuckle 中的组中列出的顺序?

我正在使用 Swashbuckle 生成 Swagger UI.它具有用于选择分组键(默认为控制器)和组排序的选项,但我想为组中的操作选择一个顺序,以便 GET 始终出现在 之前例如删除. 我已经找到了如何实现文档过滤器,我可以通过 HttpMethod 获取和订购 ApiDescriptions,但是更改 ApiDescriptions 中的顺序不会没有反映在生成的 Swagger UI ..
发布时间:2021-09-01 20:22:53 C#/.NET

Springboot 大摇大摆与 JsonView

是否可以将 swagger 与 @JsonView 集成?我有一个模型,我使用 @JsonView 只返回几个字段,但 swagger-ui 显示了孔模型. 这是我的模型: 公共类 Intimacao 扩展 EntityBase {@嵌入式@JsonView({View.Intimacao_Lista.class})私人 Devedor 开发商;@嵌入式私人萨卡多萨卡多;@嵌入式私人 Ap ..
发布时间:2021-09-01 20:22:50 其他开发

如何在 Swagger UI 的标记中插入小的自定义?

我有一个使用 Swashbuckle(Swashbuckle.AspNetCore.SwaggerGen 3.0.0 和 Swashbuckle.AspNetCore.SwaggerUi 3.0.0)记录的 .NET Core 项目.我的目标是在带有 title 类的 DIV 正下方添加一个自定义标签(即在服务名称下方但在端点上方). 当我调查 Swagger UI 标记时,我看到有一个带有 ..
发布时间:2021-09-01 20:22:46 前端开发

为什么“服务器没有响应"?在 Swagger UI 中?

我的 API 调用在 Postman 中正常工作.但是当我从 Swagger UI 发送请求时,它对所有请求都显示“服务器无响应": 响应正文 没有内容 响应代码 0 响应头 {“错误":“服务器无响应"} 问题是什么以及如何解决? 浏览器控制台显示以下错误: 无法加载资源:net::ERR_CONNECTION_REFUSED 未捕获的类型错误:无法读 ..
发布时间:2021-09-01 20:22:41 其他开发

Swagger-ui 无法访问 JS 脚本

我遵循了 swagger-ui 安装,但我无法得到这个工作.问题是无法访问 java-script 文件.名称似乎是错误的 - index.html 需要 SwaggerUiStandalonePreset.js 而在 /dist 目录中只有 swagger-ui-standalone-preset.js. 我认为这是一个问题,但是 github 上的免责声明 解释说: ..
发布时间:2021-09-01 20:22:38 其他开发

Swagger UI 是否有路径的永久链接?

是否可以链接到 Swagger UI 中显示的特定路径,例如下图中的 /work/2.1? 我想从外部网页链接到各个路径. 解决方案 是的,Swagger UI 有 永久链接 用于操作和标签.要获得永久链接,请展开操作或标记并复制地址栏中的 URL.永久链接如下所示: index.html#/tagNameindex.html#/tagName/operationId 当有人在浏 ..
发布时间:2021-09-01 20:22:35 其他开发

如何在 Swagger UI 中隐藏模型部分?

我使用 Swagger UI 来显示 API 文档.默认情况下,它会在底部显示“模型"部分: 如何隐藏? 解决方案 要隐藏“模型"部分,请将 defaultModelsExpandDepth: -1 添加到 index.html 中的 Swagger UI 配置代码.html. 注意选项名称使用复数 Model*s* 而不是 Model. //index.htmlwi ..
发布时间:2021-09-01 20:22:32 其他开发

带有多个 URL 的 Swagger UI

我在 swagger ui 文档中看到,您可以提供一个 urls 参数: Topbar 插件使用的 API 定义对象数组 ({url: "", name: ""}).当使用并启用 Topbar 插件时,将不会解析 url 参数.名称和 URL 在此数组中的所有项目中必须是唯一的,因为它们被用作标识符. 我希望这会给我一个选择器,我可以从中选择要处理的 yaml 文件.不幸的是,它似乎没 ..
发布时间:2021-09-01 20:22:29 其他开发

如何用实际示例替换模型架构主体参数

我有 spring-boot/spring-mvc 和 springfox swagger2 集成.我附上了示例屏幕截图.在“body"的参数类型中,我有一个描述元素数据类型的模型模式.字符串,0 等!如何用实际示例替换它,以便我可以“尝试一下".这对我的 API 消费者更有用. 解决方案 不确定你是否找到了这个问题的答案,但我还是会回答这个问题. @ApiModelProperty ..
发布时间:2021-09-01 20:22:18 其他开发

Swagger-ui 不会从示例正文中隐藏只读嵌套对象

我正在使用 swagger-ui 和 lombok 开发 spring-boot 应用程序.目前我正在尝试从请求正文中隐藏嵌套对象,但它仍然显示在 swagger-ui 页面上的示例 json 中. 我的课程带有注释(简化为仅相关内容): @Data@ApiModel(description = "角色模型")公共类字符{@ApiModelProperty(readOnly = true) ..
发布时间:2021-09-01 20:22:01 Java开发

Swagger/Swashbuckle 列出可接受的值?

我已经在我的 Web API 应用程序上成功实现了 Swashbuckle/Swagger,但对输出并不满意. 我的一个 web api 方法(企业事件日志记录工具)接受复杂对象值的 JSON 对象. 问题在于,当存在可以使用的可接受值的选定列表时,参数会作为字符串对象列出.我已经设置了默认值,以便如果发送不正确的内容,我将设置为默认值. 我想我可以添加其他返回可接受值的服务调用 ..
发布时间:2021-09-01 20:21:55 其他开发

作为参数传递的 swagger 对象可以在 swagger-ui 中具有默认值吗?

我定义了一个以 MyObject 作为参数的路径.MyObject 具有猫和狗的属性.这些有默认值.在 swagger-editor 中,该示例未显示默认值,但试用确实创建了一个具有正确默认值的 MyObject. 在 swagger-ui 中,我可以在 Models 下看到默认值,但在 API 中看不到.有没有办法设置这些默认值?招摇:'2.0'信息:标题:将具有默认属性的对象作为参数传递 ..
发布时间:2021-09-01 20:21:43 其他开发

swagger ui 中的隐藏字段

我使用的是 swagger UI 2.0.23 版本,我使用 json 文件提供 api.我需要使用 swagger ui 向我的 api 发送一个特定的标头值,但该字段在 ui 中不应该可见.因为值不应该被改变.因此,如何隐藏该字段以使其不显示在 ui 中.我试过以下示例但没有用 {"name": "access_type","数据类型": "字符串",“枚举":[“高的"],“必需":“真 ..
发布时间:2021-09-01 20:21:38 其他开发