Могут ли быть поля параметров для заголовков содержимого в 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"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

Ожидаемый результат: поле параметра для каждого заголовка в теле запроса.

Фактический результат: в пользовательском интерфейсе такого поля параметров нет.

0 ответов

Другие вопросы по тегам