swagger - 使用 Swagger 描述多范围参数

Question

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

该参数在区间中采用有效值: -20 < 参数 < -10 或 0 < 参数 < 30

如果:，则该参数无效-10 ≤ 参数 ≤ 0

这意味着它有两个有效区间，因此 两个最大值和最小值来定义 .
Swagger 规范是否支持这种定义？

Answer 1

这不能在 OpenAPI/Swagger 2.0 中描述，但可以在 OpenAPI 3.x 中使用 oneOf 描述。 .
开放API 3.0

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

开放API 3.1

type: integer
oneOf:
  - exclusiveMinimum: -20
    exclusiveMaximum: -10
  - exclusiveMinimum: 0
    exclusiveMaximum: 30

exclusiveM*关键字是 changed from boolean to numbers在 JSON Schema Draft 6 中。OAS 3.1 默认使用 JSON Schema 2020-12。