paths - ¿Cómo especificar que un pdf se devuelve en swagger?

swagger routes

Question

Tengo una llamada Get en mi API REST swagger que necesita devolver un archivo pdf. No hay un ejemplo / documentación clara sobre cómo hacer esto sin causar un error de sintaxis.

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

y

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

y

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

todos fallan ¿Es esto posible?

Answer 1

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

Fuera de las opciones que dio, esa es la opción correcta. Además, asegúrese de usar produces: [application/pdf]

Si falla para ti, asegúrate de usar la última versión del editor. Hubo un error relacionado con el tipo de file que se resolvió recientemente.