本文将为您介绍自建 webhook 接口服务的验证机制。

1 使用说明 #

• 若您使用的是飞书或飞书群中生成的 Webhook 链接，可跳过此验证。本文所涉及的验证仅适用于自建的 Webhook 服务。
• 若您自建的 Webhook 服务，访问有白名单限制时，您可通过提工单的方式，咨询 DataLeap 技术支持获取 Webhook 出口 IP 网段白名单列表。

2 验证机制 #

消息中心将在构造请求体，包含名为challenge的参数，值为随机整数；用户需要返回该 chanllenge 值作为响应。

3 消息中心验证 request body #

{
   "challenge": "int" // 消息中心验证时请求参数           
}

4 webhook 接口 response body #

当收到的请求里包含 challenge 参数时，此时为接口验证，需将 challenge 返回。

{
    "status": "int",  //状态码
    "data": {
        "challenge": "int" // 传递原来的数值           
    }
}