傳送請求

點擊端點 Run 分頁中的 Send 以傳送請求。

端點中的 Run 介面與 Request 介面非常相似。主要差異在於 Run 是基於端點，它可以根據端點規格產生請求並驗證回應。當端點規格變更時，Run 介面也會相應更新。另一方面，Requests 是獨立的，與 API 規格無關。

當你傳送請求時，Apidog 會以便於檢查、視覺化和疑難排解的方式，顯示從 API 伺服器收到的回應。

此介面分為兩個區塊：上半部是你輸入要傳送請求的地方，下半部則顯示你實際傳送的請求、收到的回應，以及該回應的驗證與斷言結果。

TIP

你可以將游標懸停在右下角的 partition 按鈕上，以調整 Run 介面的版面配置。你可以選擇水平分割、垂直分割或不分割介面。

在上半部區塊中，你可以使用變數、動態值、腳本等來調整你傳送的請求。如何查看實際傳送的請求？你可以在下半部的 Actual Request 分頁中看到完整的實際請求。

Apidog 會根據端點規格，自動驗證回應是否符合 schema。你可以選擇啟用或停用驗證，也可以選擇要根據哪個回應進行驗證。

TIP

深入了解驗證回應。

Apidog 支援將回應擷取到端點規格中，可擷取為 response schema 或 response examples。

修改請求

你可以在 Run 分頁中修改請求。你可以變更參數值，或切換參數前方的核取方塊來更改請求。這些操作不會與端點規格衝突。

有時候，你可能需要修改參數類型或新增／移除參數。在這種情況下，請求會偏離端點規格。在 Apidog 中，這些不一致之處會以橘色標示。

將游標懸停在這些橘色標記上，會顯示規格與目前請求之間的差異。你可以點擊 Revert 將其還原為符合規格的狀態，或點擊 Save to endpoint spec 來更新規格。你也可以點擊右上角的 Inconsistent 按鈕，批次還原或將所有差異儲存到端點規格。

在 Run 分頁中沒有 Save 按鈕。這是因為對於端點規格來說，它並不包含請求的內容。

為了方便偵錯，Apidog 提供了 Stash 按鈕。點擊 Stash 會儲存 Run 介面中的目前內容，而不影響端點規格，且該內容不會與其他人同步。

如果你希望永久儲存請求，可以點擊 Save as case。此請求將以端點案例的形式，儲存在端點的層級結構下。

你可以將此端點的每個使用情境儲存為端點案例，方便開發人員偵錯，並提供一種簡便方式將其作為步驟匯入自動化測試。

TIP

深入了解偵錯案例。

TIP

匯入 Postman Collection 時，每個 Postman 請求都會對應到 Apidog 中的一個端點案例。因此，它們會在端點層級結構下顯示為 success 案例，而不是位於端點規格內。
深入了解從 Postman 遷移。

Q: 為什麼同一個請求在其他工具（例如 Postman）中可以正常運作，但在 Apidog 中卻不行？

A: 如果請求完全相同，那麼無論使用哪個工具，回應也應該相同。如果你得到不同的回應，可以切換到 Actual Request 分頁，並與你在其他工具中傳送的請求進行比較，以找出任何差異。