Introduce API version 1.0

src/AzureIoTHub.Portal/Client/Program.cs

@@ -22,8 +22,12 @@ public static async Task Main(string[] args)
             var builder = WebAssemblyHostBuilder.CreateDefault(args);
             builder.RootComponents.Add<App>("#app");
 
-            builder.Services.AddHttpClient("api", client => client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress))
-                                                    /*.AddHttpMessageHandler<BaseAddressAuthorizationMessageHandler>()*/;
+            builder.Services.AddHttpClient("api", client =>
+            {
+                client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
+                client.DefaultRequestHeaders.Add("X-Version", "1.0");
+            })
+                /*.AddHttpMessageHandler<BaseAddressAuthorizationMessageHandler>()*/;
 
             builder.Services.AddFileReaderService(o => o.UseWasmSharedBuffer = true);
 

src/AzureIoTHub.Portal/Server/Controllers/DeviceModelCommandsController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/DeviceModelCommandsController.cs

@@ -11,6 +11,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
     using Microsoft.AspNetCore.Mvc;
 
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("api/models/{modelId}/commands")]
     [ApiExplorerSettings(GroupName = "Device Models")]
     public class DeviceModelCommandsController : ControllerBase

src/AzureIoTHub.Portal/Server/Controllers/DeviceModelsController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/DeviceModelsController.cs

@@ -18,6 +18,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
     using Microsoft.AspNetCore.Mvc;
 
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("api/models")]
     [ApiExplorerSettings(GroupName = "Device Models")]
     public class DeviceModelsController : ControllerBase

src/AzureIoTHub.Portal/Server/Controllers/DevicesController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/DevicesController.cs

@@ -22,6 +22,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
     using Microsoft.Extensions.Logging;
 
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("api/devices")]
     [ApiExplorerSettings(GroupName = "IoT Devices")]
     public class DevicesController : ControllerBase

src/AzureIoTHub.Portal/Server/Controllers/EdgeConfigurationsController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/EdgeConfigurationsController.cs

@@ -15,6 +15,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
     using Newtonsoft.Json.Linq;
 
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("api/edge/configurations")]
     [ApiExplorerSettings(GroupName = "IoT Edge")]
     public class EdgeConfigurationsController : ControllerBase

src/AzureIoTHub.Portal/Server/Controllers/EdgeDevicesController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/EdgeDevicesController.cs

@@ -22,6 +22,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
     using Newtonsoft.Json.Linq;
 
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("api/edge/device")]
     [ApiExplorerSettings(GroupName = "IoT Edge")]
     public class EdgeDevicesController : ControllerBase

src/AzureIoTHub.Portal/Server/Controllers/LoRaWANConcentratorsController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/LoRaWANConcentratorsController.cs

@@ -18,6 +18,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
     using Microsoft.Extensions.Logging;
 
     [ApiController]
+    [ApiVersion("1.0")]
     [Route("api/lorawan/concentrators")]
     [ApiExplorerSettings(GroupName = "LoRa WAN")]
     public class LoRaWANConcentratorsController : ControllerBase

src/AzureIoTHub.Portal/Server/Controllers/SettingsController.cs → src/AzureIoTHub.Portal/Server/Controllers/v1.0/SettingsController.cs

@@ -11,6 +11,7 @@ namespace AzureIoTHub.Portal.Server.Controllers
 
     [ApiController]
     [AllowAnonymous]
+    [ApiVersion("1.0")]
     [Route("/api/settings")]
     [Produces("application/json")]
     [ApiExplorerSettings(GroupName = "Portal Settings")]

src/AzureIoTHub.Portal/Server/Startup.cs

@@ -17,6 +17,8 @@ namespace AzureIoTHub.Portal.Server
     using Microsoft.AspNetCore.Builder;
     using Microsoft.AspNetCore.Hosting;
     using Microsoft.AspNetCore.Http;
+    using Microsoft.AspNetCore.Mvc;
+    using Microsoft.AspNetCore.Mvc.Versioning;
     using Microsoft.Azure.Devices;
     using Microsoft.Azure.Devices.Provisioning.Service;
     using Microsoft.Extensions.Configuration;
@@ -146,6 +148,16 @@ public void ConfigureServices(IServiceCollection services)
                 opts.TagActionsBy(api => new[] { api.GroupName });
                 opts.DocInclusionPredicate((name, api) => true);
             });
+
+            services.AddApiVersioning(o =>
+            {
+                o.AssumeDefaultVersionWhenUnspecified = true;
+                o.DefaultApiVersion = new ApiVersion(1, 0);
+                o.ReportApiVersions = true;
+                o.ApiVersionReader = ApiVersionReader.Combine(
+                    new QueryStringApiVersionReader("api-version"),
+                    new HeaderApiVersionReader("X-Version"));
+            });
         }
 
         // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.