排程匯入（綁定資料來源）

排程匯入會定期自動將你的 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 請留空。

如需更多匯入選項，請參閱匯入選項。

執行模式

排程匯入需要執行環境來執行擷取命令。請選擇最符合你工作流程的模式：

1. Local Client（預設）

匯入只會在你的 Apidog 桌面應用程式開啟時執行。

需求：你必須以寫入權限開啟該專案。

限制：如果你關閉應用程式或專案，更新會暫停，直到你再次開啟為止。

網路：如果你的電腦可以存取內部網路 URL，則可存取這些 URL。

在 Apidog Web App 中開啟專案也會觸發排程匯入。不過，由於瀏覽器安全性限制，Web App 可能無法存取內部網路 URL。

2. Self-hosted Runner

匯入會在你已部署 Apidog Runner 的伺服器上執行。

優點：無論你是否在線上，都能 24/7 執行。

使用情境：最適合需要穩定更新且不需手動介入的團隊。

深入了解如何部署 Self-hosted Runner。

進階：匯入至 Sprint 分支

你可以指定特定 sprint 分支作為匯入目標。預設情況下，資料會匯入至 Main Branch。

如需詳細工作流程，請參閱將資料匯入 sprint 分支。

排程匯入（綁定資料來源）

如何設定#

綁定 Git 儲存庫#

組態參考#

執行模式#

1. Local Client（預設）#

2. Self-hosted Runner#

進階：匯入至 Sprint 分支#

如何設定

綁定 Git 儲存庫

組態參考

執行模式

1. Local Client（預設）

2. Self-hosted Runner

進階：匯入至 Sprint 分支