Swagger.io - post方法

Question

我有一个关于如何使用yaml语法在swagger中定义引用数组的问题。我有以下yaml片段，它定义了我的字段：

    - name: myfield
      in: formData
      description: 'description'
      required: false
      type: array
      items:
        $ref: '#/definitions/MyRef'

定义如下：

  MyRef:
    type: object
    properties:
      id:
        type: integer
      value:
        type: string
        description: the value for the myRef

在我的字段预览中，一切看起来都很好：

但我收到错误“不是有效的参数定义”，并且在详细错误中我得到“数据与'oneOf'中的任何模式都不匹配”。

我在文档中找不到这样的内容。那么什么是正确的结构或我错过了什么？

Answer 1

那是因为formData只能 包含基元或基元数组。您无法使用$ref作为items值。这将在下一版本的规范（3.0）中进行更改，但2.0工具不支持，因为规范不允许。