added support for versioning the api

server/Controllers/v1/EpisodesController.cs

@@ -1,15 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc;
 using server.Models;
 using server.Persistence.Repositories;
 
-namespace server.Controllers
+namespace server.Controllers.v1
 {
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("/api/episodes")]
     [Produces("application/json")]
     public class EpisodesController : ControllerBase
@@ -21,16 +17,15 @@ namespace server.Controllers
             _episodeRepository = episodeRepository;
         }
 
+        [MapToApiVersion("1.0")]
         [HttpGet]
         [ProducesResponseType(typeof(List<Episode>), 200)]
         [ProducesResponseType(500)]
-        public async Task<ActionResult<List<Episode>>> GetEpisodesAsync([FromQuery]EpisodeFilter? filter)
+        public async Task<ActionResult<List<Episode>>> GetEpisodesAsync([FromQuery] EpisodeFilter? filter)
         {
             try
             {
-#pragma warning disable CS8604 // Possible null reference argument.
                 var seasons = await _episodeRepository.GetEpisodesAsync(filter);
-#pragma warning restore CS8604 // Possible null reference argument.
                 return Ok(seasons);
             }
             catch (Exception e)

server/Controllers/v1/SeasonsController.cs

@@ -2,9 +2,10 @@
 using server.Models;
 using server.Persistence.Repositories;
 
-namespace server.Controllers
+namespace server.Controllers.v1
 {
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("/api/seasons")]
     [Produces("application/json")]
     public class SeasonsController : ControllerBase
@@ -16,6 +17,7 @@ namespace server.Controllers
             _seasonRepository = seasonRepository;
         }
 
+        [MapToApiVersion("1.0")]
         [HttpGet]
         [ProducesResponseType(typeof(List<Season>), 200)]
         [ProducesResponseType(500)]
@@ -33,6 +35,7 @@ namespace server.Controllers
             }
         }
 
+        [MapToApiVersion("1.0")]
         [HttpGet("{number:int}")]
         [ProducesResponseType(typeof(Season), 200)]
         [ProducesResponseType(typeof(ErrorResponse), 404)]

server/Options/ConfigureSwaggerOptions.cs

@@ -0,0 +1,39 @@
+using Microsoft.AspNetCore.Mvc.ApiExplorer;
+using Microsoft.Extensions.Options;
+using Microsoft.OpenApi.Models;
+using Swashbuckle.AspNetCore.SwaggerGen;
+
+namespace server.Options
+{
+    public class ConfigureSwaggerOptions : IConfigureOptions<SwaggerGenOptions>
+    {
+        private readonly IApiVersionDescriptionProvider _provider;
+
+        public ConfigureSwaggerOptions(IApiVersionDescriptionProvider provider)
+        {
+            _provider = provider;
+        }
+
+        public void Configure(SwaggerGenOptions options)
+        {
+            foreach (var description in _provider.ApiVersionDescriptions)
+            {
+                var versionInfo = CreateVersionInfo(description);
+
+                options.SwaggerDoc(description.GroupName, versionInfo);
+            }
+        }
+
+        private OpenApiInfo CreateVersionInfo(ApiVersionDescription description)
+        {
+            var info = new OpenApiInfo
+            {
+                Title = "criminalmindsapi",
+                Version = description.ApiVersion.ToString(),
+                Description = "An api that provides information about the Criminal Minds series."
+            };
+
+            return info;
+        }
+    }
+}

server/Program.cs

@@ -1,5 +1,9 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.ApiExplorer;
+using Microsoft.AspNetCore.Mvc.Versioning;
 using Microsoft.Extensions.Options;
 using Microsoft.OpenApi.Models;
+using server.Options;
 using server.Persistence;
 using server.Persistence.Repositories;
 using server.Persistence.Seed;
@@ -17,8 +21,6 @@ if (args.Length == 2 && args[0].ToLower() == "seed")
     {
         await seeder.SeedEpisodesAsync();
     }
-
-
 }
 
 var builder = WebApplication.CreateBuilder(args);
@@ -39,18 +41,38 @@ builder.Services.AddControllers();
 
 builder.Services.AddEndpointsApiExplorer();
 
-builder.Services.AddSwaggerGen(c =>
+builder.Services.AddSwaggerGen();
+
+builder.Services.ConfigureOptions<ConfigureSwaggerOptions>();
+
+builder.Services.AddApiVersioning(config =>
 {
-    c.SwaggerDoc("v1", new OpenApiInfo { Title = "criminalmindsapi", Version = "v1" });
+    config.DefaultApiVersion = new ApiVersion(1, 0);
+    config.AssumeDefaultVersionWhenUnspecified = true;
+    config.ReportApiVersions = true;
+    config.ApiVersionReader = new HeaderApiVersionReader("x-api-version");
+});
+
+builder.Services.AddVersionedApiExplorer(config =>
+{
+    config.GroupNameFormat = "'v'VVV";
 });
 
 var app = builder.Build();
 
 app.UseSwagger();
 
-app.UseSwaggerUI(c =>
+app.UseSwaggerUI(options =>
 {
-    c.SwaggerEndpoint("/swagger/v1/swagger.json", "criminalmindsapi v1");
+    var provider = app.Services.GetRequiredService<IApiVersionDescriptionProvider>();
+    
+    foreach (var description in provider.ApiVersionDescriptions)
+    {
+        var url = $"/swagger/{description.GroupName}/swagger.json";
+        var name = $"criminalmindsapi v{description.ApiVersion.ToString()}";
+
+        options.SwaggerEndpoint(url, name);
+    }
 });
 
 app.UseHttpsRedirection();

server/server.csproj

@@ -11,6 +11,8 @@
   </ItemGroup>
 
   <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Versioning" Version="5.0.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer" Version="5.0.0" />
     <PackageReference Include="MongoDB.Driver" Version="2.16.0" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="6.3.1" />
   </ItemGroup>