如何在swagger 2.0中定义嵌套数组对象

时间:2018-09-28 15:11:03

标签: arrays nested swagger swagger-2.0 ref

我尝试用招摇的方式定义对象数组作为响应: /product: get: operationId: api.product.read_all tags: - Product summary: Read the Products description: Read the Products responses: 200: description: Successfully read product set operation schema: type: array items: oneOf: - $ref: '#/definitions/product'

但是我发现这些错误:

Schema error at paths['/product'].get.responses['200']
should NOT have additional properties
additionalProperty: description, schema
Jump to line 138
Schema error at paths['/product'].get.responses['200'].schema
should NOT have additional properties
additionalProperty: items
Jump to line 140
Schema error at paths['/product'].get.responses['200'].schema
should match exactly one schema in oneOf
Jump to line 140
Schema error at paths['/product'].get.responses['200'].schema.type
should be equal to one of the allowed values
allowedValues: file
Jump to line 141
Schema error at paths['/product'].get.responses['200'].schema.items
should NOT have additional properties
additionalProperty: anyOf
Jump to line 142
Schema error at paths['/product'].get.responses['200'].schema.items
should be array
Jump to line 142
Schema error at paths['/product'].get.responses['200'].schema.items
should match some schema in anyOf
Jump to line 142

我知道我可以对对象使用嵌套数组:

      schema:
        type: array
        items:
          properties:
            id:
              type: string
              description: Id of the cat
            name:
              type: string
              description: category name

但是我想将内部数组对象ref应用于我已经定义的一些对象。可以昂首阔步地做到这一点吗?

我使用swagger 2.0

0 个答案:

没有答案