Wie kann man angeben, dass eine pdf-Datei in swagger zurückgegeben wird?

Question

Ich habe einen Aufruf in meiner Swagger-REST-API, die eine PDF-Datei zurückgeben muss. Es gibt kein klares Beispiel/Dokumentation, wie dies ohne einen Syntaxfehler zu tun ist.

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

und

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

und

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

alle scheitern. Ist das überhaupt möglich?

Answer 1

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

Aus den Optionen, die Sie gaben, das ist die richtige Option. Stellen Sie außerdem sicher, dass produces: [application/pdf]

verwendet wird. Wenn es für Sie fehlschlägt, stellen Sie sicher, dass Sie die neueste Version des Editors verwenden. Es gab einen Fehler im Zusammenhang mit dem file-Typ, der kürzlich behoben wurde.