概述

TDuckX 数据接入方式总览

TDuckX 提供多种方式让外部系统获取表单数据,实现业务系统对接、自动化处理和数据共享。你可以根据场景选择最适合的方式:


数据接入方式概览

方式 核心特点 适用场景
1️⃣ Webhook 推送 数据实时主动推送到你的系统 需要实时触发流程,如审批通知、业务联动
2️⃣ 应用调用内部接口 新建 App 应用,直接调用 TDuckX 内部接口获取数据 企业内部系统整合、私有部署场景
3️⃣ OpenAPI(标准接口) 外部系统通过 REST API 拉取表单结构和填写数据 数据同步、BI 分析、ERP/OA/CRM 集成

简单理解:

*Webhook:数据主动“打给你”,类似短信通知 内部接口:内部系统直接访问表单数据 OpenAPI:标准接口,支持外部系统周期拉取


Webhook 数据接入

原理:当表单有新数据提交或更新时,TDuckX 会向你配置的 URL 发送 HTTP POST 请求,带上表单数据。

特点

  • 实时性强
  • 不需要定时轮询
  • 易于触发自动化流程

使用示例

  1. 配置你的系统 URL 接收 Webhook
  2. 用户提交表单
  3. 系统收到数据并执行后续业务逻辑,如自动建档、发通知

使用表单内部 App 应用调用接口

原理:在 TDuckX 中新建一个内部应用,获取 KeySecret,通过内部接口访问表单数据。

特点

  • 安全认证机制
  • 可以访问企业内部未对外开放的数据
  • 适合内部系统直接整合

使用示例

  1. 创建 App 应用
  2. 获取 Key/Secret 并换取 AccessToken
  3. 调用内部接口获取表单数据或提交数据
  4. 系统完成数据处理和业务联动

OpenAPI 数据接入(标准接口)

原理:外部系统通过 REST API 获取表单结构和填写数据,实现数据同步和统计分析。

特点

  • 规范统一
  • 易于集成到 ERP/OA/CRM/BI
  • 支持字段和数据一体化拉取

核心接口能力

功能 可以做什么
获取表单字段 知道表单有哪些字段、字段类型
获取表单数据 获取所有填写的数据
字段 + 数据一体化 一次拿到“字段结构 + 填写结果”

安全机制

  • 通过 Key + Secret 获取临时 AccessToken
  • 请求 Header 中携带 Authorization: Bearer <access_token>

选择指南

需求 推荐方式
实时触发业务 Webhook
内部系统整合、私有部署 内部 App 接口
定期拉取、外部系统同步 OpenAPI

建议与注意事项

  • Token 有效期一般为 2 小时,建议自动刷新
  • Webhook 接收端需保证高可用性
  • 数据量大时建议使用分页接口
  • 调试工具推荐 Postman、Apifox