此詞彙表定義了 Dev Proxy 文件中所使用的術語。
A
API 模擬器
一個能模擬 API 行為而不連接真實 API 伺服器的工具。 Dev Proxy 是一個 API 模擬器,可以模擬回應、模擬錯誤並注入延遲。
C
混沌測試
一種測試方法,故意在系統中引入故障,以驗證其能否應對意外狀況。 Dev Proxy 透過模擬隨機 API 錯誤與失敗,實現混沌測試。
組態檔
定義 Dev Proxy 行為的 JSON 檔案devproxyrc.json(),包括要監控哪些 URL、啟用哪些外掛,以及外掛專屬設定。 請參見「設定開發代理」。
E
誤差模擬
故意讓 API 呼叫失敗的做法,是為了測試應用程式如何處理失敗。 Dev Proxy 透過回傳 HTTP 錯誤回應來模擬錯誤,而非將請求轉發到真實 API。
I
Intercept
當開發代理在 HTTP/HTTPS 請求到達目的地前擷取它時, 攔截的請求可以被傳遞給 API、修改或以模擬回應取代。
L
延遲
從發送請求到收到回應之間的時間延遲。 開發代理可以注入人工延遲,以模擬緩慢的網路狀況或過載的 API。
M
模擬回應
開發代理會回傳一個預先定義的回應,而不是將請求轉發到真正的 API。 模擬測試對於尚未出現的 API 或想要可預測回應時非常有用。
模擬檔案
一個包含模擬回應定義的 JSON 檔案(通常 mocks.json為)。 每個項目將 URL 模式對應到回應主體、狀態碼及標頭。
P
通過
當開發代理在不做任何修改的情況下,將請求轉發到真正的 API 時。 這種情況發生在請求與任何啟用插件不匹配,或插件決定不回應時。
外掛程式
一個模組化元件,能擴充 Dev Proxy 的功能。 外掛可以攔截請求、產生報告或提供指引。 參見 插件架構。
Preset
一個用於常見情境的預設設定檔。 預設結合插件與設定以完成特定任務。 請參見 使用預設配置。
Proxy
一台位於用戶端應用程式與 API 伺服器之間的伺服器,負責中繼請求與回應。 Dev Proxy 在你的電腦上以本地代理方式執行。
R
速率限制
API 用來限制客戶端在一段時間內可發出的請求次數的技術。 Dev Proxy 可以透過回傳 429 錯誤(請求過多)來模擬速率限制。 跟 限速比較。
錄製
捕捉 API 請求與回應以供後續分析的過程。 Dev Proxy 可以記錄流量並匯出成各種格式。
記者
一個外掛,能將錄製的資料轉換成人類可讀格式,如 Markdown、JSON 或純文字。 報告器處理報告外掛的輸出。
報告外掛
一個外掛,能分析已錄製的請求並產生有關 API 使用情況、權限或最佳實務的報告。
S
Schema
一個定義 Dev Proxy 設定檔結構與驗證規則的 JSON Schema 檔案。 結構在支援它們的編輯器中使 IntelliSense 得以實現。
影子 API
一個應用程式使用但組織尚未正式文件或知曉的 API 端點。 Dev Proxy 可以幫助發現影子 API。
T
Throttling
當 API 因高負載或保護資源而故意減慢或拒絕請求時, 通常與 速率限制互換使用,雖然限速通常意味著暫時性狀況,而速率限制則是固定政策。
U
值得關注的網址
開發代理監控的請求 URL 模式。 只有符合這些模式的請求會被攔截。 模式支援萬用符,例如 https://api.contoso.com/*。
W
手錶
用來監控對特定網址的請求。 開發代理伺服器會監聽你設定的 URL,並能攔截匹配的請求。