swagger - 如何指定以 Swagger 返回的pdf？

Question

我的REST API中有一个get调用，该调用需要返回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类型相关的错误。