yaml - 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可能只包含基元或基元数组。您不能使用 a$ref作为items值。这将在下一版本的规范 (3.0) 中更改，但在 2.0 工具中不受支持，因为规范不允许这样做。