温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

在Web API程序中如何使用Swagger做接口文档

发布时间:2021-11-30 16:54:44 来源:亿速云 阅读:154 作者:小新 栏目:编程语言

这篇文章主要介绍了在Web API程序中如何使用Swagger做接口文档,具有一定借鉴价值,感兴趣的朋友可以参考下,希望大家阅读完这篇文章之后大有收获,下面让小编带着大家一起了解一下。

创建Web API程序

在VS2019中创建一个ASP.NET Web应用程序,选择Web API来创建RESTful的HTTP服务项目,构选MVC和Web API核心引用。

安装Swashbuckle

使用NuGet包管理器,查找安装Swashbuckle,也就是Swagger插件。

配置SwaggerConfig

在APP_START里找到SwaggerConfig,大概在105行左右有对c.IncludeXmlComments的注释,在此处添加配置:

c.IncludeXmlComments(GetXmlCommentsPath(thisAssembly.GetName().Name));

在SwaggerConfig的最后,给类添加方法:

protected static string GetXmlCommentsPath(string name)
{
    return string.Format(@"{0}\bin\{1}.xml", System.AppDomain.CurrentDomain.BaseDirectory, name);
}
维护接口方法的Summary

维护好controller路径中各个控制器接口方法的summary注释。

生成项目的XML文档文件

在API项目的生成设置里,构选生成XML文档文件。

编译并运行程序

编译、运行程序,在打开的Web地址后加上swagger,可以看到自动生成的接口文档和summary信息,可对接口进行测试。

在Web API程序中如何使用Swagger做接口文档

感谢你能够认真阅读完这篇文章,希望小编分享的“在Web API程序中如何使用Swagger做接口文档”这篇文章对大家有帮助,同时也希望大家多多支持亿速云,关注亿速云行业资讯频道,更多相关知识等着你来学习!

向AI问一下细节

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

AI