using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;

public void ConfigureServices(IServiceCollection services)
{
    // 其他服務(wù)配置...

    // 添加Swagger生成器服務(wù)
    services.AddSwaggerGen(c =>
    {
        // 定義Swagger文檔信息
        c.SwaggerDoc("v1", new OpenApiInfo
        {
            Version = "v1",
            Title = "Your API Title",
            Description = "Your API description",
            TermsOfService = new Uri("https://example.com/terms"),
            Contact = new OpenApiContact
            {
                Name = "Contact Name",
                Email = "contact@example.com",
                Url = new Uri("https://example.com/contact")
            },
            License = new OpenApiLicense
            {
                Name = "License Name",
                Url = new Uri("https://example.com/license")
            }
        });

        // 配置XML注釋文件路徑，以便在Swagger文檔中顯示方法注釋等信息
        var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
        var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
        c.IncludeXmlComments(xmlPath);

        // 如果你的API有身份驗(yàn)證等安全機(jī)制，可以在這里配置
        c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
        {
            In = ParameterLocation.Header,
            Description = "Please enter JWT with Bearer prefix",
            Name = "Authorization",
            Type = SecuritySchemeType.ApiKey
        });
        c.AddSecurityRequirement(new OpenApiSecurityRequirement
        {
            {
                new OpenApiSecurityScheme
                {
                    Reference = new OpenApiReference
                    {
                        Type = ReferenceType.SecurityScheme,
                        Id = "Bearer"
                    }
                },
                new string[] {}
            }
        });
    });
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他中間件配置...

    // 啟用Swagger
    app.UseSwagger();

    // 啟用Swagger UI，指定Swagger JSON文檔的路由
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "Your API v1");
        // 如果需要，可以配置Swagger UI的其他選項(xiàng)，如文檔展開深度等
        c.DocExpansion(DocExpansion.None);
    });
}

/// <summary>
/// 獲取用戶信息
/// </summary>
/// <param name="id">用戶ID</param>
/// <returns>用戶信息對象</returns>
[HttpGet("{id}")]
public IActionResult GetUser(int id)
{
    // 方法實(shí)現(xiàn)
}

using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;

// 添加Swagger生成器服務(wù)
services.AddSwaggerGen(c =>
{
    // 其他Swagger配置...

    // 添加JWT Bearer安全定義
    c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
    {
        // 定義安全機(jī)制的類型為API密鑰
        Type = SecuritySchemeType.ApiKey,
        // 說明該密鑰位于請求頭中
        In = ParameterLocation.Header,
        // 請求頭中用于傳遞JWT令牌的字段名稱
        Name = "Authorization",
        // 對該安全定義的描述，在Swagger UI中會顯示給用戶
        Description = "請輸入帶有Bearer前綴的JWT令牌"
    });

    // 添加安全要求，指定使用Bearer安全定義的API需要進(jìn)行身份驗(yàn)證
    c.AddSecurityRequirement(new OpenApiSecurityRequirement
    {
        {
            new OpenApiSecurityScheme
            {
                // 引用前面定義的Bearer安全定義
                Reference = new OpenApiReference
                {
                    Type = ReferenceType.SecurityScheme,
                    Id = "Bearer"
                }
            },
            // 這里可以指定一些額外的作用域或權(quán)限，如果不需要可以留空數(shù)組
            new string[] { }
        }
    });
});

using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;

// 添加Swagger生成器服務(wù)
services.AddSwaggerGen(c =>
{
    // 其他Swagger配置...

    // 添加API密鑰安全定義
    c.AddSecurityDefinition("ApiKey", new OpenApiSecurityScheme
    {
        // 定義安全機(jī)制的類型為API密鑰
        Type = SecuritySchemeType.ApiKey,
        // 說明該密鑰位于請求頭中
        In = ParameterLocation.Header,
        // 請求頭中用于傳遞API密鑰的字段名稱
        Name = "X-Api-Key",
        // 對該安全定義的描述，在Swagger UI中會顯示給用戶
        Description = "請輸入你的API密鑰"
    });

    // 添加安全要求，指定使用ApiKey安全定義的API需要提供有效的API密鑰
    c.AddSecurityRequirement(new OpenApiSecurityRequirement
    {
        {
            new OpenApiSecurityScheme
            {
                // 引用前面定義的ApiKey安全定義
                Reference = new OpenApiReference
                {
                    Type = ReferenceType.SecurityScheme,
                    Id = "ApiKey"
                }
            },
            // 這里可以指定一些額外的作用域或權(quán)限，如果不需要可以留空數(shù)組
            new string[] { }
        }
    });
});