請求體結構
每個 Webhook 請求都遵循統一的結構規範。
請求頭
每個 Webhook 請求至少包含以下兩個請求頭:
| 請求頭 | 說明 | 示例 |
|---|---|---|
Content-Type | 內容類型 | application/json |
X-Chat-Signature | HMAC-SHA256 簽名 | 4ecdcaf813c422d34413671b2ed68e0a6e69ea8496d34ab40bd33cef26571e70 |
請求體
請求體為 JSON 格式,所有事件共享以下基礎字段:
| 參數名 | 類型 | 說明 | 參數示例 |
|---|---|---|---|
created_at | number | Webhook 發送日期(時間戳) | 1765439941 |
event | string | 事件名稱 | UNREPLIED |
webhook_id | string | 唯一的 Webhook ID | 58946f5f583edd94f5cf87e3534d04fb |
content | array | 包含特定事件數據的對象 | — |
content 數組中的字段根據事件類型不同而不同,詳見 事件類型。
響應要求
你的接收端應在 5 秒內 返回 HTTP 200 狀態碼,表示已成功接收。
如果返回非 200 狀態碼或超時,系統將進行重試。