我试图使用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参数.