智能助手
帮助中心智能助手上线
我能为你解答 Lark 使用的问题,快来问问我吧!
00:00
点击按住可拖动视频
我知道了
去试试
自动化 webhook 参数的详细说明

自动化 webhook 参数的详细说明

本文阅读时长:6 分钟
一、简介
此文章是针对多维表格自动化流程中的“接收到 webhook 时”这一触发条件的更多说明,详细介绍 webhook 的参数和可能出现的错误码。关于使用 webhook 触发的操作指引,请参考使用自动化流程的 webhook 触发
二、说明
请求头(Header)及示例
名称
类型
必填
描述
Authorization
string
凭证校验(Bearer token)需通过请求头(Header)的方式传给多维表格自动化,Header 格式(区分大小写)如下:
--header 'Authorization: Bearer [真实的 Bearer token]'
单引号在实际 Header 中必须输入。中括号[]仅表示变量,在实际 Header 中无需输入。
此处 Header 的 Key(键)固定为 Authorization,Value(值)有固定前缀 Bearer。
请注意,Bearer 前缀和真实的 bearer token 中间,必须加一个空格。
Client-Token
string
幂等的 Header 中,Key(键)固定为 Client-Token,Value(值)由用户生成,通常使用 uuid。
若此值为空,表示将发起一次新的请求。若此值非空,表示幂等的进行更新操作,相同的值 3 小时内只会触发一次。
Bearer token 的示例代码如下(中括号表示需替换的变量,无需在实际代码中写入):
curl --location --request POST '[真实 webhook 地址]' \
--header 'Authorization: Bearer [真实 Bearer token]' \
--header 'Content-Type: application/json' \
--data-raw '{[真实请求体内容]}'
请求体
按需设置即可,格式需符合 JSON 规范。
响应体及示例
响应体中的 code 非 0 时表示失败。
当 code 不是 0 时,你可以对照下文“相关报错”表格中的错误码和文案来排查问题。
当 webhook 接收正常时,响应体示例如下:
{
"msg": "",
"data": { },
"code": 0
}
当 webhook 出现报错时,响应体示例如下:
{
"data": { },
"code": 800004509,
"msg": "webhook trigger workflow is disabled"
}
错误码
若 webhook 触发出现报错,你需要在发出请求方查看报错情况,根据下表的错误码和报错文案来排查问题。
错误码
报错文案
报错原因
解决方法
800005649
未通过凭证校验
开启了凭证校验,但HTTP 请求中携带的凭证与自动化流程中所需的凭证不符,导致流程无法运行。
重新检查和输入凭证。
800005650
IP 地址不在白名单中,请检查
开启了 IP 白名单,且发送请求的 IP 不在白名单内。
将对应 IP 加入白名单,或更换 IP 地址重新发送。
800005647
请求内容大小超出上限,请减少内容
webhook 接收 HTTP 请求的大小超出了 4 MB。
请减少内容。
800005646
存在调用自身的 HTTP 节点,造成死循环,请修改 HTTP 节点请求地址
自动化流程的触发条件为“webhook 触发时”,执行操作为“发送 HTTP 请求”,且 HTTP 的请求 URL 和当前流程的 webhook 地址一致,导致流程进入了循环触发。
修改“发送 HTTP 请求”中的 URL,不可与 webhook 地址一致。
800005652
请求过于频繁,请稍后再试
webhook 接收 HTTP 请求的频率超出了限制,被限流。
  • 整个多维表格的 webhook 触发频率上限为 50 次/秒。
  • 单个自动化流程的 webhook 触发频率上限为 5 次/秒。
  • 针对不开启凭证校验(Bearer token)的自动化流程,每个流程的频率上限为 1 次/秒。
稍后再试。
800006003
请求体不符合 JSON 格式规范,请修改后重新请求
通常发生在使用“通过发送请求设置”的方法设置输出的时候,指接收到的请求体的 JSON 格式有误。
请重新检查请求体的 JSON,修改后重试。
三、了解更多
作者Lark 帮助中心
最后更新于2024-07-25
评价此内容
提交成功,感谢你的反馈!
未能解决你的问题?请联系在线客服
rangeDom