定时导入（绑定数据源）

定时导入会按固定间隔自动将你的 API 规范从外部来源同步到 Apidog。此功能非常适合在外部系统（如 Git 仓库或 Swagger 端点）中维护 API 规范，但又希望利用 Apidog 强大的调试和测试能力、且无需手动重新导入的团队。

通过定时导入，你可以：

为你的 API 规范维护单一事实来源，并将其保存在你偏好的版本控制系统中

自动同步变更，并支持自定义间隔（每 30 分钟、每小时、每天等）

从多个来源导入，包括 GitHub、GitLab、Azure DevOps 和直接 URL

让团队保持一致，无需手动干预即可获取最新的 API 变更

如何配置

导航到设置

前往 Settings -> Import Data -> Scheduled Import (Bind Data Sources)。

创建数据源

点击“New”以添加配置。

配置设置

填写数据源详细信息（URL、频率等）。有关绑定 git 仓库的详细信息，请参阅下一节。

保存并启用

点击 Save。导入现在将根据你的频率设置自动运行。

Apidog 支持在单个项目中创建多个数据源，每个数据源可同步并导入到不同的文件夹中。

绑定 Git 仓库

Apidog 支持绑定来自以下平台的 git 仓库：

Github

GitLab 和

Azure DevOps

要绑定 git 仓库，请按照以下步骤操作。

在 Bind Data Sources 对话框中选择 Git Repository 选项，并创建仓库连接。

选择你偏好的版本控制平台后，按照说明授予 Apidog 访问你的仓库的权限。

当你被重定向回 Apidog 后，选择你的 Organization 和 Repository，然后点击 Save。

最后，选择 Branch 和 OpenAPI Spec 文件，并完成绑定流程。

配置参考

设置	描述
导入频率	Apidog 从你的数据源检查并导入更新的频率。选项包括每 30 分钟、每小时、每天或自定义间隔。
源格式	你的 API 文件的规范格式。支持的格式：`OpenAPI`（Swagger）、`ApiDoc` 或 `Apidog` 原生格式。
源 URL	指向你的 API 规范文件的直接 HTTP(S) 链接。示例：`https://petstore.swagger.io/v2/swagger.json`。必须可公开访问，或受 Basic Auth 保护。
运行于	导入任务的执行环境。选择 `Local Client`（在你的应用打开时运行）或 `Runner`（在自托管服务器上 24/7 运行）。
Basic auth	如果你的源 URL 受 HTTP Basic Authentication 保护，则填写用户名和密码凭据。公开 URL 可留空。

如需更多导入选项，请参阅导入选项。

执行模式

定时导入需要一个执行环境来运行 fetch 命令。请选择最适合你工作流的模式：

1. 本地客户端（默认）

导入仅在你的 Apidog 桌面应用打开时运行。

要求：你必须打开该项目，并具有写入权限。

限制：如果你关闭应用或项目，更新将暂停，直到你再次打开它。

网络：如果你的计算机可以访问内部网络 URL，则也可以访问这些 URL。

在 Apidog Web App 中打开项目也会触发定时导入。但是，由于浏览器安全限制，Web App 可能无法访问内部网络 URL。

2. 自托管 Runner

导入会在你已部署 Apidog Runner 的服务器上运行。

优势：无论你是否在线，都可 24/7 运行。

使用场景：最适合需要持续更新且无需手动干预的团队。

了解有关部署自托管 Runner 的更多信息。

高级：导入到迭代分支

你可以为导入指定特定的迭代分支。默认情况下，数据会导入到主分支。

有关详细工作流，请参阅将数据导入迭代分支。

定时导入（绑定数据源）

如何配置#

绑定 Git 仓库#

配置参考#

执行模式#

1. 本地客户端（默认）#

2. 自托管 Runner#

高级：导入到迭代分支#

如何配置

绑定 Git 仓库

配置参考

执行模式

1. 本地客户端（默认）

2. 自托管 Runner

高级：导入到迭代分支