Могут ли быть поля параметров для заголовков содержимого в swagger-ui для конкретного содержимого данных формы в теле многочастного запроса в swagger-3.0?
Я пытаюсь создать документацию для некоторых вызовов REST API. Метод POST в одном из вызовов API принимает содержимое данных формы, состоящее из нескольких частей, с 1-й частью в виде данных двоичного файла и 2-й частью в качестве экземпляра json. Я ищу способ, позволяющий пользователям, имеющим доступ к пользовательскому интерфейсу swagger, вводить значение заголовка Content-Disposition и заголовка Content-Range только для 1-й части содержимого данных формы из нескольких частей. Я пытался использовать объект заголовка внутри объекта кодирования, но он не создавал никаких изменений в пользовательском интерфейсе. Я ожидал получить поле параметра для заголовка внутри тела запроса, как параметры заголовка запроса, заданные списком параметров. Может быть, я что-то упустил. Если это не правильный путь, есть ли другой способ, которым я могу это сделать? Заранее спасибо.
Вот часть swagger.json с телом запроса:
{
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"file": {
"type": "string",
"format": "binary"
},
"instance": {
"type": "object",
"properties": {
"fileName": {
"type": "string"
},
"fileType": {
"type": "string"
}
}
}
}
},
"encoding": {
"file": {
"headers": {
"content-disposition": {
"schema": {
"type": "string"
}
},
"content-range": {
"schema": {
"type": "string"
}
}
}
}
}
}
}
}
}
Ожидаемый результат: поле параметра для каждого заголовка в теле запроса.
Фактический результат: в пользовательском интерфейсе такого поля параметров нет.