API 与集成

通过 API 与 Webhook 对接第三方系统

智能表格提供 HTTP API 与 Webhook 两种集成方式,方便与第三方系统对接。

API 概览

  • 接口基地址:/api/v1(与产品同域,如 https://table.saidetech.com/api/v1);
  • 返回格式:JSON;
  • 请求需要携带身份凭证,未认证请求将返回 401/403 类错误。

数据读取

通过 API 可以读取表格数据、视图配置、自动化运行历史等资源,适合:

  • 把表格数据同步到公司内部系统 / 数据仓库;
  • 在外部页面展示表格中的公开数据;
  • 做数据备份与归档。

入站 Webhook

在自动化中配置「Webhook 接收」触发后,系统会生成一个入站 Webhook 地址:

POST /api/v1/webhooks/inbound/<token>
  • 外部系统向该地址发送 HTTP 请求即可把数据推入表格;
  • 请求体支持模板变量,可在后续流程节点中引用;
  • 适合表单回调、订单通知、监控告警等实时数据接入场景。

典型集成示例

场景:网站表单提交 → 自动写入客户表

  1. 在客户表中创建自动化,触发方式选择「Webhook 接收」;
  2. 复制生成的 Webhook 地址;
  3. 在网站表单后端提交成功后,向该地址 POST 表单数据;
  4. 数据自动落入客户表,并可继续触发后续流程(如通知负责人)。

注意事项

  • 不要把 Webhook 地址写在公开的前端代码里,防止被滥用;
  • 生产环境对接前,先在测试表中验证请求格式与字段映射;
  • 大批量导入推荐分批请求,并关注接口限流与超时配置。
上一篇权限与协作下一篇常见问题