TDucKX技术文档
产品能力分析
表单数据对接
TDuckMCP 和 Skill
TDuckX 后端项目
TDuckX 前端项目
Uniapp 移动端
表单开放API
【文件夹】移动表单到文件夹
【表单】复合更新表单
【表单】修改单题
【表单】修改表单基础信息
【表单】停止表单收集
TDuck 表单开放平台 V2 题型与配置模型手册
【表单】全量覆盖替换题目
【文件夹】创建文件夹
【文件夹】获取文件夹列表
【表单数据】批量新增填报数据
【表单数据】删除单条填报数据
【表单】发布表单
【表单】获取表单列表
【表单】获取题目列表
【表单】查询表单详情
【表单】逻辑删除表单
【表单】删除单题
【表单】创建表单 (V2 极简模式)
【表单】复制表单
【表单】追加单题
【表单数据】上传附件 / 图片
【表单数据】修改单条填报数据
【表单数据】获取表单数据列表
【表单数据】获取单条数据明细
【表单数据】新增单条填报数据
TDuck MCP Server 与 OAuth 2.0 接入指南
接入说明
用户登录集成
多数据库适配
系统配置
如何部署或更新

接入说明

TDuck 表单开放平台 OpenAPI V2 开发文档

v4.1 版本及后续版本支持

欢迎使用 TDuck 表单开放平台 OpenAPI V2!

TDuck OpenAPI 为企业和开发者提供了全面、高效、现代化的表单引擎接口,支持从表单设计、题目编排、主题样式定制、表单生命周期控制,到数据高速录入、批量同步与文件上传的全套能力。


🚀 快速集成指南

1. Base URL

http(s)://{your-domain}/tduck-api

2. 认证鉴权 (HTTP Basic Auth)

所有请求必须在请求头中携带 Basic Auth 凭据:

Authorization: Basic <base64(appId:appSecret)>

https://www.tduckcloud.com/doc/help/8FJkZiZd

参考该文档生成凭据

3. 幂等性控制 (X-Idempotency-Key)

所有写操作(POST)支持可选传入幂等头以避免网络抖动带来的重复创建:

X-Idempotency-Key: <全局唯一ID>

4. 统一响应格式

{
  "code": 200,
  "msg": "操作成功",
  "data": {}
}

📚 接口文档目录索引

一、 表单生命周期与管理接口 (form-manage/)

接口名称 Method 请求路径 独立文档链接
获取表单列表 GET /open/v2/form/list 查看文档
创建表单 (极简模式) POST /open/v2/form/create 查看文档
复制表单 POST /open/v2/form/copy 查看文档
查询表单详情 GET /open/v2/form/detail 查看文档
全量覆盖替换题目 POST /open/v2/form/replace 查看文档
复合更新表单 POST /open/v2/form/update 查看文档
追加单题 POST /open/v2/form/item/add 查看文档
修改单题 POST /open/v2/form/item/update 查看文档
删除单题 POST /open/v2/form/item/delete 查看文档
获取题目列表 GET /open/v2/form/item/list 查看文档
发布表单 (进入收集) POST /open/form/publish 查看文档
停止表单收集 POST /open/form/stop 查看文档
逻辑删除表单 POST /open/form/delete 查看文档
修改表单基础信息 POST /open/form/update 查看文档

二、 文件夹管理接口 (folder-manage/)

接口名称 Method 请求路径 独立文档链接
创建文件夹 POST /open/v2/form/folder/create 查看文档
获取文件夹列表 GET /open/v2/form/folder/list 查看文档
移动表单到文件夹 POST /open/v2/form/folder/move 查看文档

三、 表单数据与文件操作接口 (form-data/)

接口名称 Method 请求路径 独立文档链接
获取表单数据列表 GET /open/v2/form/data/list 查看文档
获取单条数据明细 GET /open/v2/form/data/detail 查看文档
新增单条填报数据 POST /open/v2/form/data/create 查看文档
批量新增填报数据 POST /open/v2/form/data/batch 查看文档
修改单条填报数据 POST /open/v2/form/data/update 查看文档
删除单条填报数据 POST /open/v2/form/data/delete 查看文档
上传附件 / 图片 POST /open/v2/form/data/upload 查看文档

四、 数据模型与题型配置手册

  • 题型与配置模型手册:包含 17+ 题型字典、在线考试评分模型、表单设置 7 大模块、主题美化配置与题目显隐/跳题逻辑规则。

五、 HTTP 联调脚本

  • form-openapi-v2.http:包含上述全部接口的一键运行脚本,支持在 IntelliJ IDEA / VS Code REST Client 中直接调试。
官方文档·
约 8 分钟阅读 (3010 字)