Mockphine

Mockphine 是什麼？

Mockphine 是專為小型開發與測試團隊設計的本機模擬 API 伺服器。其核心目的是讓本機 API 行為確定性化，透過為每個端點定義明確路由規則——mock、passthrough 或 disabled——同時保持對實際提供回應來源的可見性。

無需猜測不穩定的後端或 staging 變更如何影響測試，Mockphine 專注於本機優先控制與即時檢視。這有助團隊更快除錯、維持 UI 與測試循環順暢，並減少開發過程中的意外行為。

主要功能

• 每個端點的確定性路由匹配：定義精確規則，確保端點行為在各次執行與團隊共享工作流程中保持一致。
• 受控 passthrough 模式：透過將特定請求路由至真實後端，保持部分完成的服務連線，同時保護團隊免於意外即時呼叫。
• 每個端點的嚴格 vs 備用行為：設定伺服器在條件未滿足時的行為，並將其集中管理於單一位置。
• 即時「served-by」與酬載可見性（Live View）：在請求發生時，檢視每個回應是否為 mock、嚴格失敗，或已 passthrough。
• 故障與延遲模擬：模擬延遲、故障與重試，以驗證前端與測試流程如何處理不利條件。
• 開發與測試協作的共享請求記錄：使用共同的請求層級證據，讓跨角色問題能被重現與討論。

如何使用 Mockphine

1. 為您的作業系統安裝 Mockphine（本網站提供 macOS 與 Windows 下載）。
2. 啟動本機伺服器，並為您的 API 呼叫設定端點路由規則，每條路由選擇 mock、passthrough 或 disabled。
3. 針對本機伺服器執行正常的前端或測試工作流程。
4. 使用 Live View 檢視請求結果——確認每個回應是否為 mock、在嚴格規則下失敗，或已 passthrough。
5. 調整路由與模擬設定（例如延遲或故障），反覆迭代行為，直到本機測試循環反映您需驗證的內容。

使用情境

• 後端不穩定時除錯 UI 行為：當服務延遲或變更時，將特定端點路由至 mock 回應，讓 UI 與測試循環持續進行而不中斷。
• 測試嚴格故障與重試邏輯：本機模擬故障與延遲，然後在 Live View 中確認哪些請求嚴格失敗、哪些 passthrough 或回傳 mock 酬載。
• 逐步整合未完成服務：使用受控 passthrough 僅連線就緒端點，同時將其他端點設為 disabled 或 mock，以防意外即時使用。
• 跨開發與測試重現請求層級問題：共享請求記錄，讓兩團隊在本機測試中驗證相同請求行為與酬載細節。
• 減少 staging 變更帶來的意外：從首次呼叫起明確化本機 API 行為，避免 staging 變更靜默影響測試結果。

常見問題

• Mockphine 中的「passthrough」是什麼意思？ Passthrough 會將設定的端點路由至其真實後端，而非提供 mock 回應，同時仍讓您管理哪些端點可即時連線。

• 我可以在本機停用端點嗎？ 可以。Mockphine 支援將端點路由至 disabled 模式，另有 mock 與 passthrough 行為。

• 如何知道回應是 mock 還是來自後端？ 產品包含 Live View，提供即時可見性，顯示每個回應是否為 mock、嚴格失敗，或已 passthrough。

• Mockphine 能模擬延遲與故障嗎？ 可以。它支援故障/延遲模擬，以在發佈前驗證重試、逾時與備用行為。

• 哪裡可以下載 Mockphine？ 本網站列出 macOS 與 Windows 下載。

替代方案

• 使用靜態伺服器存根的 API 模擬工具：這些工具專注於回傳預定義回應，但可能無法提供每個請求結果同樣程度的即時「served-by」檢視。
• 瀏覽器內模擬方法（基於 service worker）：適合前端整合迴圈，但團隊跨本地優先路由控制與請求來源檢查的方式可能有所不同。
• API 虛擬化工具（網路/服務虛擬化）：通常針對較大或企業級工作流程；其設定方式與適合小型開發 + 測試團隊本地迴圈的適用性可能不同。
• 通用請求/路由模擬工具：替代方案可模擬網路狀況，但可能無法在單一本地工作流程中結合端點確定性路由與同樣程度的 served-by 及酬載檢查。