Add Scalar

Author: Tsingis

App/Api/Api.csproj

@@ -3,6 +3,7 @@
     <ProjectReference Include="..\Services\Services.csproj" />
     <PackageReference Include="Asp.Versioning.Mvc.ApiExplorer" />
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" />
+    <PackageReference Include="Scalar.AspNetCore" />
     <PackageReference Include="Serilog" />
     <PackageReference Include="Serilog.Extensions.Hosting" />
     <PackageReference Include="Serilog.Settings.Configuration" />

App/Api/Properties/launchSettings.json

@@ -5,7 +5,7 @@
       "hotReloadEnabled": true,
       "dotnetRunMessages": true,
       "launchBrowser": true,
-      "launchUrl": "http://localhost:5000/",
+      "launchUrl": "http://localhost:5000/scalar",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development",
         "ASPNETCORE_HTTP_PORTS": "5000"

App/Api/Setup/ApiMiddleware.cs

@@ -1,3 +1,5 @@
+using Scalar.AspNetCore;
+
 namespace Api.Setup;
 
 internal static class ApiMiddleware
@@ -13,21 +15,23 @@ public static void ConfigureMiddleware(this WebApplication app, IWebHostEnvironm
 
         app.UseOutputCache();
 
-        app.UseStaticFiles();
+        app.MapOpenApi("/openapi/{documentName}.json");
+
+        app.UseSwagger(opt =>
+        {
+            opt.RouteTemplate = "swagger/{documentName}/swagger.json";
+        });
 
-        app.UseSwagger();
         app.UseSwaggerUI(opt =>
         {
-            var descriptions = app.DescribeApiVersions();
-            foreach (var desc in descriptions)
-            {
-                var url = $"/swagger/{desc.GroupName}/swagger.json";
-                var name = desc.GroupName.ToUpperInvariant();
-                opt.SwaggerEndpoint(url, name);
-            }
-            opt.RoutePrefix = string.Empty;
-            var indexPath = Path.Combine(environment.WebRootPath, "swagger-ui", "index.html");
-            opt.IndexStream = () => new FileStream(indexPath, FileMode.Open, FileAccess.Read);
+            opt.RoutePrefix = "swagger";
+        });
+
+        app.MapScalarApiReference(endpointPrefix: "/scalar", opt =>
+        {
+            opt.Title = "Bitcoin Web API";
+            opt.ShowSidebar = true;
+            opt.DarkMode = true;
         });
 
         app.MapHealthChecks("health");
@@ -41,7 +45,6 @@ public static void ConfigureMiddleware(this WebApplication app, IWebHostEnvironm
 
         app.Use(async (context, next) =>
         {
-            context.Response.Headers.Append("Content-Security-Policy", "default-src 'self'");
             context.Response.Headers.Append("X-Content-Type-Options", "nosniff");
             context.Response.Headers.Append("X-Frame-Options", "DENY");
             context.Response.Headers.Append("Referrer-Policy", "no-referrer");

App/Api/Setup/ApiServices.cs

@@ -28,9 +28,9 @@ public static void ConfigureServices(this IServiceCollection services)
             opt.SubstituteApiVersionInUrl = true;
         });
 
+        services.AddOpenApi();
 
         services.AddSwaggerGen();
-        services.ConfigureOptions<SwaggerOptions>();
 
         services.Configure<JsonOptions>(opt =>
         {

App/Api/Setup/SwaggerOptions.cs

@@ -9,6 +9,7 @@
     <PackageVersion Include="Microsoft.AspNetCore.WebUtilities" Version="9.0.4" />
     <PackageVersion Include="Microsoft.Extensions.Http" Version="9.0.4" />
     <PackageVersion Include="Microsoft.Extensions.Logging" Version="9.0.4" />
+    <PackageVersion Include="Scalar.AspNetCore" Version="2.1.11" />
     <PackageVersion Include="Serilog" Version="4.2.0" />
     <PackageVersion Include="Serilog.Extensions.Hosting" Version="9.0.0" />
     <PackageVersion Include="Serilog.Settings.Configuration" Version="9.0.0" />

App/Api/wwwroot/swagger-ui/index.html

@@ -63,9 +63,16 @@ public async Task BuyAndSell(string? fromDate, string? toDate, HttpStatusCode st
     }
 
     [Fact]
-    public async Task Swagger()
+    public async Task SwaggerUI()
     {
-        var result = await _fixture.Client.GetAsync("/", cancellationToken: TestContext.Current.CancellationToken);
+        var result = await _fixture.Client.GetAsync("/swagger", cancellationToken: TestContext.Current.CancellationToken);
+        result.StatusCode.ShouldBe(HttpStatusCode.OK);
+    }
+
+    [Fact]
+    public async Task ScalarUI()
+    {
+        var result = await _fixture.Client.GetAsync("/scalar", cancellationToken: TestContext.Current.CancellationToken);
         result.StatusCode.ShouldBe(HttpStatusCode.OK);
     }