在項(xiàng)目中引用Swashbuckle.AspNetCore和Swashbuckle.AspNetCore.Filters兩個(gè)dll，在Startup中的ConfigureServices相關(guān)配置代碼如下 ? ? ?

?兩個(gè)重點(diǎn)：

1、options.DocumentFilter<HiddenApiFilter>();定義那些接口方法被隱藏

2、啟用oauth2安全授權(quán)訪問api接口

options.OperationFilter<SecurityRequirementsOperationFilter>();
//給api添加token令牌證書
options.AddSecurityDefinition("oauth2", new OpenApiSecurityScheme
{
Description = "JWT授權(quán)(數(shù)據(jù)將在請(qǐng)求頭中進(jìn)行傳輸) 直接在下框中輸入Bearer {token}（注意兩者之間是一個(gè)空格）\"",
Name = "Authorization",//jwt默認(rèn)的參數(shù)名稱
In = ParameterLocation.Header,//jwt默認(rèn)存放Authorization信息的位置(請(qǐng)求頭中)
Type = SecuritySchemeType.ApiKey
});

其中使用SecurityRequirementsOperationFilter需要在控制器頭部加[Authorization]或則方法頭部加[Authorization]，如下：

[Authorize]
public class TokenController : ControllerBase

或者

[Authorize("Customer")]
public PersonResponse GetPerson([FromBody]PersonRequest personRequest)
這樣在每個(gè)接口才會(huì)有小鎖出現(xiàn)。

更多介紹請(qǐng)參考https://github.com/domaindrivendev/Swashbuckle.AspNetCore和https://github.com/mattfrear/Swashbuckle.AspNetCore.Filters

原文地址：https://www.cnblogs.com/cqinwn/p/10918206.html

.NET社區(qū)新聞，深度好文，歡迎訪問公眾號(hào)文章匯總?http://www.csharpkit.com?

總結(jié)

以上是生活随笔為你收集整理的.NET Core 3.0 webapi集成Swagger 5.0的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。