dotnet core 3.1 swagger 文档

时间:2021-01-28 09:46:28

标签: .net-core swagger swagger-ui swashbuckle.aspnetcore

我正在研究 dotnet core web api 后端应用程序,并使用 swagger 编写端点文档。 我想将 swagger.json 端点自定义为不同的路径,以便它可以在我们的服务器中访问,并且我们的 angular fornt-end 可以在 deloy 后使用该端点。 我在 startup.cs 中使用此代码 在配置服务中

services.AddSwaggerGen(c => {

        c.SwaggerDoc("v1", new OpenApiInfo { Title = "Criistal API v1.0", Version = "v1.0" });
        /////////////////////
        c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
        {
            Description ="JWT Authorization header using the Bearer scheme. \r\n\r\n Enter 'Bearer' [space] and then your token in the text input below.\r\n\r\nExample: \"Bearer 12345abcdef\"",
            Name = "Authorization",
            In = ParameterLocation.Header,
            Type = SecuritySchemeType.ApiKey,
            Scheme = "Bearer"
        });

        c.AddSecurityRequirement(new OpenApiSecurityRequirement()
        {
            {
                new OpenApiSecurityScheme
                {
                    Reference = new OpenApiReference
                    {
                        Type = ReferenceType.SecurityScheme,
                        Id = "Bearer"
                    },
                    Scheme = "oauth2",
                    Name = "Bearer",
                    In = ParameterLocation.Header,

                },
                new List<string>()
            }
        });

        ////////////////////
    });

并在配置中

app.UseSwagger();
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "Criistal API v1.0");
                c.RoutePrefix = string.Empty;
            });

0 个答案:

没有答案
相关问题