跳到主要内容

在线分享

视频内容

在 API 设计、开发、沟通、协作中,逻辑上应该以团队内共同定义的 API 文档为标准。但实际操作中,团队成员习惯依靠 Word、PDF 格式文件进行 API 文档协作,造成大量信息未能及时同步,将接口以在线形式分享将有助于提高团队之间的沟通效率。

选择接口范围

点击 Apifox 左侧菜单栏的“分享文档”按钮,新建“分享列表”。设置分享对象、分享范围、访问密码、指定运行环境等参数。

不同版本的 Apifox 界面会有所不同。请确保你的 Apifox 更新至 2.6.31 及以上版本,以获取新版 UI。

Apifox 分享分档-选择接口范围

开启整目录分享

在线文档支持开启“整目录分享”。若在选择对应的接口分组时打开了整目录分享功能,则在修改该分组后会自动同步至在线文档。如果并不希望在线文档实时同步您的修改,可以取消勾选此功能。

Apifox 分享分档-整目录分享

设置完成后复制链接,就可以分享给团队成员了。

Apifox 分享分档-分享链接

查看已分享接口

点击分享列表中的“打开链接”按钮,即可查看已分享的在线接口文档。


支持在在线文档中直接发起调试,同时你还可以便捷复制接口 URL、数据接口字段以及返回示例字段。详细调试方法请参考《在文档中进行调试》

Apifox 分享分档-查看已分享接口

分享后的文档配置

可以配置接口目录在在线文档中的展示方式,可选项为普通目录、模块标题、跳转到子目录。

Apifox 分享分档-分享后的文档配置

目录树展示方式为“普通目录”。

Apifox 分享分档-目录树展示方式

目录树展示方式为“模块”,此时处于不可选中状态,该目录下的一级子标题会自动展开。

Apifox 分享分档-模块标题展示方式

目录树展示方式为“跳转到子目录”,此时该目录及其下所有接口会在新一页打开,可返回首页。

Apifox 分享分档-跳转到子目录展示方式

导出在线文档接口

其他用户打开在线文档链接后,点击右下角的“导出”按钮即可选择以 ApifoxOpenAPI(Swagger)HTMLMarkdown 导出当前 API 文档。

Apifox 分享分档-导出在线文档接口

建议 Apifox 用户可以直接选择“克隆”该 API 文档至自己的项目内。

Apifox 分享分档-导出在线文档接口