用Swagger描述多范围参数

Question

我想在Swagger 2.0中描述一个定义如下的参数：

• 参数在以下时间间隔中取有效值： -20 <参数<-10 或 0 <参数<30

• 如果以下参数无效： -10≤参数≤0

这意味着它具有两个有效的间隔，因此有两个要定义的最大值和最小值。 Swagger规范是否支持这种定义？

Answer 1

这不能在OpenAPI / Swagger 2.0中进行描述，但可以在OpenAPI 3.0中使用oneOf进行描述。

# openapi: 3.0.0

type: integer
oneOf:
  - minimum: -20
    maximum: -10
    exclusiveMinimum: true
    exclusiveMaximum: true
  - minimum: 0
    maximum: 30
    exclusiveMinimum: true
    exclusiveMaximum: true