偵錯 API
Apidog 如何與第三方金鑰管理系統整合？
我們正在開發與 Azure Key Vault、HashiCorp Vault 和 AWS Secrets Manager 的整合，預計將於 2024 年 12 月發布。
為什麼相同的請求在其他工具（例如 Postman）中可以正常運作，但在 Apidog 中卻不行？
如果請求完全相同，那麼無論使用哪個工具，回應也應該相同。如果你得到不同的回應，可以切換到「實際請求」分頁，並與你在其他工具中傳送的請求進行比較，以找出差異。
如何在 Apidog 中從資料庫取得變數值？
Apidog 提供一項獨特功能：連接到資料庫以擷取資料，將其設定為變數，並在請求中使用。以下是步驟：
在 **Run** 分頁（DESIGN 模式）或 **Request** 分頁（DEBUG 模式）中，前往 Post Processors。
將滑鼠懸停在「Add...
如何將環境從其他工具遷移到 Apidog？
在 Apidog 中，變數的 Initial value 會在團隊內同步，而 Current value 只會儲存在本機。這表示當你在另一台電腦上使用 Apidog 時，將無法存取先前使用的 Current value。
因此，Apidog 提供了遷移環境的功能。你可以將環境中的服務與變數匯出為 J...
如何在 Apidog 中使用腳本進行斷言？
在 Apidog 中，你可以使用 pm.test 語法透過腳本建立斷言。Apidog 與 Postman 腳本相容，讓使用者能夠順暢地運用既有腳本。
:::highlight purple深入了解腳本。:::
JSONPath 只能擷取陣列。如何在 Apidog 中從陣列內擷取單一元素？
JSON 是最常用的回應資料格式，而 JSONPath 是在 JSON 結構中進行資料擷取時廣泛使用的語法。Apidog 提供視覺化的 JSONPath 擷取工具，以簡化撰寫 JSONPath 表達式的流程。以下是如何有效使用此工具的指南：
點擊位於 JSONPath 輸入框右側的 圖示。...
當不同環境有不同的資料庫帳號憑證時，如何在 Apidog 中設定資料庫操作？
使用多個環境（例如測試環境與生產環境）時，通常會設定不同的資料庫。如果你在工作流程中使用資料庫操作，這表示這些操作需要隨著環境切換而切換。
在這類情境中，你可以在 Apidog 的「Database Connections」設定中設定多個資料庫連線。透過為每個環境設定資料庫連線，你可以確保當使用右上...
如何在自訂腳本中取得服務基礎 URL？
Apidog 提供 pm.request.getBaseUrl() 來擷取目前端點的基礎 URL。
建議使用此方法，而不是 pm.environment.get('BASE_URL')，因為如果端點未使用預設伺服器，後者可能不會回傳正確的基礎 URL。
如需服務和基礎 URL 的更多...
當 API 回應過大 時，為什麼 Apidog 會回報超過 Node.js 字串長度上限的錯誤？
當處理過大的 API 回應時，Apidog 的前端可能會遇到與 Node.js 字串長度限制相關的問題。Node.js 使用 V8 引擎，而 V8 對單一字串的長度有限制，通常約為 337MB。當回應大小超過此限制時，可能會導致記憶體不足或字串處理錯誤，進而使 Apidog 回報已超過 Node.j...
控制台列印的大小限制是多少？為什麼列印大型檔案時會出現錯誤？
Apidog 的控制台列印大小限制為 1024 * 1024 位元組（1MB）。這是 Node.js 的限制，目前 Apidog 不支援設定此限制。如果列印的檔案內容超過此限制，就會發生錯誤。
如何解決 Windows 上的 DB2 資料庫連線錯誤？
如果你在 Apidog 中連線到 DB2 資料庫時遇到錯誤 Error: The specified module could not be found.，通常是因為缺少環境變數。你可以透 過設定以下環境變數來解決此問題：
設定 PATH 環境變數：將 <Apidog Installation...
為什麼我在 Apidog 中連線到 Oracle 資料庫時會出現 NJS-045 錯誤？
「NJS-045: cannot load a node-oracledb binary for Node.js 18.18.2 (darwin arm64)」
此問題是因為 Oracle 目前對 ARM64 架構存在相容性限制。因此，oracledb 驅動程式目前不支援 ARM64。
如何在 Apidog 自訂腳本中產生動態值？
PM Script API Apidog 支援在自訂腳本中產生動態值，使用 pm.variables.replaceInAsync(variableName:String):function 方法，將字串中的「動態值表達式」替換為實際值。此函式會回傳 Promise，因此呼叫時必須加上 await。...
為什麼用戶端請求相同端點時成功，但在網頁端除錯時卻發生「無法請求地址」錯誤？
在線上文件或網頁除錯期間無法請求地址？
當你嘗試在 Apidog 分享的文件中除錯端點時，出現「無法請求地址」錯誤，可能原因如下：
瀏覽器憑證問題：如果你的請求是 HTTPS，端點可能會在請求期間重新導向到連接埠 443。由於用戶端可以設定為忽略憑證錯誤，因此可以正常存取；然而，瀏覽器對憑證管理較...
為什麼當回應過大時 Apidog 會回報錯誤？
Apidog 的前端在處理過大的介面回應時，可能會遇到與 Node.js 字串長度限制相關的問題。Node.js 使用 V8 引擎，而 V8 對單一字串的長度有限制，通常約為 337MB。當回應大小超過此限制時，可能會導致記憶體不足或字串處理錯誤。
如何使用 Apidog 錄製端點？
Apidog 目前尚不支援自動錄製端點功能，但未來有計劃支援此功能。
目前有一個快速錄製的方法：在瀏覽器中測試端點時開啟 DevTools。操作完成後，按一下右鍵匯出 HAR 檔案，並一鍵匯入到 Apidog。建立一個測試場景，並匯入所有請求，以便隨時重播。如需了解如何匯入 HAR 檔案的詳細資訊，...
定義端點回應時，是否允許端點沒有回應內容？
若不便升級到最新版本，端點定義支援將回應的內容格式設定為 No-Content，這表示沒有回應主體。
如何在自訂腳本中取得服務 baseURL？
Apidog 提供 pm.request.getBaseUrl() 方法來取得目前端點的 baseURL。
建議使用上述方法，而不是 pm.environment.get('BASE_URL')，因為如果端點未使用預設服務，後者可能無法回傳正確的 baseURL。
此外，你可以透過 ...
如何在 Apidog 中查看原始封包？
Apidog 不需要列印到主控台，回傳訊息中有一個「Actual Request」分頁，你可以直接在此分頁中查看原始請求封包。
![圖片.png](https://api.apidog.com/api/v1/projects/544525/resources/352515/image-previe...
為什麼我在發送請求時會看到「Invalid URI xxx」錯誤？
檢查端點是否連結到 Base URL 為空的服務。
如果你正在使用繼承（例如父資料夾），請確保父資料夾和根資料夾的 Base URL 都已正確設定（也就是不為空）。你可以閱讀 環境與變數
確認 Base URL 是否使用變數定義。
如果 Base URL 使用了變數，請確保對應的全域變數或環境變...
如何在 Apidog 腳本中發出非同步請求？
Apidog 支援在自訂腳本中使用 pm.sendRequest 函式 來發起非同步請求。如需詳細資訊，請參閱 Apidog Postman 腳本參考。
為什麼我在傳送請求時會看到「Couldn't resolve host」訊息？
需要檢查端點的 Base URL 是否缺少「/」。
如果 API 的 URL 包含環境變數，請檢查該變數的值是否不正確。
主控台列印大小限制是多少？為什麼列印大型檔案時會出現錯誤？
Apigog 的主控台列印大小 限制為 1024 * 1024 位元組（1MB）。這是 Node.js 的限制，目前 Apidog 不支援修改此限制的設定。如果列印檔案的內容太大並超過此限制，就會回報錯誤。
如何在端點請求中上傳檔案？
如果你需要為 API 請求上傳檔案，需要將請求主體切換為 form-data 格式，並將對應欄位設定為 file 類型，接著就可以上傳檔案。
如果 Apidog 當機或未顯示回應資料該怎麼辦？
發生了什麼事？
這種情況非常少見，但你可能偶爾會遇到 Apidog 當機；重新開啟後，你的 API 呼叫回應資料可能不會顯示。取而代之的是，你可能會看到載入動畫，接著出現一則訊息：「*Click Send to get a response.*」我們知道這可能會讓人感到困擾，我們會協助你讓一切再次順...
Apidog 用於 OAuth2.0 的官方重新導向 URI
Q：Apidog 用於 OAuth2.0 驗證的官方重新導向 URI 是什麼？
A：在 Apidog 中為你的 API 設定 OAuth2.0 驗證時，你可能需要在授權伺服器或用戶端設定中註冊官方重新導向 URI。這可確保 OAuth 流程能夠順利完成，並讓 Apidog 在授權後接收存取權杖。
✅...