概述
TDuckX 数据接入方式总览
TDuckX 提供多种方式让外部系统获取表单数据,实现业务系统对接、自动化处理和数据共享。你可以根据场景选择最适合的方式:
数据接入方式概览
| 方式 | 核心特点 | 适用场景 |
|---|---|---|
| 1️⃣ Webhook 推送 | 数据实时主动推送到你的系统 | 需要实时触发流程,如审批通知、业务联动 |
| 2️⃣ 应用调用内部接口 | 新建 App 应用,直接调用 TDuckX 内部接口获取数据 | 企业内部系统整合、私有部署场景 |
| 3️⃣ OpenAPI(标准接口) | 外部系统通过 REST API 拉取表单结构和填写数据 | 数据同步、BI 分析、ERP/OA/CRM 集成 |
简单理解:
*Webhook:数据主动“打给你”,类似短信通知 内部接口:内部系统直接访问表单数据 OpenAPI:标准接口,支持外部系统周期拉取
Webhook 数据接入
原理:当表单有新数据提交或更新时,TDuckX 会向你配置的 URL 发送 HTTP POST 请求,带上表单数据。
特点:
- 实时性强
- 不需要定时轮询
- 易于触发自动化流程
使用示例:
- 配置你的系统 URL 接收 Webhook
- 用户提交表单
- 系统收到数据并执行后续业务逻辑,如自动建档、发通知
使用表单内部 App 应用调用接口
原理:在 TDuckX 中新建一个内部应用,获取 Key 和 Secret,通过内部接口访问表单数据。
特点:
- 安全认证机制
- 可以访问企业内部未对外开放的数据
- 适合内部系统直接整合
使用示例:
- 创建 App 应用
- 获取 Key/Secret 并换取 AccessToken
- 调用内部接口获取表单数据或提交数据
- 系统完成数据处理和业务联动
OpenAPI 数据接入(标准接口)
原理:外部系统通过 REST API 获取表单结构和填写数据,实现数据同步和统计分析。
特点:
- 规范统一
- 易于集成到 ERP/OA/CRM/BI
- 支持字段和数据一体化拉取
核心接口能力:
| 功能 | 可以做什么 |
|---|---|
| 获取表单字段 | 知道表单有哪些字段、字段类型 |
| 获取表单数据 | 获取所有填写的数据 |
| 字段 + 数据一体化 | 一次拿到“字段结构 + 填写结果” |
安全机制:
- 通过
Key+Secret获取临时AccessToken - 请求 Header 中携带
Authorization: Bearer <access_token>
选择指南
| 需求 | 推荐方式 |
|---|---|
| 实时触发业务 | Webhook |
| 内部系统整合、私有部署 | 内部 App 接口 |
| 定期拉取、外部系统同步 | OpenAPI |
建议与注意事项
- Token 有效期一般为 2 小时,建议自动刷新
- Webhook 接收端需保证高可用性
- 数据量大时建议使用分页接口
- 调试工具推荐 Postman、Apifox