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

欢迎使用 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 中直接调试。