using MediaBrowser.Controller.Configuration; 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 => { // Custom path requires {documentName}, SwaggerDoc documentName is 'api-docs' c.RouteTemplate = $"/{baseUrl}{{documentName}}/openapi.json"; }) .UseSwaggerUI(c => { c.DocumentTitle = "Jellyfin API"; c.SwaggerEndpoint($"/{baseUrl}api-docs/openapi.json", "Jellyfin API"); c.RoutePrefix = $"{baseUrl}api-docs/swagger"; }) .UseReDoc(c => { c.DocumentTitle = "Jellyfin API"; c.SpecUrl($"/{baseUrl}api-docs/openapi.json"); c.RoutePrefix = $"{baseUrl}api-docs/redoc"; }); } } }