Comments

api/Controllers/FileDownloadController.cs

@@ -5,6 +5,7 @@ using Microsoft.AspNetCore.Mvc;
 using Microsoft.AspNetCore.StaticFiles;
 using Microsoft.Extensions.Options;
 using Microsoft.Net.Http.Headers;
+using Swashbuckle.AspNetCore.Annotations;
 
 namespace Api.Controllers
 {
@@ -47,10 +48,19 @@ namespace Api.Controllers
         /// <response code="404">File not found</response>
         /// <response code="416">Requested range not satisfiable</response>
         [HttpGet("{fileName?}")]
+        [SwaggerOperation(Summary = "Download file", Description = "Downloads a file with support for full and ranged (resumable) transfers.")]
+        [SwaggerResponse(StatusCodes.Status200OK, "Full file content returned")]
+        [SwaggerResponse(StatusCodes.Status206PartialContent, "Partial file content returned for a range request")]
+        [SwaggerResponse(StatusCodes.Status400BadRequest, "No file name provided and no default configured")]
+        [SwaggerResponse(StatusCodes.Status404NotFound, "Requested file was not found")]
+        [SwaggerResponse(StatusCodes.Status416RangeNotSatisfiable, "Requested byte range is invalid")]
+        [SwaggerResponse(StatusCodes.Status500InternalServerError, "Unexpected server error while downloading")]
         [ProducesResponseType(StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status206PartialContent)]
+        [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status404NotFound)]
         [ProducesResponseType(StatusCodes.Status416RangeNotSatisfiable)]
+        [ProducesResponseType(StatusCodes.Status500InternalServerError)]
         public async Task<IActionResult> DownloadFile(string? fileName = null)
         {
             try