本文針對多維表格自動化流程中「接收到 webhook 時」這一觸發條件，說明 webhook 的參數與可能出現的錯誤碼。操作指引請參考使用自動化流程的 webhook 觸發。
請求頭（Header）
- Authorization（string，選填）：憑證校驗（Bearer token）透過 Header 傳入，格式為
Authorization: Bearer [token]；Key 固定為 Authorization、Value 有固定前綴 Bearer，Bearer 與 token 間必須有一個空格。 - Client-Token（string，選填）：用於冪等，Value 由使用者產生（通常用 uuid）。為空表示發起新請求；非空表示冪等更新，相同值 3 小時內只會觸發一次。
請求體與回應體
- 請求體：按需設定，格式需符合 JSON 規範。
- 回應體：
code非 0 表示失敗，可對照錯誤碼排查；正常時code為 0。
常見錯誤碼
| 錯誤碼 | 報錯文案 | 原因與處理 |
|---|---|---|
| 800005649 | 未通過憑證校驗 | 攜帶的憑證與流程所需不符，需重新檢查輸入 |
| 800005650 | IP 不在白名單中 | 發送請求的 IP 不在白名單，需加入白名單或更換 IP |
| 800005647 | 請求內容大小超出上限 | 請求超過 4 MB，需減少內容 |
| 800005646 | 存在調用自身的 HTTP 節點造成死循環 | HTTP 請求 URL 與當前流程 webhook 位址一致，需修改 URL |
| 800005652 | 請求過於頻繁 | 超出頻率限制（多維表格 50 次/秒、單流程 5 次/秒、未開憑證校驗 1 次/秒），需稍後再試 |
| 800006003 | 請求體不符合 JSON 規範 | 請求體 JSON 格式有誤，需修改後重試 |
延伸閱讀：在自動化操作中引用內容、Lark 多維表格自動化流程。
常見問題
webhook 接收的請求內容大小上限是多少？
webhook 接收 HTTP 請求的大小上限為 4 MB，超過會回報錯誤碼 800005647，需減少內容。
webhook 觸發頻率有什麼限制？
整個多維表格的 webhook 觸發頻率上限為 50 次/秒，單個自動化流程為 5 次/秒；針對不開啟憑證校驗（Bearer token）的流程，每個流程上限為 1 次/秒。超出會被限流並回報 800005652。
請求頭的 Client-Token 有什麼作用？
Client-Token 用於冪等，值由使用者產生（通常用 uuid）。若此值為空，表示發起一次新請求；若非空，表示冪等更新，相同的值在 3 小時內只會觸發一次。