說明文件

投遞日誌與測試

Webhook 設定面板為每個端點提供內建投遞日誌。可用它確認事件是否到達伺服器、診斷失敗,併傳送新的範例載荷,無需觸發真實活動。

檢視投遞日誌

1

開啟設定 → Webhook

前往 Dashboard → Settings → Webhooks.
2

展開 Webhook 行

點選 投遞日誌 按鈕,位於任意 Webhook 卡片上。顯示最近 50 次投遞嘗試,最新在前。
3

檢查每個條目

每行顯示事件型別、HTTP 狀態碼、回應時間、時間戳和任何錯誤資訊。

日誌欄位

欄位描述
事件觸發的事件型別(例如 post.saved)
狀態端點返回的 HTTP 狀態。 null 如果超時或連線被拒絕。
回應時間從傳送到接收最終響應位元組的往返時間,單位為毫秒。
成功綠色勾號 = HTTP 2xx。紅色叉號 = 其他任何結果。
錯誤投遞失敗時便於理解的錯誤資訊(例如 Request timed out (10s)).
送達時間投遞嘗試的 UTC 時間戳。

傳送測試事件

1

展開 Webhook 卡片

在 Settings → Webhooks,找到你的 webhook,然後點選 傳送測試事件.
2

檢查投遞日誌

測試投遞會在幾秒內出現在投遞日誌列表頂部。請確認能看到 200 狀態。

測試事件是真實 HTTP 請求

測試事件與真實事件使用完全相同的處理流程,包括 HMAC 簽名。簽名驗證程式碼會在測試中完整執行。

不自動重試

每次投遞僅嘗試一次。日誌僅供診斷,失敗的實時事件沒有重放按鈕。修復端點後,請使用“測試”驗證修復結果。

常見失敗原因

錯誤 / 狀態可能原因修復
Request timed out (10s)伺服器響應超過 10 秒返回 200 立即響應,然後非同步處理
401簽名驗證失敗請務必在解析 JSON 前讀取原始請求體
404端點 URL 路徑不存在再次檢查 Savebase Webhook 設定中的 URL
500接收端存在未處理錯誤檢視伺服器日誌中的異常
連線被拒絕 / 狀態為空伺服器宕機或 URL 錯誤確認伺服器正在執行,且可公開存取