自動化測試
為什麼測試情境在我的本機用戶端執行時沒有問題，但在 Apidog CLI 或 runner 中執行時會發生錯誤？
最常見的問題與變數的使用有關。
在 Apidog 本機用戶端中執行時，會使用儲存在你用戶端中的變數「目前值」，且不會同步到伺服器。然而，在 CLI 或 runner 中執行時，會使用儲存在伺服器上的「初始值」。
為了確保在本機和遠端都 能順利運作，你需要正確設定初始值和目前值，並保持兩者一致。
: function → Boolean: 檢查測試變數是否存在。pm.iterationData.get(variableName:String): function → ...
如何在 Apidog 中批次執行測試情境？
Apidog 支援批次執行多個已設定的測試情境。
在「測試」模組中，點選左側資料夾樹中的資料夾，右側面板會顯示該資料夾內所有測試情境的列表。在此列表中，你可以查看每個測試情境的資訊，例如環境和最近一次執行結果。
你可以選取多個測試情境，然後點選右上角的「批次執行」按鈕，以批次執行這些...
如何在 Apidog 中排程測試任務？
你可以設定「排程任務」，在指定時間自動執行已設定的自動化測試情境，取得任務執行結果，並滿足定期測試與迴歸測試的需求。
:::tip[]
排程任務目前處於 Beta 階段。
若要執行排程任務，你需要先設定 self-hosted Runner。
你可以執行排程任務的次數取決於你訂閱的方案。你可以在 ...
如何在 Apidog 中執行效能測試？
:::tip[]效能測試功能目前處於 Beta 階段。:::
效能測試會向 API 傳送大規模服務請求，以識別效能瓶頸、評估穩定性、揭露壓力下的潛在風險，並確保 API 能在高負載下可靠運作並回應請求。
設定配置項目
在執行效能測試之前，你需要指定測試場景的執行環境，並可選擇性地指定測試資料，以及...
如何在效能測試中查看實際的請求與回應？
Apidog 的效能測試不提供查看實際請求與回應的能力。
這是因為效能測試著重於評估 API 在高負載下的行為，而這些 API 應該已經 100% 通過功能測試。任何問題很可能是由伺服器效能造成，而不是請求/回應內容造成。
因此，查看實際的請求與回應無助於排查效能相關問題。因此，Apidog 的效能...
如何在 Apidog 中匯出效能測試報告？
效能測試目前仍處於 beta 階段，Apidog 尚未支援匯出效能測試報告。你只能在 Apidog 用戶端內檢視結果。
如何使用資料庫查詢結果作為循環 API 請求的參數？
Apidog 支援使用資料庫查詢結果作為參數，以循環執行 API 請求。你可以依照以下步驟操作：
在你的測試場景中，新增一個「資料庫操作」步驟。執行你的 SQL 查詢，並將結果提取到一個變數中（例如 `id`）。請確保你的 SQL 查詢回傳陣列格式的結果。
![](https:...
在 CI/CD 期間於 ApiDog 中擷取並驗證 Stripe Webhook
問：ApiDog 是否支援直接監聽 Stripe Webhook？不支援，ApiDog 原生不支援監聽 Webhook。不過，你仍然可以透過後端與資料庫來驗證 Webhook 事件。
問：使用 ApiDog 測試 Stripe Webhook 的建議方法是什麼？你可以依照以下步驟進行：
在後端設定...
如何解決「Error: unable to verify the first certificate on runner」錯誤？
執行 Apidog 的 Runner 時，如果遇到「Error: unable to verify the first certificate on runner」錯誤，通常是因為 Runner 無法驗證伺服器的 SSL 憑證。這可能是由於伺服器使用自簽憑證，或憑證鏈中的某個憑證不受信任所導致。
你...
General Runner Docker 容器「Not Found」錯誤。
Q: 問題是什麼？A: 當使用者依照 Apidog 文件（https://docs.apidog.com/general-runner-755233m0）嘗試執行 General Runner Docker 容器時，會遇到「Not Found」錯誤。此錯誤發生在 runner 嘗試連線至端點：htt...
如何在 Apidog Web 版中設定 General Runner 的伺服器主機？
由於瀏覽器安全性限制，Web 版無法從 HTTPS 頁面存取不安全的 HTTP。因此，在 Web 版中設定 General Runner 的伺服器主機可能會失敗。
請改在 Apidog client 中進行設定。
為什麼排程測試情境最後顯示 0 個請求？
Q: 為什麼我的排程測試情境最後顯示 0 個請求？
A: 沒有任何請求通過排程任務，因為為排程執行所設定的環境被設為「Private」。在 Apidog 中，當環境為 private 時，排程測試可能無法存取所需的變數，導致請求失敗。
Q: 我該如何修正這個問題？
A: 若要解決此問題，請在 Api...
如果在 Runner 或 CLI 中找不到檔案上傳參數，我該怎麼辦？
Apidog 只會儲存本機檔案路徑，而不是檔案本身。因此，當在不同機器上使用 Runner 或 CLI 執行測試時，可能會遇到找不到檔案的錯誤。
若要解決此問題：
將檔案上傳到執行測試情境的 Runner/CLI 機器。
在 Apidog 中，開啟對應的測試步驟，並使用「批次編輯」將檔案路徑參數值...
如何使用 Runner 執行包含上傳檔案步驟的測試場景？
在 Apidog 中，端點請求內的檔案參數實際上只會儲存檔案路徑（而不是檔案本身）。傳送請求時，Apidog 會根據檔案路徑尋找實際檔案，然後再傳送。因此，你需要確保：
將檔案複製到掛載至 Runner volume 的主機目錄。Runner 的 volume 是你在[部署 Runn...
如何解決「Error: unable to verify the first certificate on runner」錯誤？
如果你在使用 Apidog 執行 Runner 時遇到「Error: unable to verify the first certificate on runner」錯誤，通常是因為 Runner 無法驗證伺服器的 SSL 憑證。這可能是由於伺服器使用自簽憑證，或憑證鏈中包含不受信任的憑證所導致。...
當 Runner 發生問題時，如何存取並搜尋 Runner 日誌以識別問題？
使用 the docker ps 命令尋找有問題的 Runner 資訊；
根據 Runner 容器 ID，執行以下命令查詢有效日誌
# View the last 100 lines of the log for container ID abc123, recommended:
docke...
如果端點參數是上傳檔案，且在 Runner 或 CLI 中找不到，該怎麼辦？
Apidog 只會儲存檔案的本機路徑，而不會儲存檔案本身。因此，當在不同機器上使用 Runner 或 CLI 執行測試時，可能會出現找不到檔案的錯誤。
解決方案：
將檔案上傳到執行測試情境的伺服器
在 Apidog 中開啟對應的測試步驟，透過參數的批次操作，將檔案路徑參數替換為該機器上的實際路徑...
為什麼當 API 使用案例變更時，測試步驟不會自動同步？
如果步驟是從端點使用案例匯入，並選擇如何 copy當端點的使用案例變更時，步驟不會變更，兩者之間沒有關聯。
如果步驟是從端點使用案例匯入，並選擇「Reference」方法端 點使用案例中的任何變更都會同步到測試步驟內容，反之，步驟變更也會同步到端點使用案例。
因此，如果你需要測試步驟與端點使用...
為什麼在 Markdown 文件中使用多個美元符號會導致部分內容無法正確顯示？
Apidog 使用的 Markdown 編輯器會將 $xxxxx$ 解析為數學公式。如果你的內容不是數學公式，但包含多個 $，可能會解析失敗並無法正確顯示。為避免這種情況，可以採用以下方法：
方法 1. 使用行內程式碼區塊
將程式碼內容包含在反引號中，例如
原始內容
...
自架 Runner 執行任務後，是否會在伺服器上產生測試報告？
測試報告不會儲存在 Runner 本機，請在用戶端中查看。
我可以為測試情境中的請求新增統一的前置／後置處理器嗎？
可以，Apidog 支援為測試情境設定統一的前置／後置處理器。啟用後，情境內的所有請求在情境執行時，都會自動執行相同的前置／後置處理器。
若要啟用此功能：
前往專案設定。
![img_v3_02mu_2a6d3e2f-8a5b-407c-a0f9-94a28dc692fg.png](htt...
如何在單次自動化測試執行期間保持動態值一致？
動態表達式（例如 {{$person.fullName}}）每次被呼叫時都會產生新的值。如果你在測試流程中多次將這類表達式直接指派給變數，可能會導致各步驟之間的資料不一致。
建議做法：
先產生一次動態值，將其儲存在變數中，然後在整個測試中引用該變數。變數在被指派時只會被求值一次，確保整個測試執行期間...