feat: add api versioning

OliverBooth/Controllers/Api/v1/BlogApiController.cs

@@ -1,17 +1,19 @@
+using Asp.Versioning;
 using Humanizer;
 using Microsoft.AspNetCore.Mvc;
 using OliverBooth.Data.Blog;
 using OliverBooth.Data.Web;
 using OliverBooth.Services;
 
-namespace OliverBooth.Controllers.Api;
+namespace OliverBooth.Controllers.Api.v1;
 
 /// <summary>
 ///     Represents a controller for the blog API.
 /// </summary>
 [ApiController]
-[Route("api/blog")]
+[Route("api/v{version:apiVersion}/blog")]
 [Produces("application/json")]
+[ApiVersion(1)]
 public sealed class BlogApiController : ControllerBase
 {
     private readonly IBlogPostService _blogPostService;

OliverBooth/OliverBooth.csproj

@@ -9,6 +9,7 @@
 
     <ItemGroup>
         <PackageReference Include="Alexinea.Extensions.Configuration.Toml" Version="7.0.0"/>
+        <PackageReference Include="Asp.Versioning.Mvc" Version="8.0.0" />
         <PackageReference Include="AspNetCore.ReCaptcha" Version="1.7.0"/>
         <PackageReference Include="BCrypt.Net-Core" Version="1.6.0"/>
         <PackageReference Include="HtmlAgilityPack" Version="1.11.59"/>

OliverBooth/Program.cs

@@ -1,3 +1,4 @@
+using Asp.Versioning;
 using AspNetCore.ReCaptcha;
 using Markdig;
 using OliverBooth.Data.Blog;
@@ -31,6 +32,14 @@ builder.Services.AddSingleton(provider => new MarkdownPipelineBuilder()
     .UseSmartyPants()
     .Build());
 
+builder.Services.AddApiVersioning(options =>
+{
+    options.AssumeDefaultVersionWhenUnspecified = true;
+    options.DefaultApiVersion = new ApiVersion(1);
+    options.ReportApiVersions = true;
+    options.ApiVersionReader = new UrlSegmentApiVersionReader();
+});
+
 builder.Services.AddDbContextFactory<BlogContext>();
 builder.Services.AddDbContextFactory<WebContext>();
 builder.Services.AddHttpClient();

src/ts/API.ts

@@ -2,7 +2,7 @@ import BlogPost from "./BlogPost";
 import Author from "./Author";
 
 class API {
-    private static readonly BASE_URL: string = "/api";
+    private static readonly BASE_URL: string = "/api/v1";
     private static readonly BLOG_URL: string = "/blog";
 
     static async getBlogPostCount(): Promise<number> {