using MediaBrowser.Controller.Configuration; using Jellyfin.Server.Middleware; using Microsoft.AspNetCore.Builder; namespace Jellyfin.Server.Extensions { /// /// Extensions for adding API specific functionality to the application pipeline. /// public static class ApiApplicationBuilderExtensions { /// /// Adds swagger and swagger UI to the application pipeline. /// /// The application builder. /// The server configuration. /// The updated application builder. public static IApplicationBuilder UseJellyfinApiSwagger( this IApplicationBuilder applicationBuilder, IServerConfigurationManager serverConfigurationManager) { // Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.), // specifying the Swagger JSON endpoint. var baseUrl = serverConfigurationManager.Configuration.BaseUrl.Trim('/'); if (!string.IsNullOrEmpty(baseUrl)) { baseUrl += '/'; } return applicationBuilder .UseSwagger(c => { c.RouteTemplate = $"/{baseUrl}api-docs/{{documentName}}/openapi.json"; }) .UseSwaggerUI(c => { c.DocumentTitle = "Jellyfin API v1"; c.SwaggerEndpoint($"/{baseUrl}api-docs/v1/openapi.json", "Jellyfin API v1"); c.RoutePrefix = $"{baseUrl}api-docs/v1/swagger"; }) .UseReDoc(c => { c.DocumentTitle = "Jellyfin API v1"; c.SpecUrl($"/{baseUrl}api-docs/v1/openapi.json"); c.RoutePrefix = $"{baseUrl}api-docs/v1/redoc"; }); } } }