dotnetコアを使用したSwaggerドキュメントのファイルのタイプを返します。

Question

私はdotnetコアWeb APIを文書化するためにSwagger for dotnet coreを使用しています。

私はコントローラのメソッドの上に [ProducesResponseType(typeof(XXXXX),200)]を追加する必要があることを伝えるドキュメントを読んで、メソッドの応答タイプを掃除するのを手助けしました。

私はファイルを返すコントローラメソッドを持っています。私はファイルを返すように私にどのように伝えることができるかを考えています。

public class DocumentController : Controller 
{ 
    private readonly IDocumentService _documentService; 

    public DocumentController(IDocumentService documentService) 
    { 
     _documentService = documentService; 
    } 

    [HttpGet("{documentId}", Name= DocumentRoutes.Document)] 
    [ProducesResponseType(typeof(XXXXX), 200)] // <== What goes here? 
    public async Task<IActionResult> GetDocument(Guid documentId) 
    { 
     DocumentAdto documentAdto = await _documentService.GetAsync(documentId); 
     return File(documentAdto.DocumentBytes, documentAdto.ContentType, documentAdto.Name); 
    } 
} 

誰にでもアイデアはありますか？

私はbyte []に​​ついて考えましたが、戻り値の型は "byte"と書かれています。

Answer 1

必要なものはProducesAttributeで、コンテンツタイプをパラメータとして指定します（PDFファイルの場合は「application/pdf」など）。

編集：それはスウィガーがProducesAttributeでピックアップしないことがあります。私の提案は、ProducesResponseTypeのためにTypeの設定を解除し、/// <response code="200">Returns the requested file</response>のコメントをメソッドに追加することです。