我需要为搜索API定义swagger/OpenAPI v3.0文件。我的请求可以指定地理空间坐标(经度和纬度)或(邮政编码和国家代码)或(城市、州和国家代码)。除此之外，我还有两个强制性属性，如distanceUnits.和#en0#。我知道如何在JSON模式中实现它 "postalCode":
浏览 8提问于2021-09-13得票数 1
回答已采纳
我正在为一个OpenAPI创建一个api 3规范，它有一些对象，其中一些属性是必需的，对于一些属性来说，它们是任意的。当我创建如下规范时，它抛出了一个错误，我无法修复这个错误。enroll channelInfo: required: - cid
浏览 75提问于2019-12-31得票数 0
我在我的openApi 3.0的“组件”部分中定义了以下模式： required: - prop2 propertiesproperties: prop5现在有另一个模式对上述2个模式执行“anyOf”操作，如 anyOf:- $ref: '#/components/schem
浏览 5提问于2021-03-31得票数 0
回答已采纳
2回答
我如何指出在my_object中您可以使用property_1或property_2，但不能两者兼得？ type: object property_1: property_2:
浏览 0提问于2019-04-10得票数 4
回答已采纳
我使用的是OpenAPI 3，有两个查询参数，其中至少一个是必需的，但不管是哪个参数。即，作为sudocode： do stuff error
这在OpenAPI 3中是可能的吗？
浏览 0提问于2018-12-14得票数 12
我已经创建了一个RESTful API，现在我正在为这个API的使用定义OpenAPI3.0JSON表示。
当存在另一个参数时，我需要有条件地使用参数。所以我不能真正使用required: true或required: false，因为它需要有条件的。我是否应该将其定义为required: false，然后在summary和/或description中表示在使用其他参数时需要它？还是有一种方法来定义参数之间的依赖关系？我没有发现提到过这样的案
浏览 0提问于2020-08-01得票数 13
回答已采纳
我需要在有效负载中有两个属性，比如property1和propert2。两者都是数组类型。条件是，要么两者都有值，要么它们中只有一个为非空值。但两者不能同时为空。如何在swagger规范中定义此需求，以便我可以强制执行模式，使两者都不应该为空，但任何一个都可以为空。
浏览 2提问于2022-05-12得票数 1
回答已采纳
1回答
我正在为我的API创建swagger，但是对于具有相同方法的相同端点，我有一个问题。这里有两个相同的端点(/token)，具有相同的httpMethod POST，并且在主体中都有不同的参数。在UI上，没有显示第一个端点。"/token": { "tags": [ ],
"summary": "Get Token by Username and Pas
浏览 4提问于2017-06-15得票数 1
在使用swagger2 (openAPI)构建rest时，我希望允许查询param station_id支持以下内容：
parameters: in: query
description: fi
浏览 8提问于2016-12-21得票数 7
1回答
我使用SwaggerHub和OpenAPI 3来定义API。一个路由GET /foo/{id]应该返回给定id的foo对象及其关联的bar对象。也就是说，foo和bar之间存在着多到多的关系。paths: get: - name: id
浏览 2提问于2018-06-19得票数 0
回答已采纳
讨论如何使用jsonschema将属性指定为null或引用。
注意:一些swagger实现使用x-nullable (或其他一些)来指定属性值为null，但是，$ref用它引用的对象替
浏览 14提问于2016-12-01得票数 35
回答已采纳
3回答
我使用Swagger和Scala来记录我的REST。我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。
浏览 1提问于2015-07-31得票数 15
回答已采纳
我希望能够管理“objects”的json数组，其中每个对象都有一个类型和属性，如果对象中缺少强制属性，则会出现架构错误。'xtype': {'type':'string', 'const':'typeone'}, },
'required'xtype&
浏览 5提问于2020-10-01得票数 1
回答已采纳
我有一个User资源：{ "bio": "My biography"如果单独发送image属性，则现有的bio属性将在服务器上保持不变，我使用的是anyOf对象，其中包含两个单独的type: object。我的定义是否如我所愿？
浏览 8提问于2022-01-27得票数 2
回答已采纳
基于OpenAPI的oneOf鉴别器Animals拥有的唯一属性是legs。我可以把它改为anyOf，但是那样的话鉴别器就没用了？/schemas/Dog'
浏览 28提问于2022-03-18得票数 1
email: 'test@gmail.com' instance: personData, type: "object", { required: ["name", "email"] } }我想要一个模式，将验证对象和从对象的任何键值(名称或电子邮件)，其中一个必须不为空。
浏览 3提问于2020-10-30得票数 0
requestBody: required: true required: - identifier
- type 如何指定只有当type字段值=“identifier
浏览 113提问于2018-12-19得票数 2
我尝试在JSON中定义一个遗留API，对象有一个奇怪的结构，其中包含4个属性，它们中的任何一个都是必需的，其中3个是相互排斥的。这是一个30多个共享的可选属性，在那之后，我会注意到它们是...。允许baz、buzz和fizz相互存在，这是不可能的。我试图定义如下内容： "type": "object", "foo": {"type": &q
浏览 2提问于2014-06-20得票数 10
回答已采纳
1回答
- name: address description: Address to be foobared - name: city description: City of the Address type: string如果我插入exampl
浏览 1提问于2017-05-12得票数 21
回答已采纳
我们使用openapi-generator-maven-plugin版本5.0.1来生成我们的API。我正在尝试指定一个包含DTO和文件的请求。杀死我们的问题是为API和API Delegate生成的类彼此不一致。生成的接口将每个字段视为一个String。但是，API Delegate将它们视为Optional<String>。这是我们的POM，以及相关的依赖项和插件配置： <dependency>
<groupId>io.swagger</grou
浏览 39提问于2021-04-22得票数 0
回答已采纳
云服务器
ICP备案
云直播
即时通信 IM
实时音视频
腾讯云开发者
