我需要在OpenAPI中用数组定义一个JSON响应。数组总是包含两个项，第一个项总是一个数字，第二个项总是一个字符串。//valid[1] //invalid我发现JSON模式通过在items中而不是在单个对象()中传递项列表来支持这一点，但是OpenAPI明确禁
浏览 0提问于2019-08-12得票数 6
回答已采纳
在Swagger和OpenAPI规范中，我看到了在查询参数中定义数组的多种方法。下面所有的例子都是有效的吗？是否有更有效的选择？
浏览 2提问于2021-08-12得票数 1
回答已采纳
2回答
在有关参数序列化的OpenAPI文档中，有一个关于如何序列化具有不同样式的查询、路径、头和cookie参数的简短章节。这些参数的模式被描述为OpenAPI风格的json模式，它允许无限嵌套对象和数组。关于如何在文档中处理这些问题，我还没有发现任何提及：
{ "properties": {
"foo"type": &
浏览 10提问于2021-05-28得票数 2
回答已采纳
3回答
我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。
有没有办法告诉Swagger，param是A类型的值列表，还是A类型的单个值？
浏览 1提问于2015-07-31得票数 15
回答已采纳
我正在为params字段编写OpenAPI定义，它是一个对象，包含一个名为name的字段，默认情况下它是字符串类型，但可以是任何类型，例如整数、数字、布尔值、字符串或字符串数组、布尔值、数字、整数。参数：{ name: string: int | string | number | boolean | int[] | string[] | number[] | boolean[] }
如何在OpenAPI中定义这样的字段？
浏览 231提问于2019-05-17得票数 1
回答已采纳
1回答
我正在将我的应用编程接口从Swagger2.0迁移到OpenAPI 3.0。在DTO中，我有一个指定为字节数组的字段。: binary 使用上面的定义，swagger代码生成器生成一个接受byte[]数组作为主体字段new Job().setBody(new byte[1])的对象。在将API定义转换为OpenAPI之后，该对象的定义保持不变，但是openapi代码生成器现在需要org.springframework
浏览 62提问于2020-07-08得票数 10
回答已采纳
我创建了一个返回数组的项目。导入此swagger.json后，查看swagger.json一切正常。但是，当我从开发人员门户下载API定义时，我看到一些对象，如...Array、...数组-1、...数组-2。我没想到会这样： ? 我如何防止这种情况发生？如何才能确保生成的对象与正常对象的行为相同(所以没有虚线，而是点)。：https://blog.tomkerkhove.be/2018/04/
浏览 14提问于2019-09-05得票数 0
回答已采纳
我正在为一个API编写一个swagger定义文件。
浏览 0提问于2016-07-24得票数 12
回答已采纳
73.70 [ 949576, 265836, ]它是一个列表、列表、数组或数组如何为此响应创建OpenAPI架构？
浏览 5提问于2022-08-10得票数 1
我的方法返回一个Response类型的对象。响应本身包含一个MyClass列表。其实现如下所示：import org.eclipse.microprofile.openapi.annotations.media.Contentcontent: schema:
浏览 5提问于2019-03-04得票数 2
我试图为OpenAPI cookie参数实现符合规范的参数序列化。在描述中我看到了这行
这是什么意思？
是否定义了使用explode = true的cookie序列化？如果是的话，请您链接文档好吗？如果不是，我是否正确地说，explode = true基本上“禁用”数组和对象序列化，而对原始
浏览 5提问于2022-09-13得票数 1
回答已采纳
我正在开发一个应用程序，它使用库为其Spring控制器生成OpenAPI v3端点。这个库使用来实际将OpenAPI对象映射到OpenAPI模式。定义的任何OpenAPI：string、number、integer、boolean、array或object。没有类型的架构与任何数据类型匹配--数字、字符串、对象等等。因此，一种正确的建模方法是以下Swagger定义，其中没有type属性用于value "openapi
浏览 1提问于2021-09-20得票数 1
我试图在数组中添加一个对象，但这似乎是不可能的。我尝试了以下几种方法，但我总是会遇到错误：
这将显示在devices数组中定义的所有项。如何在OpenAPI中定义数组中的项？
浏览 8提问于2020-09-04得票数 17
回答已采纳
我需要定义一个API，请求需要看起来像这样的json： "acountNumber": "1234564545444854", {
"warningCode
浏览 6提问于2020-03-02得票数 1
回答已采纳
2回答
我想要一个读取值的路径和一个存储任何非预定义深度的JSON值(null、number、integer、string、object、array)的路径。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。因此，我尝试通过定义一个MixedValue模式来解决这个问题：swagger: '2.0' version: 0.0.1co
浏览 2提问于2015-09-29得票数 9
回答已采纳
1回答
必须是，数组，布尔，数字”错误。
、、、、
必须是，数组、布尔值、整数、数字、对象或字符串。”
在将行"type": "file"转换为"type": "object"时，错误是固定的，但我不确定这种情况是否有合适的方法。
浏览 0提问于2021-07-09得票数 1
回答已采纳
filter[id]=1&filter[name]=bob&order[][name]=asc&order[][age]=desc
如何将其转换为swagger文档，具体地说，就是对象数组和作为查询参数的数组
浏览 5提问于2017-09-02得票数 3
了解REST并跟踪。API将返回firstname、lastname和username，但使用required关键字只需要username。这对我来说毫无意义。缺少required关键字是否表明有时可能不需要其他两个关键字？到底是什么影响着他们，不管他们是不是？ /persons/{username}: summary: Gets a person
description: Returns a single
浏览 5提问于2016-09-19得票数 7
回答已采纳
"tester2": "Company" }
test1中的对象具有随机guids，列出的方式通常是数组，但不是。测试1中可能有无限多的对象，有人知道如何设置吗？
浏览 7提问于2021-07-20得票数 1
回答已采纳
我正在使用API2.0在SwaggerHub中定义一个OpenAPI规范。/contacts请求返回一个联系人数组。定义如下： get: - contacts lastName: example: 'someValue1
浏览 3提问于2017-09-12得票数 18
回答已采纳
云服务器
ICP备案
云直播
即时通信 IM
实时音视频
腾讯云开发者
