nodej自动生成接口文档
为了提高服务端开发效率,考虑如何自动生成接口文档。可以编写注释方式,代替使用工具自动生成接口文档,
好处:防止我们自己写markdown文件丢失。随时可以生成
管理接口平台
- apifox
- eoLinker
- swigger
- showdoc
- apidoc
每个平台都有自己自动生成接口文档的注释语法
- apifox 支持 swigger 的方式
- apidoc的语法对node.js更加友好,学习成本低
- eoLinker 支持 swigger apidoc 等
目前各大公司都在网 apifox 迁移;推荐使用swigger注释语法
弊端:学习成本高
如梦学习自己百度语法就可以了
swigger
eolink
apidoc官网
apidoc参考