在Swagger中，如何定义使用文件以及模式参数的API？

Question

我正在尝试使用Swagger定义一个接受实际文件的API和一个描述文件内容的架构对象。这是Swagger YAML的片段。但是，它不会在Swagger编辑器中验证。

/document:
  post:
    summary: Api Summary
    description: Api Description
    consumes:
      - multipart/form-data
    parameters:
      - name: documentDetails
        in: formData
        description: Document Details
        required: true
        schema:
          $ref: '#/definitions/Document'
      - name: document
        in: formData
        description: The actual document
        required: true
        type: file

Swagger编辑器会引发以下验证错误：

Swagger错误：数据与“ oneOf”中的任何架构都不匹配

我想念什么吗？还是这不是Swagger支持的功能？

Answer 1

swagger 不支持 formData 中的“object”类型，仅作为主体参数。