1、新しいWEBAPIプロジェクトは、ここで言うことはありません。
に示すように、Swashbuckle.AspNetCore:2、https://www.nuget.org/検索闊歩パッケージで、プロジェクトnuget管理コンソールを開き、
3.安定したバージョンを選択し、実行するプロジェクトnugetパッケージマネージャコンソールをコピーするコマンドをインストールし、インストールを待ちます
インストールが完了した後4、オープンStartup.csファイルには、名前空間を参照します
使用して Swashbuckle.AspNetCore.Swaggerを。
以下のコード処理ConfigureServicesを追加
public void ConfigureServices(IServiceCollection services) { ... services.AddSwaggerGen(options => { options.SwaggerDoc("v1", new Info { Version = "v1", Title = "MsSystem API", Description = "A simple example ASP.NET Core Web API" }); });
... }
在Configure方法中添加代码
public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseMvc(); app.UseSwagger(); app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "MsSystem API V1"); }); }
配置完成;
5、发布一遍该webapi项目到IIS上:
这里注意一个坑,坑了我半天,不然不能访问到swagger.json文件与swaggerui页面出不来,必须将发布目录的文件夹权限打开(允许写入,读取)
6、在浏览器访问swagger.json文件的位置
如:http://localhost:8687/swagger/v1/swagger.json
7、访问swaggerui的接口调试页面
如:http://localhost:8687/swagger/index.html
感谢别人的经验,更多配置可以参考:https://yq.aliyun.com/articles/608901