Swagger Error JSON Schema对象的确定性版本

Question

这是架构定义。

serviceArea: [{
    states: [{
        type: String
    }],
    districts: [{
        type: String
    }],
    cities: [{
        type: String
    }]
}]

这是一个昂首阔步的定义。

serviceArea: 
    - states: 
        - type: String
      districts: 
        - type: String
      cities: 
        - type: String

我收到了上述错误。请帮忙。提前致谢。 这是浏览器中的招摇编辑器。

Answer 1

假设serviceArea应该是具有属性states，districts和cities的对象，则定义应如下所示：

serviceArea:
  type: object
  properties:
    states:
      type: string
    districts:
      type: string
    cities:
      type: string

OP的评论

更新：

  

这是一个数组数组。

数组数组描述为：

serviceArea:
  type: array
  items:
    type: array
    items:
      type: string

另一个错误在于：

type:
  - number
  - "null"

type必须是单一类型，例如type: number，而不是类型数组。此外，OpenAPI规范2.0不支持null类型。有些工具使用扩展属性x-nullable: true来表示可以为空的类型，因此您可以尝试这样做：

type: number
x-nullable: true

nullable将在下一版本OpenAPI 3.0中原生支持。