using Jellyfin.Server.Middleware; 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"; c.InjectStylesheet($"/{baseUrl}api-docs/swagger/custom.css"); }) .UseReDoc(c => { c.DocumentTitle = "Jellyfin API"; c.SpecUrl($"/{baseUrl}api-docs/openapi.json"); c.RoutePrefix = $"{baseUrl}api-docs/redoc"; c.InjectStylesheet($"/{baseUrl}api-docs/redoc/custom.css"); }); } /// /// Adds IP based access validation to the application pipeline. /// /// The application builder. /// The updated application builder. public static IApplicationBuilder UseIpBasedAccessValidation(this IApplicationBuilder appBuilder) { return appBuilder.UseMiddleware(); } /// /// Adds LAN based access filtering to the application pipeline. /// /// The application builder. /// The updated application builder. public static IApplicationBuilder UseLanFiltering(this IApplicationBuilder appBuilder) { return appBuilder.UseMiddleware(); } /// /// Adds base url redirection to the application pipeline. /// /// The application builder. /// The updated application builder. public static IApplicationBuilder UseBaseUrlRedirection(this IApplicationBuilder appBuilder) { return appBuilder.UseMiddleware(); } /// /// Adds a custom message during server startup to the application pipeline. /// /// The application builder. /// The updated application builder. public static IApplicationBuilder UseServerStartupMessage(this IApplicationBuilder appBuilder) { return appBuilder.UseMiddleware(); } /// /// Adds a WebSocket request handler to the application pipeline. /// /// The application builder. /// The updated application builder. public static IApplicationBuilder UseWebSocketHandler(this IApplicationBuilder appBuilder) { return appBuilder.UseMiddleware(); } } }