如何使用 Eolink 实现 API 文档自动生成

「本文关于如何使用 Eolink 实现 API 文档自动生成。」

API 文档的编写让很多 API 编写人员感到头疼，自动生成 API 文档就能帮助我们省心省力地完成任务。

所以今天我们来通过 Eolink 来演示如何通过 API 管理工具实现 API 文档自动生成。

Eolink 是一款转为开发者设计的 API 协作平台，通过 API 研发管理平台能够实现规范管理、测试所有 API ，自动生成 API 文档，统一管理 API 相关数据，帮助团队内部共享工作成果等多种功能。

从 Swagger URL 中扫描 API 文档

用户可以给项目关联 Swagger 生成的 JSON 文件地址，Eolink 的 API 研发管理能够远程读取 Swagger JSON 并自动生成 API 文档。

进入 API 管理与测试，选择项目，点击左侧栏的其他可以看到 API 文档生成。

点击添加来源，在弹窗中选择通过 Swagger URL 生成 API 文档，然后点击下一步：

输入 Swagger 生成的 JSON 地址。

这里需要注意的是，该 JSON 地址需要能够通过网络访问，并且该地址返回的数据需要是 JSON 类型的数据，否则就会提示无法访问。

配置完成后，界面会提示配置完成。此时您可以通过在当前页面页点击 同步 按钮，或者通过 Open API 触发同步操作。

从代码仓库中扫描 API 文档

用户可以给项目关联代码仓库，API 研发管理平台 能够远程读取仓库中的代码注解并自动生成 API 文档，能够识别 Swagger 2.0 的代码注解格式。

目前支持的仓库类型有：Github、Gitlab、码云。

进入项目页，点击其他，再点击 API 文档生成添加来源 ，在弹窗中设置需要扫码的代码仓库，点击立即同步即可。

GitHub

其中 Github 代码仓库的信息说明如下图：

Gitlab

Gitlab 代码仓库使用信息如下图：

码云

码云代码仓库使用信息如下图：

可以根据 不同需求自行选择三种不同类型的代码仓库，远程读取仓库中的代码注解并自动生成 API 文档，不再需要编写人员手写文档。

我们可以看到，无论是从 Swagger URL 中扫描 API 文档，还是从代码仓库中读取代码注释直接生成 API 文档，使用 Eolink 的 API 研发管理平台是一个十分不错的选择，简单快捷且功能强大，减轻大部分不必要的工作量。

「上述就是小编为大家整理的如何使用 Eolink 实现 API 文档自动生成。」

「国内(北京、上海、广州、深圳、成都、重庆、杭州、西安、武汉、苏州、郑州、南京、天津、长沙、东莞、宁波、佛山、合肥、青岛)Eolink软件分析、比较及推荐」

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。