投遞日誌與測試
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 錯誤 | 確認伺服器正在執行,且可公開存取 |