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

【表单】复制表单

【表单】复制表单

基于已有的表单或问卷快速克隆一份结构完全一致的副本表单(包括所有题目、选项、逻辑规则、主题皮肤及全局设置),可自定义指定新表单名称和存放文件夹。


接口基本信息

  • 接口路径:/open/v2/form/copy
  • 请求方法:POST
  • 请求格式:application/json
  • 认证方式:HTTP Basic Auth (Authorization: Basic <base64(appId:appSecret)>)
  • 幂等支持:支持 X-Idempotency-Key 请求头
  • 并发锁:服务端已对源 formKey 加锁保护

请求参数详细说明 (Request Body)

字段名 类型 必填 默认值 详细说明 示例
formKey String 是 - 待复制的源表单唯一标识 Key "ICGqvdBR"
name String 否 源名称 + 副本 新副本表单的名称(最大 255 字符) "2026年全球云计算大会参会报名表(第2期)"
folderId Long 否 原表单文件夹 复制后存放的目标文件夹 ID(0 为根目录) 1001

请求调用示例

1. HTTP 报文请求

POST /tduck-api/open/v2/form/copy HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==
X-Idempotency-Key: form-copy-2026082001

{
  "formKey": "ICGqvdBR",
  "name": "2026年全球云计算大会参会报名表(第2期)",
  "folderId": 1001
}

2. cURL 命令行示例

curl -X POST "https://api.example.com/tduck-api/open/v2/form/copy" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==" \
  -H "X-Idempotency-Key: form-copy-2026082001" \
  -d '{
    "formKey": "ICGqvdBR",
    "name": "2026年全球云计算大会参会报名表(第2期)",
    "folderId": 1001
  }'

响应参数说明 (Response Body)

字段名 类型 说明
code Integer 状态码(200 表示成功)
msg String 提示信息
data Object 新克隆生成的表单详情对象(FormDetailV2VO)
├─ formKey String 新生成的表单全局唯一标识 Key
├─ name String 新表单名称
├─ description String 表单描述
├─ type String 表单类型(ORDINARY 或 EXAM)
├─ status String 状态(新复制的表单默认处于 STOP 停止收集状态)
├─ folderId Long 目标文件夹 ID
├─ items Array<Object> 成功复制的题目列表
└─ createTime String 副本创建时间

响应示例

成功响应 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "formKey": "wPLQ2U42",
    "name": "2026年全球云计算大会参会报名表(第2期)",
    "description": "欢迎各位技术专家与从业者报名参会,请认真填写真实信息。",
    "type": "ORDINARY",
    "status": "STOP",
    "folderId": 1001,
    "items": [
      {
        "id": "q_name",
        "type": "INPUT",
        "label": "参会人员真实姓名",
        "required": true,
        "sort": 1
      },
      {
        "id": "q_mobile",
        "type": "INPUT",
        "label": "联系手机号",
        "required": true,
        "sort": 2
      }
    ],
    "createTime": "2026-08-20 09:42:00"
  }
}

表单不存在响应 (HTTP 404)

{
  "code": 404,
  "msg": "源表单不存在或无权访问",
  "data": null
}
官方文档·
约 6 分钟阅读 (2072 字)