最近在实现一个自己的APP,接口是用.net core 写的,就想着用Swagger来展示和调试接口,查了很久,网上的文章也没能解决问题。
最后去看了官方文档,步骤整理到这里(英文原文地址):
第一步:安装第三方包依赖
PowerShell Install-Package Swashbuckle.AspNetCore
注:我看网上好多教程还要安装其他第三方库依赖,但其实不需要,根据官方文档只需要安装这一个就OK
第二步:在中间件注册swagger(Startup.cs)
第三步:运行程序查看json配置文件
打开 http://localhost:<random_port>/swagger/v1/swagger.json
就可以看到详细的json格式的描述文档
第四步:查看API接口描述
打开 http://localhost:<random_port>/swagger
就可以看到swagger的UI界面了,在里面就可以调试和查看接口啦