我正在开发一个应用程序，它使用库为其Spring控制器生成OpenAPI v3端点。这个库使用来实际将OpenAPI对象映射到OpenAPI模式。因此，一种正确的建模方法是以下Swagger定义，其中没有type属性用于value "openapi": "3.0.1", "title": "Open
浏览 1提问于2021-09-20得票数 1
在我的OpenAPI规范中，是否可以将参数定义为对象，而不必定义其属性(匿名对象)？更具体地说，我希望我的API能够接受这些匿名对象的数组。这就是我所拥有的，但是我在Swagger编辑器中得到了一个“无效的参数定义”错误。swagger:
浏览 4提问于2018-02-16得票数 0
回答已采纳
2回答
我想要一个读取值的路径和一个存储任何非预定义深度的JSON值(null、number、integer、string、object、array)的路径。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。因此，我尝试通过定义一个MixedValu
浏览 2提问于2015-09-29得票数 9
回答已采纳
3回答
我使用Swagger和Scala来记录我的REST。我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。有没有办法告诉Swagger，param是A类型的值列表，还是A类型的单个值？
像瓦拉格这样的人休息。
浏览 1提问于2015-07-31得票数 15
回答已采纳
1回答
我正在将我的应用编程接口从Swagger2.0迁移到OpenAPI 3.0。在DTO中，我有一个指定为字节数组的字段。DTO的Swagger定义： Job: properties: type: string
format: binary 使用上面的定义，swagger代码生成器生成<
浏览 62提问于2020-07-08得票数 10
回答已采纳
在Swagger和OpenAPI规范中，我看到了在查询参数中定义数组的多种方法。下面所有的例子都是有效的吗？是否有更有效的选择？
浏览 2提问于2021-08-12得票数 1
回答已采纳
我试图使用Swagger来定义接受实际文件的API和描述文件内容的模式对象。这是“摇摆YAML”的一个片段。但是，它不会在Swagger中验证。in: formData required: trueSwagger编辑器引发以下验证错误：
傲慢错误:数据与“one
浏览 6提问于2015-09-22得票数 7
在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
回答已采纳
我正在使用创建一个非常简单的节点API的文档。这更像是一个"UI/UX“问题，但却困扰着我。
我有需要路径参数的路由(例如，客户端id )，我已经记录了这种方式。因此，Swagger上的参数将按需要进行标记。但是，用户可以单击“执行”按钮，而无需填写所需的参数。如果页面返回一个错误并让用户填充所需的参数并再次尝试，这将不是<e
浏览 4提问于2022-07-22得票数 1
回答已采纳
例如，在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
在Postman中创建API时，我得到以下错误：“无效数据类型。必须是，数组、布尔值、整数、数字、对象或字符串。”在将行"type": "file"转换为"type": "object"时，错误是固定的，但我不确定这种情况是否有合适的方法。因为使用此更新，在Postman中发送请求时可能不会传递请求。array", "
浏览 0提问于2021-07-09得票数 1
回答已采纳
我理解如何用Swagger2.0表示查询参数中的数组：是否可以使用索引样式在Swagger2.0中表示数组？
?list[0]=x&list[1]=y
浏览 1提问于2022-06-16得票数 1
我创建了一个返回数组的项目。导入此swagger.json后，查看swagger.json一切正常。但是，当我从开发人员门户下载API定义时，我看到一些对象，如...Array、...数组-1、...数组-2。我没想到会这样： ? 我如何防止这种情况发生？如何才能确保生成的对象与正常对象的行为相同(所以没有虚线，而是点)。我创建了
浏览 14提问于2019-09-05得票数 0
回答已采纳
我使用swagger-codegen-maven-plugin (2.2.1)从YML配置生成java和类型记录代码类文件。我有两个问题。让我知道这是可能的，还是有什么解决办法？目前，我在java和typescrtipt中定义了enum类，并将其作为字符串传递。谢谢。type: object
浏览 5提问于2017-10-09得票数 5
回答已采纳
我试图将以下JSON映射到OpenAPI 2.0 (Swagger2.0) YAML定义，并且我不知道如何将混合数组类型设置到我的模式中： "obj1": [ 1}schema: type: array type: strin
浏览 2提问于2016-08-01得票数 14
回答已采纳
2回答
Swagger2.0支持JAX规范的矩阵参数吗？我的应用程序中有一些矩阵参数，如/map/color;lat=50;long=20;scale=32000。我想导出矩阵参数的Swagger。我使用，但在编辑器中得不到任何帮助。有谁可以帮我？与矩阵param有关的其他链接：
浏览 0提问于2016-03-11得票数 5
回答已采纳
是否可以为@ApiProperty创建openapi_context "type"="array“？使用注释编写sucha数组的“示例”值的正确方法是什么？我正在使用OAS3 * @ApiProperty( * "openapi_context"={
浏览 8提问于2020-04-23得票数 4
我正在开发一个API，允许使用URL进行搜索，如下所示： GET https://example.com/api/data?search[field1]=value1&search[field2]=value2 基本上，您可以通过将字段名放在括号中来搜索一个或多个字段值。问题是，字段名称由用户在其设置中定义。字段名称将是一个字符串，否则在全局级别上是未知的。 This answer几乎就是我要做的，我只是
浏览 49提问于2019-05-23得票数 1
回答已采纳
无法获得如何在数组参数中使用带枚举值的字符串类型引用。我可以在条目键中引用并且它正在工作，但是Swagger会产生错误:不是一个有效的参数定义正确的方法是什么？我的代码： paths:
/tes
浏览 5提问于2017-01-13得票数 1
回答已采纳
1回答
我有一个这样的端点： api/employees?limit=2&name=Palani&age=20 在这里，limit是发布给用户的关键字。但是name和age是任意参数。对于另一个资源，如Organization，任意参数可以是foundIn。在openapi规范中，我有 api/employees : parameter
浏览 27提问于2020-10-08得票数 1
云服务器
ICP备案
云直播
腾讯会议
实时音视频
腾讯云开发者
