本篇文章為大家展示了.NET Core WebAPI如何集成Swagger做接口管理，內(nèi)容簡明扼要并且容易理解，絕對能使你眼前一亮，通過這篇文章的詳細介紹希望你能有所收獲。

創(chuàng)新互聯(lián)專注于鐵山企業(yè)網(wǎng)站建設(shè),成都響應式網(wǎng)站建設(shè)公司,商城網(wǎng)站制作。鐵山網(wǎng)站建設(shè)公司,為鐵山等地區(qū)提供建站服務。全流程按需定制網(wǎng)站，專業(yè)設(shè)計，全程項目跟蹤，創(chuàng)新互聯(lián)專業(yè)和態(tài)度為您提供的服務

什么是Swagger？
Swagger 是一個規(guī)范且完整的框架，用于生成、描述、調(diào)用和可視化 RESTful 風格的 Web 服務。
Swagger 的目標是對 REST API 定義一個標準且和語言無關(guān)的接口，可以讓人和計算機擁有無須訪問源碼、文檔或網(wǎng)絡流量監(jiān)測就可以發(fā)現(xiàn)和理解服務的能力。當通過 Swagger 進行正確定義，用戶可以理解遠程服務并使用最少實現(xiàn)邏輯與遠程服務進行交互。與為底層編程所實現(xiàn)的接口類似，Swagger 消除了調(diào)用服務時可能會有的猜測。

Swagger 有什么優(yōu)勢？
支持 API 自動生成同步的在線文檔：使用 Swagger 后可以直接通過代碼生成文檔，不再需要自己手動編寫接口文檔了，對程序員來說非常方便，可以節(jié)約寫文檔的時間去學習新技術(shù)。
提供 Web 頁面在線測試 API：光有文檔還不夠，Swagger 生成的文檔還支持在線測試。參數(shù)和格式都定好了，直接在界面上輸入?yún)?shù)對應的值即可在線測試接口。

在.NET Core中如何使用Swagger？
（1）準備工作
創(chuàng)建一個.NET Core WebApi 項目
創(chuàng)建一個Model類庫

（2）在項目中引入Swagger
在WebApi項目中執(zhí)行命令：Install-package Swashbuckle.AspNetCore

（3）在StarUp.cs的ConfigureServices中添加代碼

#region Swagger
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new Info
                {
                    Version = "v1.1.0",
                    Title = "Swagger WebAPI",
                    Description = "XXX項目API文檔",
                    TermsOfService = "None",
                    Contact = new Swashbuckle.AspNetCore.Swagger.Contact { Name = "XXX項目", Email = "273145719@qq.com"
                    , Url = "https://www.cnblogs.com/NBIDataVis/" }
                });
                var basePath = Path.GetDirectoryName(typeof(Program).Assembly.Location);
                //添加接口XML的路徑
                var xmlPath = Path.Combine(basePath, "TrySwaggerCore.xml");
                //如果需要顯示控制器注釋只需將第二個參數(shù)設(shè)置為true
                c.IncludeXmlComments(xmlPath, true);
            });
 #endregion

（4）在StarUp.cs的Configure中添加代碼

#region Swagger
app.UseSwagger();
app.UseSwaggerUI(c =>
{
  c.SwaggerEndpoint("/swagger/v1/swagger.json", "ApiDocument V1");
});
#endregion

（5）運行后進入/swagger目錄 即可查看Swagger已經(jīng)啟用

問題匯總：
（1）如果需要將WebApi的默認啟動頁設(shè)為Swagger則在Properties中

（2）在這里大家會發(fā)現(xiàn)運行后接口的注釋并沒有顯示，我們需要配置注釋XML文件
在WebAPI項目上點擊右鍵-》屬性-》生成-》XML文檔文件

另外切記此處代碼第二個參數(shù)需要設(shè)置為True，否則將不顯示控制器級別的注釋，只顯示接口注釋

（3）如果大家會發(fā)現(xiàn)有了許多警告，強迫癥患者看這里，我們只需要在生成中強制過濾1591的警告即可

上述內(nèi)容就是.NET Core WebAPI如何集成Swagger做接口管理，你們學到知識或技能了嗎？如果還想學到更多技能或者豐富自己的知識儲備，歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。

文章標題：.NETCoreWebAPI如何集成Swagger做接口管理
分享網(wǎng)址：http://aaarwkj.com/article8/pjcjip.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供商城網(wǎng)站、面包屑導航、品牌網(wǎng)站制作、品牌網(wǎng)站建設(shè)、定制開發(fā)、服務器托管

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)