【表单】复制表单

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

---

接口基本信息

• 接口路径：/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
}