+-
API文档自动生成的方法

编写API文档是API编写人员的噩梦,而API文档通常是由API研发人员编写。由于API文档创建繁琐,需要记录的内容比较广,结束了API开发任务后,还要仔细编写API文档,给研发人员带来额外的工作量。

随着需求量越来越高,工具的诞生让API的研发与API文档之间的联系更加紧密。例如:Swagger、Eolinker、APIdoc、Easydoc等,这些API文档管理工具不仅可以生成漂亮的在线API文档,并且支持集成到项目自动生成API文档。

以Eolinker为例,Eolinker为用户提供了该工具的OpenAPI,方便用户集成到开发系统。在每个API开发完成后,快速调用OpenAPI并自动生成API文档。

当然OpenAPI不仅仅是自动新增API文档那么简单,Eolinker还提供了能快速对系统进行操作的OpenAPI,可集成到Jenkins等集成工具。有了这些OpenAPI,用户可以利用它们让整个开发流程更加”顺滑”,例如当开发完成触发OpenAPI进行测试等。

OpenAPI只是其中一个实现方式,一些工具则通过配置文件使用依赖的方式集成到开发系统。例如Swagger2就是以这种方式生成的API文档,并且Swagger2生成API的界面同样漂亮、简洁。

团队可以根据项目需求去挑选合适的API文档工具,若仅对API文档有需求,本文提及的四个工具(Swagger、Eolinker、APIdoc、Easydoc)都是不错的选择。如果考虑到项目需要优化整个API开发流程,并使用工具进行集成,可以选择一些功能强大,且容易集成到项目的API管理工具(Eolinker、APIdoc等)。
演示工具:www.eolinker.com