定时导入

如果你在 Apifox 之外维护 API 定义 （API specification） ，但希望使用 Apifox 进行 API 调试、测试和文档管理，你可以使用定时导入功能。

创建定时导入

前往设置 - 导入数据 - 定时导入

点击 “新建” 来创建一个数据源。

填写必要信息，例如导入频率、数据源的 URL 等。

点击保存。定时导入会根据你设置的导入频率自动执行。

定时导入的工作方式如下：默认情况下，定时导入是从你的 本地客户端 启动的。首先，你的 Apifox 客户端会访问数据源，获取数据后再更新到 Apifox 项目中。

这意味着：

定时导入仅在客户端打开时执行。具体来说，只有当你对项目有写入权限、项目已经在客户端打开，并且距离上一次定时导入的时间超过了你设置的导入频率间隔时，定时导入才会执行。

定时导入可以将内网数据导入到 Apifox，只要你的客户端可以正常访问数据源地址。

因此，如果项目长时间未打开，定时导入将不会生效。下次打开时才会进行更新。

如果你在 Apifox Web 版中打开项目，也会触发定时导入。但在这种情况下可能会有些不同：由于浏览器网络环境的限制，Web 版可能无法访问内网数据。

为了解决上述问题，Apifox 提供了第二种定时导入机制：你可以通过自托管的 Runner 来启动导入，而不是依赖本地客户端。

如果你已经在服务器上部署了 Runner，Runner 将会按照固定的时间间隔自动从数据源导入数据，而不需要考虑客户端是否打开。

了解更多关于自托管 Runner 的信息。

可以选择一个迭代分支定时导入数据，默认选中主分支。如果切换了其他迭代分支，会按照设置规则定时向这个迭代分支中导入数据。导入迭代分支的详情可以参考将 OAS 导入迭代分支模块。

导入频率：设置多久触发一次导入。如果上次导入后的时间超过了该时间段，导入将会被触发。

数据源格式：支持 OpenAPI、ApiDoc 或 Apifox 等格式。

数据源名称：自定义名称，用于区分不同的数据源。

数据源 URL：数据源的 JSON/Yaml 文件 URL，例如：https://petstore.swagger.io/v2/swagger.json

运行位置：选择定时导入的启动位置。默认是本地客户端，你也可以选择已部署的 Runner。

Basic Auth：用于访问加密的 URL。

高级设置：请查看导入设置。

Apifox 支持在单个项目中创建多个数据源，并将数据同步到不同的文件夹中。