如何在OpenAPI (Swagger)中定义一个接受任意对象数组的参数？
在OpenAPI（Swagger）中定义一个接受任意对象数组的参数，可以使用type: array和items关键字来实现。下面是一个示例：
parameters:
- in: body
name: data
description: 要传递的对象数组
required: true
schema:
type: array
items:
type: object在上面的示例中，我们使用parameters关键字定义了一个参数，它的位置是body，名称是data，描述了要传递的对象数组。required属性指示该参数是否是必需的。
在schema中，我们使用type: array来指定参数的类型为数组，然后使用items关键字来定义数组中元素的类型。在这个示例中，我们将元素类型定义为object，表示可以接受任意对象类型的数组。
这样定义的参数可以用于描述接口的请求参数或响应参数。在实际使用中，可以根据具体需求进一步定义对象的属性和类型。
推荐的腾讯云相关产品：腾讯云API网关（API Gateway），它是一种全托管的API管理服务，可以帮助开发者更轻松地构建、发布、运行和维护API。您可以通过以下链接了解更多信息：
腾讯云API网关产品介绍：https://cloud.tencent.com/product/apigateway
相关·内容
1回答
如何使用Swagger (Springdoc)生成OpenAPI任意类型？
java、spring-mvc、openapi、springdoc、swagger-core
我正在开发一个应用程序，它使用库为其Spring控制器生成OpenAPI v3端点。这个库使用来实际将OpenAPI对象映射到OpenAPI模式。因此，一种正确的建模方法是以下Swagger定义，其中没有type属性用于value "openapi": "3.0.1", "title": "Open
浏览 1提问于2021-09-20得票数 1
1回答
如何在OpenAPI (Swagger)中定义一个接受任意对象数组的参数？
swagger、swagger-2.0、openapi
在我的OpenAPI规范中，是否可以将参数定义为对象，而不必定义其属性(匿名对象)？更具体地说，我希望我的API能够接受这些匿名对象的数组。这就是我所拥有的，但是我在Swagger编辑器中得到了一个“无效的参数定义”错误。swagger:
浏览 4提问于2018-02-16得票数 0
回答已采纳
2回答
OpenAPI:接受任何(复杂)JSON值的模式
json、api、swagger-2.0、openapi
我想要一个读取值的路径和一个存储任何非预定义深度的JSON值(null、number、integer、string、object、array)的路径。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。因此，我尝试通过定义一个MixedValu
浏览 2提问于2015-09-29得票数 9
回答已采纳
3回答
告诉Swagger请求体可以是单个对象或对象列表
scala、rest、swagger、openapi
我使用Swagger和Scala来记录我的REST。我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。有没有办法告诉Swagger，param是A类型的值列表，还是A类型的单个值？
像瓦拉格这样的人休息。
浏览 1提问于2015-07-31得票数 15
回答已采纳
1回答
如何在OpenAPI 3.0中定义字节数组
java、spring、openapi、openapi-generator
我正在将我的应用编程接口从Swagger2.0迁移到OpenAPI 3.0。在DTO中，我有一个指定为字节数组的字段。DTO的Swagger定义： Job: properties: type: string
format: binary 使用上面的定义，swagger代码生成器生成<
浏览 62提问于2020-07-08得票数 10
回答已采纳
1回答
Swagger/OpenAPI:在查询参数中定义数组的有效方法是什么？
swagger、openapi
在Swagger和OpenAPI规范中，我看到了在查询参数中定义数组的多种方法。下面所有的例子都是有效的吗？是否有更有效的选择？
浏览 2提问于2021-08-12得票数 1
回答已采纳
3回答
在Swagger中，如何定义使用文件和模式参数的API？
swagger、swagger-2.0、openapi
我试图使用Swagger来定义接受实际文件的API和描述文件内容的模式对象。这是“摇摆YAML”的一个片段。但是，它不会在Swagger中验证。in: formData required: trueSwagger编辑器引发以下验证错误：
傲慢错误:数据与“one
浏览 6提问于2015-09-22得票数 7
2回答
Django Rest Framework自定义POST URL端点，带有定义参数(request.POST)，包含Swagger或其他文档
django、rest、django-rest-framework、swagger、redoc
在Django 1.11中，我定义了Django REST：url(r'^api/test_token$', api.test_token, name='test_token'),在上述特殊情况下，接受一个参数的是POST API "test_token“。值得注意的是，它使用request.POST (表单数据)作为参数。在Django 1.11.x<e
浏览 29提问于2021-01-27得票数 12
回答已采纳
1回答
Swagger:如果未通知所需参数，如何禁用"Execute“按钮
swagger、swagger-ui
我正在使用创建一个非常简单的节点API的文档。这更像是一个"UI/UX“问题，但却困扰着我。
我有需要路径参数的路由(例如，客户端id )，我已经记录了这种方式。因此，Swagger上的参数将按需要进行标记。但是，用户可以单击“执行”按钮，而无需填写所需的参数。如果页面返回一个错误并让用户填充所需的参数并再次尝试，这将不是<e
浏览 4提问于2022-07-22得票数 1
回答已采纳
1回答
是否可以创建不同的主体，并在操作过程中选择我想要的主体？
swagger、swagger-ui、swagger-2.0、swagger-editor
例如，在body part.Can中，我做了一些事情，让我在structure1和structure之间做出选择，就像在enum.Here中一样，这也是我的结构和结构。我们有像选择器这样的东西吗，或者每次我都应该为每个结构创建新的POST或PUT ?可能还有其他方法来处理if ?我们在swagger中有if吗？openapi: 3.0.0 - url: 'http://petstore.swagger.io/
浏览 1提问于2017-08-30得票数 1
1回答
邮递员：“无效的数据类型。必须是，数组，布尔，数字”错误。
swagger、postman、openapi、postman-collection-runner、postman-pre-request-script
在Postman中创建API时，我得到以下错误：“无效数据类型。必须是，数组、布尔值、整数、数字、对象或字符串。”在将行"type": "file"转换为"type": "object"时，错误是固定的，但我不确定这种情况是否有合适的方法。因为使用此更新，在Postman中发送请求时可能不会传递请求。array", "
浏览 0提问于2021-07-09得票数 1
回答已采纳
1回答
在Swagger2.0中，查询参数数组中的数字索引可以表示吗？
swagger、swagger-ui、openapi、swagger-2.0
我理解如何用Swagger2.0表示查询参数中的数组：是否可以使用索引样式在Swagger2.0中表示数组？
?list[0]=x&list[1]=y
浏览 1提问于2022-06-16得票数 1
1回答
Azure API-management中单个阵列的多个阵列定义
arrays、azure、asp.net-core、swagger、azure-api-management
我创建了一个返回数组的项目。导入此swagger.json后，查看swagger.json一切正常。但是，当我从开发人员门户下载API定义时，我看到一些对象，如...Array、...数组-1、...数组-2。我没想到会这样： ? 我如何防止这种情况发生？如何才能确保生成的对象与正常对象的行为相同(所以没有虚线，而是点)。我创建了
浏览 14提问于2019-09-05得票数 0
回答已采纳
1回答
如何在数组中定义枚举值，还是在map属性中将枚举定义为键？
rest、api、yaml、swagger-2.0、swagger-codegen
我使用swagger-codegen-maven-plugin (2.2.1)从YML配置生成java和类型记录代码类文件。我有两个问题。让我知道这是可能的，还是有什么解决办法？目前，我在java和typescrtipt中定义了enum类，并将其作为字符串传递。谢谢。type: object
浏览 5提问于2017-10-09得票数 5
回答已采纳
1回答
如何在OpenAPI 2.0中定义混合类型数组(具有不同的元素类型)？
swagger、openapi、swagger-2.0
我试图将以下JSON映射到OpenAPI 2.0 (Swagger2.0) YAML定义，并且我不知道如何将混合数组类型设置到我的模式中： "obj1": [ 1}schema: type: array type: strin
浏览 2提问于2016-08-01得票数 14
回答已采纳
2回答
Swagger2.0支持矩阵参数吗？
swagger、swagger-2.0、swagger-editor
Swagger2.0支持JAX规范的矩阵参数吗？我的应用程序中有一些矩阵参数，如/map/color;lat=50;long=20;scale=32000。我想导出矩阵参数的Swagger。我使用，但在编辑器中得不到任何帮助。有谁可以帮我？与矩阵param有关的其他链接：
浏览 0提问于2016-03-11得票数 5
回答已采纳
1回答
@ApiProperty openapi_context类型数组示例
php、annotations、openapi、api-platform.com
是否可以为@ApiProperty创建openapi_context "type"="array“？使用注释编写sucha数组的“示例”值的正确方法是什么？我正在使用OAS3 * @ApiProperty( * "openapi_context"={
浏览 8提问于2020-04-23得票数 4
1回答
带括号和变量名的OpenAPI参数
openapi、swagger-editor
我正在开发一个API，允许使用URL进行搜索，如下所示： GET https://example.com/api/data?search[field1]=value1&search[field2]=value2 基本上，您可以通过将字段名放在括号中来搜索一个或多个字段值。问题是，字段名称由用户在其设置中定义。字段名称将是一个字符串，否则在全局级别上是未知的。 This answer几乎就是我要做的，我只是
浏览 49提问于2019-05-23得票数 1
回答已采纳
2回答
Swagger 2:在数组类型的查询参数中使用枚举引用
swagger、swagger-ui、swagger-2.0
无法获得如何在数组参数中使用带枚举值的字符串类型引用。我可以在条目键中引用并且它正在工作，但是Swagger会产生错误:不是一个有效的参数定义正确的方法是什么？我的代码： paths:
/tes
浏览 5提问于2017-01-13得票数 1
回答已采纳
1回答
OpenAPI -获取任意查询参数
java、swagger、openapi、openapi-generator
我有一个这样的端点： api/employees?limit=2&name=Palani&age=20 在这里，limit是发布给用户的关键字。但是name和age是任意参数。对于另一个资源，如Organization，任意参数可以是foundIn。在openapi规范中，我有 api/employees : parameter
浏览 27提问于2020-10-08得票数 1
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
即时通信 IM
ICP备案
云直播
实时音视频活动推荐
腾讯云开发者
