DocumentService/DocumentOperator.API/Configuration/SwaggerConfiguration.cs

using Microsoft.OpenApi.Models;
using System.Reflection;

namespace DocumentOperator.API.Configuration
{
    /// <summary>
    /// Provides extension methods for configuring Swagger/OpenAPI documentation.
    /// </summary>
    public static class SwaggerConfiguration
    {
        /// <summary>
        /// Adds Swagger documentation generation to the service collection.
        /// </summary>
        /// <param name="services">The service collection to add Swagger to.</param>
        /// <returns>The modified service collection.</returns>
        public static IServiceCollection AddSwaggerDocumentation(this IServiceCollection services)
        {
            services.AddSwaggerGen(options =>
            {
                options.SwaggerDoc("v1", new OpenApiInfo
                {
                    Title = "DD Document Operator API",
                    Version = "v1",
                    Description = "PDF Verarbeitungs-Service für Validierung, Stempel, Zertifikate, Anhänge & Zusammenführung"
                });

                // Resolve conflicting actions: Keep first variant
                // DualInputDocumentFilter will merge both variants into single operation
                options.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());

                // Add document filter to merge operations with different content types
                options.DocumentFilter<DualInputDocumentFilter>();

                // XML-Kommentare einbinden
                var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
                var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
                options.IncludeXmlComments(xmlPath);
            });

            return services;
        }
    }
}