主要是利用attribute标注要产生API文档的Action,通过动态加载程序集反射获取公开的函数,并获取attribute 中的文档注释。 本API文档工具可实现简单的在线模拟请求,美化返回的json数据对象。支持通用的GET以及POST请求, 支持简单对象的POST请求,同样也支持简单文件上传。其实一开始是想造一个基于.net core版本的API 文档工具,但是为了兼容公司老项目(mvc3,framework 4.0),按照这个思路可以很轻松的修改此工具为.net core版本,大家可根据自己实际需要改造此API文档工具。
下载项目使用VS打开,还原nuget包,在webconfig文件中添加公开API dll文件目录。 在你的项目中添加对工程ApiView.OpenApi的引用,使用特性标注需要文档描述的action!
关于接口调用参数Authorization使用方法,该参数是可选参数,可根据项目实际情况使用。 模拟请求时,会将值添加到Header中发送。 可根据实际项目需求使用此参数实现HTTP协议基本认证。
将发布后的dll文件重新复制到设置的dll目录下(需要暂停当前IIS站点目录才能复制,因为是通过 启动站点后通过 Assembly.LoadFrom("dll路径") 动态加载的程序集至应用程序域中,会一直占用当前目录下的dll文件。所以需要关闭当前 IIS站点才能复制,对于此种情况暂未想出什么好的解决办法)。
由于作者能力有限,本API文档工具暂时不支持多重嵌套的复杂引用类型参数,只能暂时通过手动拼写json数据测试模拟请求。 如果你觉得好用,请点个star。