我在開(kāi)發(fā)自己的博客系統(tǒng)(http://daxnet.me)時(shí),給自己的RESTful服務(wù)增加了基于Swagger的API文檔功能。當(dāng)設(shè)置IISExpress的默認(rèn)啟動(dòng)路由到Swagger的API文檔頁(yè)面后,在IISExpress啟動(dòng)Web API站點(diǎn)后,會(huì)自動(dòng)重定向到API文檔頁(yè)面,非常方便。這不僅讓我能夠快速省查API設(shè)計(jì)的合理性,同時(shí)從API的使用角度也為我自己提供了便捷。下圖就是我的博客系統(tǒng)RESTful API的Swagger文檔界面:
接下來(lái),讓我們一起看一下如何在ASP.NET Core Web API上實(shí)現(xiàn)這一基于Swagger的API文檔頁(yè)面。