是否可以在openapi3.0/swagger中将内联图像渲染为描述文本等的一部分？在查看规范时，我所能找到的就是能够链接到请求示例中的图像，特别是。我想要的是能够在我的API的介绍性文本中包括图表等，类似于markdown等。API"
description: "This API bla bl
浏览 25提问于2019-08-29得票数 3
4回答
我正在使用的构建一个微型服务。我可以很容易地在eg上公开这个傲慢的API描述JSON。/swagger.json与 renderer = OpenApi3(ApiInfo("GoOut LocationsAPI", "1.0"), Jackson)
descriptionPath = "/swa
浏览 16提问于2020-05-11得票数 4
回答已采纳
我将我的应用编程接口定义为OpenAPI3文档，并且我使用swagger UI作为查看器。所有的“描述”字段现在都是英文的。但我需要支持几种语言的API文档(例如英语和俄语)。如何将OpenAPI3文档本地化为多种语言？有没有一些标准的机制来解决这个问题，或者唯一可能的方法就是为这个问题编写我自己的自定义解决方案？
浏览 12提问于2018-02-04得票数 4
只有HTTPS服务器被发布到客户端以供使用(我的意思是，我的应用程序可以通过REST访问，然后在gRPC端点上拨号)，并且我使用Swagger OpenAPI3 (这里的主要要求是第3版)发布它。由于我绝对需要编写proto文件来生成gRPC服务器，所以我想要自动生成swagger规范(OpenAPI3)。但是我的需求是OpenAPI3；更具体地说，我想在OpenAPI3中使用oneOf特性，并从p
浏览 4提问于2020-04-21得票数 11
2回答
我正在尝试使用Swagger动态记录我的SpringBoot应用程序的REST API。这是我的设置：<?>springfox-swagger2</artifactId>
<version>2
浏览 2提问于2017-09-04得票数 3
正如标题所暗示的，有没有一种方法可以更改类型的swagger url放入url中。localhost:8080/docs
我使用OpenApi3，到目前为止，在文档中我不知道如何更改"swagger-ui“。感谢任何可能的答案
浏览 42提问于2020-11-13得票数 2
回答已采纳
1回答
我正在使用open 3，并希望在swagger中隐藏一些端点。在swagger2中，我发现通过创建自己的注释可以这样做，但我不知道如何在openapi3中这样做。@Bean return new Docket(DocumentationType.SWAGGER_2)
.groupName
浏览 5提问于2021-10-13得票数 4
1回答
亚马逊网络服务模式注册表(亚马逊网络服务EventBridge)需要OpenApi3模式文档。我有一个dotnet程序集，它的类型用于AWS Lambda函数程序集中AWS EventBridge消息的细节。
我想为这些类型生成OpenApi3文档。我已经完成了一个峰值，其中这些类型是ASP.NET应用程序的返回类型，并检查了swagger输出。这些所需的类型出现在swagger输出中。但是，这些类型既不存在于ASP.NET应用程序<
浏览 0提问于2020-06-04得票数 0
迁移到openApi3 SpringBoot项目。但是，当/v3/api/ url工作时，我无法获得很好的ui页面。但虚张声势的网址显示404没有找到。我还可以访问/v3/api/swagger-config/。
我使用的是springdoc ui依赖项，其版本为1.6.11。我试过所有可能的方法。FYI，我实现了SwaggerConfig.java和ConfigWebSecurity.java，因为忽略了spring
浏览 11提问于2022-11-08得票数 0
2回答
我也在使用drf-yasg来为我的服务生成高傲的方案。
不幸的是，drf还不支持OpenApi3，看起来在可预见的将来也不会支持。
浏览 3提问于2020-01-30得票数 4
回答已采纳
将springdoc依赖项添加到我的Spring项目(而不是springdoc)之后，将生成OpenAPI V3文档，并可以使用默认的swagger页面：localhost:8080/swagger-ui.html因为springdoc文档取代了以前的Swagger文档，所以我希望在相同的URL localhost:8080/docs/index.html中提供它。如何配置我的项目也可以使swagger-
浏览 3提问于2021-07-21得票数 2
在我的春季引导应用程序中，在应用程序启动时，我正在生成多个json格式的swagger文档，并存储在位置-静态/标记文件。swaggerdoc/openapi.jsonspringdoc.swagger-ui.ur
浏览 6提问于2022-01-26得票数 1
回答已采纳
我有一个有更大描述的字段。laboris nisi ut aliquip ex ea commodo consequat")private String myField;
在swagger页面中，描述是内联的。
浏览 0提问于2021-03-30得票数 0
回答已采纳
1回答
我试图将Swagger2更改为OpenApi3，第一件事是将注释@ApiModel和@ApiModelProperty更改为@Schema。我使用'swagger-message.properties‘文件，因为我需要将我的西里尔符号保存在那里。return translator.getMessage(message, null, message, Locale.getDefault());}
这是我想要在SwaggerUI中显示的类description = &
浏览 2提问于2021-05-21得票数 0
回答已采纳
2回答
我有一个使用spring数据rest的spring引导应用程序。在使用swagger提供良好阅读的API文档时，我遇到了问题。我试过春狐和春天，但每个都有它的问题。春狐：
没有对预测的<
浏览 2提问于2020-07-17得票数 0
我尝试了孔晨spring plugin，它能够生成YAML文件，但使用Swagger2.0定义，而不是打开API3.0，如下所示：info: contact: url: "http://www.swagger.io/support"
email: "support@swagger<
浏览 0提问于2019-02-28得票数 26
回答已采纳
我正在使用Swagger1.2，并且很难对JSON嵌套对象建模，我希望模型模式能够像Swagger演示宠物商店POST/(示例值)一样显示。例如，我的对象是： "parent" : { "child_2a" : "string",
"child_2b"在我的parameter数组中，我有这样的</em
浏览 1提问于2016-03-31得票数 0
回答已采纳
我有一个项目(Spring + Kotlin)，我希望有一个OpenAPI3.0规范(最好是在YAML中)。Springfox库不错，但它们生成Swagger2.0JSON。从控制器中的注释生成OpenApi3.0规范的最佳方法是什么？白手起家是唯一的办法吗？
浏览 1提问于2019-05-01得票数 26
回答已采纳
我有这样的东西： Having a always helps找到div元素没有问题，当我调用getText()时，我希望收到“拥有Meow总是有帮助”，但是我得到的文本没有alt (Meow)描述。我同意这是预期的行为，但这不是我所需要的。
我怎样才能更好地内联
浏览 0提问于2014-01-12得票数 2
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
腾讯会议
云直播活动推荐
腾讯云开发者
