在Swagger中,如何定义一个使用文件和模式参数的API?

我试图使用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 Error: Data does not match any schemas from ‘oneOf’

我错过了什么吗?或者这不是Swagger的支持功能?

最佳答案 swagger不支持formData中的’object’类型,仅作为body参数.

点赞