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

У меня есть вызов в моем 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]

все сбой. Возможно ли это?

Ответы

Ответ 1

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

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

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