跳到主要内容

导出接口

Apifox 支持以 OpenAPI (原 Swagger)、HTML、Markdown、Apifox 等数据格式导出接口。

导出数据​

打开“项目设置”面板，点击左侧菜单栏中的“导出数据”选项，选择需要导出的数据格式，点击“导出”按钮即可。

支持导出全部接口或手动圈选接口。

你也可以根据标签导出对应的接口。

其中 OpenAPI (Swagger) 支持导出 3.1、3.0、2.0 版本；导出离线版本以及 RAW 格式链接。

点击“打开 URL”即可在浏览器中查看 RAW 格式内容。

OperationID​

OperationId 是 OpenAPI 规范中用于唯一标识 API 操作（Operation）的字符串。支持设置 OperationId 属性，导出 OpenAPI 格式时会将此处的值导出到 Operation 对象的 OperationId 里。

截屏 2022-01-14 下午 8.45.12

常见问题​

1. 导出 Markdown、HTML 格式时接口顺序为什么乱了？​

  1. Swagger 规范里是没有顺序的概念的，也没有分组的概念，规范本身不支持，所以导出 Swagger 格式是错乱的。
  2. 若需要严格规范顺序，建议选择 Apifox 格式导出。

2. 存在多个同 URL 接口，导出的接口数量为什么变少了？​

  1. 请检查是否有多个接口都是使用相同的方法和路径。
  2. OpenAPI 规范不支持不同接口使用相同方法和路径。若存在多个接口使用相同方法和路径的情况，请查看《接口唯一标识》。
  3. 目前导出HTML、Markdown是通过 OpenAPI 数据转译的。同样存在问题。

3. 如何导出 PDF 格式文件？​

目前不支持直接导出 PDF、Word 等其他格式数据，但你可以先导出 Markdown 数据格式，然后再使用外部工具转换为需要的格式。