接口文档是项目开发中必需的说明文档,接口文档编写有许多不同的方法,今天本文简略介绍一下常用的几种接口文档编写方法。

API 文档导入生成

运用接口文档东西 Eolink 演示 API 文档导入生成的过程。 Eolink 体系提供一键导入 Swagger 、 Postman 、 RAP 、 YAPI 等产品数据的功用。完结无负担从其他平台进行数据迁移。

在线生成接口文档

在项目详情页点击左边 API 功用,进入 API 办理页面,直接点击下拉框挑选导入 API 。

在线生成接口文档

在线生成接口文档

装备导入规则:

选项说明:

  • 将 API 导入到以下分组:挑选对应的 API 分组

  • 将新生成的 API 文档状况设置为:能够将导入 API 文档设置对应状况

  • 将产生改变的 API 文档状况设置为:对已产生改变状况的 API 文档,能够更新指定的文档状况

  • 将新生成的或产生改变的 API 文档的版本号设置为:能够将导入 API 文档设置指定的 API 版本号

在线生成接口文档

设置好导入装备规则后,点击确定会显现成功提示, 并在右侧栏显现我的任务队列进行中,当状况显现完结就导入成功了。

如下图:

在线生成接口文档

改写界面就可导入 API 数据:

在线生成接口文档

主动生成文档

经过运用接口文档东西 Eolink 演示如何主动生成文档。

用户能够完结给项目相关的 Swaqger 生成的 JSON 文件地址Eolink 的 API 研发办理平台就能够远程读取 Swagger JSON 文件地址并主动生成 API 文档。

进入 API 办理与测试,挑选项目,左边栏的其他能够看到 API 文档生成。

在线生成接口文档

增加来源,在弹窗中挑选经过 Swagger URL 生成 API 文档 ,然后点击下一步:

在线生成接口文档

输入 Swagger 生成的 JSON 地址,注意该 JSON 地址需求能够经过网络访问,并且该地址返回的数据需求是 JSON 类型的数据,否则会提示无法访问该地址。

在线生成接口文档

装备完结后,界面会提示装备完结。此刻您能够经过当前页面点击 同步 按钮,或经过 Open API 触发同步操作。

在线生成接口文档

运用 API Factory 产品依据数据库生成 API 文档

API Factory( API 快速生成工厂)能够帮助用户直接从各种常见关系数据库、 NoSQL 数据库、大数据库中间件中生成统一格式的 HTTP Restful API 。 经过 API Factory,您能够经过编写 SQL 脚本或经过 UI 方法直接创立一个高性能的数据库操作 API 。

以上三种方法是生成 API 文档最常见的方法,经过运用一款好用的接口文档东西完结 API 文档导入生成、主动生成 API 文档,以及运用 API Factory 产品数据库生成 API 文档,让开发在书写文档过程中不再痛苦,提高前后端的开发效率。

这里引荐上图做演示的这款接口文档东西,Eolink,它能设计、办理 API ,一键生成 API 文档,除此之外还能直接打通接口测试,一键建议 API 测试,方便快捷且功用强大。如有爱好可自行试用:www.eolink.com