1回答
我正在尝试为我的express api从swagger 2.0迁移到openapi 3.0.2。swagger定义和路径是用swagger-jsdoc编写的。这应该不会造成任何问题，因为他们的文档指出，它可以与openapi 3.x以及swagger 2.0一起工作。将openapi: 3.0.x添加到我的swaggerDefinition中时，视图看起来很好。但是，当尝试通过swagger视图执行post请求时，主体是空</
浏览 23提问于2019-10-31得票数 2
回答已采纳
如何将下面转换为Swagger/OpenAPI YAML？
浏览 8提问于2022-03-30得票数 0
我试图将以下JSON映射到OpenAPI 2.0 (Swagger2.0) YAML定义，并且我不知道如何将混合数组类型设置到我的模式中： "obj1": [ 1}schema: type: array type: string
但这不允许数组中的整数
浏览 2提问于2016-08-01得票数 14
回答已采纳
我正在开发一个API，允许使用URL进行搜索，如下所示： GET https://example.com/api/data?search[field1]=value1GET https://example.com/api/data?search[field1]=value1&search[field2]=value2 基本上，您可以通过将字段名放在括号中来搜索一个或多个字段值。问题是，字段名称由用户在其设置中定义。字段名称将是一个字符串，否则在全局级别上是未知的。 This
浏览 49提问于2019-05-23得票数 1
回答已采纳
他们为我提供了一个swagger-ui端点。我用Java编写代码。我正在使用SpringFramework。我正在寻找能够生成我可以实现的存根和模式类的东西。
浏览 3提问于2021-09-23得票数 1
我的应用程序为所有API端点生成一个JSON/YAML。但是，我有一个API网关，其中我只允许其中的一个子集。为此，我目前手动从第一个文档以及它的模型中选择API，并创建一个可以提供给API网关的新文档。有什么方法可以使这个过程自动化，这样我所选择的路径就可以通过它的模型提取到一个新的Open文档中。
浏览 21提问于2022-07-24得票数 0
回答已采纳
swagger: "2.0" description: Initial draft of the API specification title:
浏览 3提问于2017-08-07得票数 56
回答已采纳
我们一直在使用OpenAPI 3.0.x规范，它增加了声明nullable属性的特性。openapi: "3.0.2" title: Test API
version:
浏览 11提问于2022-03-28得票数 3
回答已采纳
1回答
我正在使用在线为我的API创建一个Swagger规范。example: New York
如何在用Swagger
浏览 1提问于2017-05-12得票数 21
回答已采纳
我试图使用swagger描述来验证REST的一些数据。我使用swagger编辑器转换选项将swagger.json转换为OpenAPI 3.0.1，现在使用以下代码行尝试使用ObjectMapper将其读取到OpenAPI对象中：);首先，我得到了一个错误，因为它无法识别由转换器生成的字段x码元请求体名.好吧，这对我来说并不重要，所以我删除了这个字段。但是，我得到了以下错误：
未识别字段“io.swagger.v3.oas.mode
浏览 4提问于2020-10-17得票数 0
回答已采纳
1回答
无法在swagger UI中获取示例字段值。@ApiOperation(value = "Sample API to test swagger doc", response = SampleResponse.class)pom.xml <groupId>io.springfox</groupId>
<artifactId>springfox-swagg
浏览 6提问于2020-06-16得票数 0
回答已采纳
我在Swagger /Swagger编辑器上创建了rest端点文档。我有基于python-sanic的restful端点。我正在生成和运行python服务器，但是我收到了错误消息。Uncaught :swagger2.0不支持空类型(对象对象)。
我已经调查过这个问题，但没有找到解决的结果。
浏览 0提问于2018-08-15得票数 0
回答已采纳
我们在swagger中有if吗？openapi: 3.0.0 - url: 'http://petstore.swagger.io/v2' - url: 'http://petstore.swagger.io/mermade/swagger2openapi'info:
descripti
浏览 1提问于2017-08-30得票数 1
1回答
/** * /routes: * description: Create a route * - Routes但是，这些值不会出现在swagger文档文件中，如下所示：
浏览 2提问于2019-06-04得票数 1
回答已采纳
我想知道是否可以在Swagger中创建一个url-form编码的post请求？en-US,en;q=0.8,fa;q=0.6,sv;q=0.4Connection: keep-aliveUser-Agent: Mozilla/5.0 client_id:
浏览 1提问于2016-05-25得票数 4
我有一个JSON schema文件，其中一个属性被定义为string或null当转换为YAML (用于OpenAPI/Swagger)时，它将变为：type: - string架构的“类型”键必须是字符串
在OpenAPI中定义可为空的属性的正确方法是什么？
浏览 294提问于2018-01-05得票数 85
回答已采纳
1回答
我有以下openapi 3.0兼容的yaml文件，我试图通过swagger呈现。yaml文件中没有报告错误，但是requestBody没有在swagger上呈现。我只得到一个parameters字段，它是空的，但是没有为请求体呈现，也没有得到任何错误。下面的截图。
浏览 3提问于2018-10-31得票数 4
回答已采纳
无法生成包含多部分/表单数据内容类型的swagger文件我有一个上传文件的请求，在那里我发送多部分/表单数据的文件。我试图将表单数据描述为这就是我在邮递员中的要求。
@swagger_auto_schema(
operation_id='Cr
浏览 8提问于2022-01-25得票数 0
对于带有表单数据的POST请求，我有以下OpenAPI (Swagger)定义。如何根据type参数的值更改所需的表单参数？
浏览 5提问于2021-12-15得票数 2
回答已采纳
云服务器
ICP备案
云点播
对象存储
即时通信 IM
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号