回答情况：
提问时间：
问题标签：
在OpenAPI 3.0中，我想知道时的区别是什么。例如，下面描述"Foo“和"Bar”的区别是什么？如果有意义的话，用于"Foo“的”Foo“更多用于参数的语义，而用于"Bar”的更多用于语法吗？
浏览 3修改于2021-09-17得票数 1
回答已采纳
我正在开发一个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
回答已采纳
在生成的OpenAPI文档中，springdoc-openapi库自动将某些属性标记为required。例如，注释为@NotNull的属性将包含在所生成的YAML文件中的必需属性列表中。这意味着OpenAPI文档和端点的行为之间存在差异。 手动将任何单个属性标记为可为空很简单:只需将@Schema(nullable = true)添加到字段或访问器即可。如何在由springdoc-openapi生成的OpenAPI文档中将我的可选属性标记为nullable: true？String getValue()
浏览 146提问于2021-09-24得票数 2
我试图为OpenAPI cookie参数实现符合规范的参数序列化。在描述中我看到了这行
一个可选的爆炸性关键字控制数组和对象序列化。我希望OpenAPI专家能对此有所了解，谢谢！
浏览 5提问于2022-09-13得票数 1
回答已采纳
假设我有一些简单的Order > OrderLines > Product在OpenAPI文档中。schema: required: true那么，是否可以在参数定义中实际引用这些属性，而不是复制属性的类型信息？
我是说，做这样的事有可能吗？
浏览 1提问于2019-01-28得票数 1
回答已采纳
我想用OpenAPI 2.0 (Swagger2.0)描述这个端点。
端点具有路径和formData参数。
浏览 2修改于2020-03-17得票数 9
回答已采纳
但是name和age是任意参数。对于另一个资源，如Organization，任意参数可以是foundIn。在openapi规范中，我有 api/employees : parameters: name: limitrequired: false type: integer 我使用codegen插件openapi-generator-maven-plugin，在
浏览 27提问于2020-10-08得票数 1
我有一个OpenAPI 3.x响应体： $ref: '#/components/requestBodies/ordernumber'
描述性文本适用于我所使用的每个实例，但最后一行除外
浏览 0提问于2021-02-18得票数 1
回答已采纳
我想知道是否可以在两个查询参数之间添加OpenAPI 3.0.1文件的RequestBody。我在文档中找不到任何关于这方面的东西。
浏览 136提问于2020-11-02得票数 0
回答已采纳
在有关参数序列化的OpenAPI文档中，有一个关于如何序列化具有不同样式的查询、路径、头和cookie参数的简短章节。这些参数的模式被描述为OpenAPI风格的json模式，它允许无限嵌套对象和数组。array", "type": "string" }它允许这样的结构(至少在JSON中)：我的问题：
浏览 10修改于2021-05-28得票数 2
回答已采纳
NestJS OpenAPI/Swagger实现是否支持公共参数的重用？ 这将使我不必在端点上使用相同的@ApiImplicitQuery装饰器。
浏览 25修改于2019-05-02得票数 0
回答已采纳
我试图找出如何在OpenAPI中记录我的两个查询参数。我的筛选遵循的建议，其形式如下：
sort查询参数被指定为一个排序字段或逗号分隔的排序字段列表的值。请注意，height字段前缀的减号指示降序排序。
浏览 2提问于2020-09-12得票数 19
我有一个HTTP302(重定向)，它实现了一个新的状态参数，它将附加到RedirectURL中，因此可以显示如下所示的消息GET http://localhost:8080/infostatus=error
但是如何在OpenAPI规范中描述这一点呢？我似乎无法在响应中使用parameters，并且找到了一些使用responseParameters的代码，但是我没有运气让它工作。
浏览 1修改于2020-09-08得票数 10
在OpenAPI v3中定义接口时，如果多个接口路径使用相同的查询参数列表，有没有办法一次定义它们并在每个路径中引用它们？想象一下一个常见的场景，我有5个不同的API用于搜索，但它们都共享相同的查询参数，如“限制、书签、页面、排序”等。对可能的重复项的响应
我问的不是一次引用一个特定的参数，而是在几个API路径中重用一组参数。因此，我不认为它是的复制品)
浏览 2修改于2020-07-29得票数 3
我知道OpenAPI (Swagger)允许路径中的参数，如下所示： /id/{number}/status:host: my.api.com /status:
浏览 2修改于2018-03-15得票数 8
我有应该发送给所有API的报头，但不知道是否可以为整个API全局定义参数？这些头文件有些是静态的，有些是在调用API时设置的，但它们在所有API中都是一样的，我不想为每个API和每个方法复制和粘贴参数，因为这在将来将无法维护。
浏览 1修改于2020-07-28得票数 28
回答已采纳
我有一个OpenApi规范： /lessons: tags: operationId: getLessons
浏览 0提问于2019-08-23得票数 1
回答已采纳
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号