Webhook 概述

本文档介绍 Webhook 的基本概念和使用场景。

什么是 Webhook

Webhook 允许您在数据发生变化时接收实时通知。当配置的事件发生时，系统会向您指定的 URL 发送 HTTP POST 请求。

使用场景

Webhook 可以用于:

1. 数据同步 - 将数据实时同步到其他系统
2. 自动化工作流 - 触发其他系统的自动化操作
3. 实时通知 - 接收数据变更的实时提醒
4. 数据备份 - 实时备份重要数据

支持的事件

记录事件

• record.create - 创建记录时触发
• record.update - 更新记录时触发
• record.delete - 删除记录时触发
• record.action - 单行记录操作时手动触发
• record.bulk-action - 批量操作记录时手动触发

请求格式

基本请求结构

{
  "type": "事件类型",
  "created_at": "事件发生时间",
  "data": {
    "base_id": "数据库 ID",
    "table_name": "表格名称",
    "records": [
      // 相关记录数据
    ]
  }
}

最佳实践

1. 验证每个请求的签名
2. 快速响应 webhook 请求
3. 使用异步处理机制
4. 实现幂等处理
5. 做好错误处理和日志记录