Как указать, что pdf возвращается в swagger?

Question

У меня есть вызов в моем API-интерфейсе REST, который должен вернуть файл PDF. Нет четкого примера/документации о том, как это сделать, не вызывая синтаксическую ошибку.

responses: 
    200: 
     description: Returns PDF 
     schema: [application/pdf] 

и

responses: 
    200: 
     description: Returns PDF 
     schema: 
     type: file 

и

responses: 
    200: 
     description: Returns PDF 
     schema: 
     type: [application/pdf] 

все терпят неудачу. Возможно ли это?

Answer 1

responses: 
    200: 
     description: Returns PDF 
     schema: 
     type: file 

Из предложенных вами вариантов это правильный вариант. Также не забудьте использовать produces: [application/pdf]

Если это не поможет вам, убедитесь, что используете последнюю версию редактора. Была ошибка, связанная с типом file, который был недавно разрешен.