Webhooks
statusChange
事件,也就是在 agent 進入 ERROR
或 FINISHED
狀態時。
Webhook 驗證
Headers
X-Webhook-Signature
– 含有 HMAC-SHA256 簽名,格式為sha256=<hex_digest>
X-Webhook-ID
– 此次投遞的唯一識別碼(用於記錄很實用)X-Webhook-Event
– 事件類型(目前僅有statusChange
)User-Agent
– 固定為Cursor-Agent-Webhook/1.0
簽名驗證
負載格式
最佳實務
- 驗證簽章 – 一定要驗證 webhook 簽章,確保請求來自 Cursor
- 處理重試 – 如果你的端點回傳錯誤狀態碼,webhook 可能會重試
- 快速回應 – 盡快回傳 2xx 狀態碼
- 使用 HTTPS – 在正式環境務必為 webhook 端點使用 HTTPS URL
- 儲存原始內容 – 儲存原始 webhook 載荷,用於除錯與後續驗證