有了一个很大的Swagger/OpenAPI YAML规范，我如何安全地提取某些API端点并专门为它们生成新的.yaml？很容易从某个级别识别API端点(比如使用一个或多个缩进定义)： /users:
...我只需要将除paths之外的所有部分复制到一个新的specs文件中。然后，我会根据缩进复制特定的paths小节，比如/users:。在Python中，使用正
浏览 3提问于2017-12-01得票数 2
我试图在构建过程中生成openapi/swagger规范文件。Maven插件工作，但它非常老，不再维护，并创建了非常老版本的swagger规范文件，不再兼容新的版本。请注意，openapi生成器-maven-plugin可以从spec文件创建java客户端端点，但我正试图做相反的工作。
浏览 20提问于2022-03-25得票数 1
回答已采纳
有大量关于Spring Boot、JAX-RS和Swagger的教程。然而，它们中的大多数似乎都使用了OpenAPI 2规范。我只找到一个使用Spring、JAX-RS和OpenAPI 3.0的教程(该教程使用Apache CXF)。是否有其他Spring Boot + JAX-RS实现可以与OpenAPI 3.0一起使用？例如，使用Jersey的所有教程似乎仅输出OpenAPI 2.0。Springdoc-openapi支持spring boot和OpenAPI 3.
浏览 13提问于2019-08-20得票数 2
我所看到的一切都是通过HTTP路径基于API的，所以我现在想知道用OpenAPI / Swagger规范实现这个功能吗？
浏览 2提问于2017-09-15得票数 16
回答已采纳
因此，我希望在不降低swagger库版本的情况下生成swagger 2.0YAML文件(api端点已经使用swagger 4.x - openapi 3.0规范进行了描述)。"@nestjs/swagger": "^4.5.4",
...和swagger生
浏览 42提问于2020-06-19得票数 2
回答已采纳
5回答
我已经在下面创建了一个带有yaml文件的Swagger文档：现在我想分享一个静态的超文本标记语言文档及其定义，但在上声明，他们根本不打算支持超文本标记语言的生成如何从Swagger项目生成静态HTML文件？
浏览 4提问于2016-11-04得票数 22
1回答
我已经在我的java(spring mvc).I中添加了一个目录配置，想要在我的swagger ui端点php/中添加。我认为一个好的方法是在php中创建yaml ->创建它的json，然后将这些文件放到java中。resources.Then如何在我的java .In中使用它我的配置是，包含在外部路径中的每个控制器都将被包括在内，但现在我想使用外部的所有控制器，并使用它的json文件调用php (通过使用它的json文件)，你有什么想法吗？
浏览 2提问于2020-04-06得票数 0
使用open的好处，我正在使用Micronaut 依赖项生成Swagger，如下所示Micronuat在构建目录中生成swagger规范YAML文件，如下所示现在，我希望使用swagger规范文件来生成角应用程序的类型记录文件。创建类型记录文件的最佳方法是什么，以及如何在前端应用程序中使用它们？
或是否有一种方法可以使用Micronaut?将文件公开给swagger<
浏览 9提问于2022-08-10得票数 0
我可以从OpenAPI中自定义。我用一个@RestController创建了一个简单的springboot项目。我创建openapi.yaml并将其复制到/src/main/resources/。
但我在打开的swagger页面上看到了默认值。
浏览 17提问于2020-05-29得票数 4
回答已采纳
我在上跟踪openapi的micronaut，并且UI没有生成，每次我试图访问/swagger时，/swagger-ui都会出现以下错误： "message": "Not Found", enabled: true mapping: /swagger/**
浏览 7提问于2022-10-21得票数 2
回答已采纳
我们根据java代码中的注解生成swagger/openAPI文档。代码中有一些仅供我们内部使用的端点。这些都是我们不希望被访问甚至公开可见的端点。我猜我们可以对swagger文件进行后期处理并删除这些端点，但这会在构建过程中增加另一个步骤。真正好的是，如果能以这样一种方式标记它们，使google cloud端点负载均衡器看到该标记，它将忽略该端点。这样的事情有可能吗？我想我们可以这样做，
浏览 1提问于2019-11-05得票数 1
我使用Open代码生成器Maven插件从文件中生成OpenAPI3.0。>这个插件生成API时没有任何问题，但是它没有使用Swagger v3注释，而是使用了旧的Swagger注释。例如，使用@ApiParam对参数进行注释，而应该从io.swagger.v3.oas.annotations包中使用@Parameter注释：
浏览 6提问于2020-07-15得票数 11
回答已采纳
1回答
几天前，我在JavaEE 7中启动了一个REST，我用三个方法实现了一个类，并在项目中成功地实现了Swagger和Swagger-UI，其中显示了我在生成的JSON中成功实现的三个端点。然而，我迁移到了JavaEE 8，在这个更改之后，Swagger检测到了几个未知的端点，比如“默认”端点(这个捕获只显示了其中的一部分)：我研究了一下，发现这些端点可能属于Eclipselink实现中的parameters，正如这里所描述的和，尽管它们出现在
浏览 5提问于2019-10-25得票数 4
12回答
有没有一种为swagger 2.0创建静态文档的方法？也许就像editor.swagger.io上的“预览”一样。
我需要获取静态html文件，这样我才能将它们包含在一些静态文档中。我看到有一些swagger -codegen静态文档，但这只适用于swagger <= 1.2。
浏览 7提问于2014-10-28得票数 78
swagger UI插件对手动测试和调试非常有帮助。我的问题是，有没有一种方法可以在服务堆栈中生成swagger规范？
浏览 18提问于2017-06-28得票数 1
回答已采纳
当我将该URL分解为IP:192.168.1.185端口:9100 path:/swagger-ui.html#/bd-config-controller/getUsingGET时，我将在GET请求中得到这个响应- HTML用于静态分发包构建-> Swagger UI html {box- tree :边框-box；overflow：-moz-滚动条-垂直；overflow:滚动；} *，*：前面，*：后面{box-tree
浏览 0提问于2019-11-27得票数 -1
在spring框架中，常见的模式似乎是从控制器注释生成swagger文档。我们的swagger.yaml文件正在对传入的请求运行我们的验证，所以我们希望呈现来自资源文件夹中的yaml文件的swagger文档；我们希望避免在我们的控制器中有太多的注释。
浏览 26提问于2020-01-04得票数 0
我花了几个小时研究如何在Java中使用swagger codegen生成OAS spec yaml文件，但我放弃了。我想提供Java源代码中的所有API规范数据作为代码注释。我应该使用swagger-codegen-maven-plugin，但我不能让它扫描源代码来生成OAS yaml或JSON文件。 我会感谢一个有效的codegen插件配置的pom.xml片段。也许我应该回到前面的Swagger，因为这个用例是在2.x中直接处理的。现在我对3.x的方
浏览 81提问于2019-09-11得票数 2
回答已采纳
1回答
避免显示双端点的Swagger
、、、、
我有一个yaml文件可以根据OpenAPI原则生成我的端点，但是当我打开swagger时，我会看到：openapi: 3.0.2 ....paths: 404: content: {}
而swagger配置如下
浏览 2提问于2021-05-26得票数 0
我有一个openapi.json文件(在构建时生成)，它是v3格式。我可以使用swagger-codegen-cli为swagger文档生成一个静态网站吗？目标是在构建时生成apidoc.json和html。下面的命令错误说明我没有傲慢的输入：
java -jar ./lib/swagger-codegen-cli-2.2.1.jar generate -i src/main/
浏览 3提问于2020-01-28得票数 0
回答已采纳
云服务器
ICP备案
实时音视频
对象存储
即时通信 IM
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号