執行請求
選擇一個端點,右側會出現執行面板。本頁說明執行面板本身;相鄰的 Assertions 分頁請見斷言與串接。
Request 分頁

- Method + URL 預覽 在最上方:method 徽章與完整展開的 URL(根網址 + path,並以目前啟用環境解析過
{{env.*}}佔位符)。 - 路徑參數 — 每個以
:開頭的路徑片段都有一列。輸入值;它們會即時被代入 URL 預覽中。 - 查詢參數 — 以
?key=value附加。每項都可以開關啟用,無需刪除。 - 標頭 — 可編輯清單。來自環境的認證標頭會以灰階顯示(衍生的,在這裡不可編輯)。
- 內容 — 只有會帶內容的 method 才會顯示。輸入框會以內容型別的
example預填(見型別建構器)。JSON 會即時驗證。
佔位符
{{env.foo}}— 以目前啟用環境中的foo變數取代。適合用在 API key、tenant ID,以及由擷取寫入的值(擷取值會直接存到環境變數)。
佔位符會在送出前解析;URL 預覽會顯示解析後的結果。
送出
點擊 送出(Send)。會套用目前啟用環境的認證預設,發出請求,並自動切到 Response 分頁。
Response 分頁

- 狀態徽章 — 以 class 上色(2xx 綠、4xx 琥珀色、5xx 紅)。
- 延遲 — 從送出到收到第一個 byte 的毫秒數。
- 驗證徽章 — 綠色「Validates」或紅色「Invalid」並顯示不符欄位的數量。點擊會跳到第一個不符處。
- 內容 — 預設以美化過的 JSON 顯示;若 Content-Type 不是 JSON,可切換成 raw 或
text/*呈現方式。 - 標頭 — 完整的回應標頭清單。
- 複製為 cURL(Copy as cURL)— 剛剛這次請求的一行指令(見匯出與 cURL)。
CORS proxy 開關
現代瀏覽器會擋下沒有寬鬆 CORS 標頭的回應。若你的 API 沒有開放 CORS,打開執行面板頂端的 Use proxy 開關並把它指向正在執行的 zwaggen-proxy(預設 http://localhost:8787)。請見 CORS Proxy。
每一次執行都會被記錄
每次成功送出都會落到歷史紀錄中。你可以重新打開一筆舊執行、檢視當時送了什麼以及回收了什麼,然後再送一次同樣的請求。