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