В 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: данные не соответствуют ни одной схеме из 'oneOf'
Я что-то пропустил? Или это не поддерживаемая функция Swagger?