OpenAPI ​

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers();
    
    // 注册Swagger服务
    services.AddSwaggerGen(c =>
    {
        //基础信息
        c.SwaggerDoc("v1", new OpenApiInfo
        {
            Version = "v1",
            Title = "ColinChang.ApiSample",
            Description = "基于`JWT Bear`认证策略 案例",
            Contact = new OpenApiContact
            {
                Name = "Colin Chang",
                Email = "zhangcheng@xymind.cn",
                Url = new Uri("https://dotnet.a-nomad.com/auth/jwt.html#_3-2-jwt-认证方案")
            },
            License = new OpenApiLicense
            {
                Name = "ColinChang License",
                Url = new Uri("https://a-nomad.com")
            }
        });
        //显示注释
        c.IncludeXmlComments(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, $"{GetType().Assembly.GetName().Name}.xml"),true);

        //API授权
        c.AddSecurityDefinition("oauth2", new OpenApiSecurityScheme
        {
            Name = "Authorization",
            Description = "请在下方输入Bearer {token}（注意两者之间是一个空格）",
            In = ParameterLocation.Header,
            Type = SecuritySchemeType.ApiKey
        });
        c.OperationFilter<AddResponseHeadersFilter>();
        c.OperationFilter<AppendAuthorizeToSummaryOperationFilter>();
        c.OperationFilter<SecurityRequirementsOperationFilter>();
    });
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseSwagger();
        app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "ColinChang.ApiSample v1"));
    }
    
    app.UseRouting();
    app.UseAuthentication();
    app.UseAuthorization();
    app.UseEndpoints(endpoints => endpoints.MapControllers());
}