【表单】全量覆盖替换题目

完全覆盖并重构指定表单的题目列表。原有旧题目将被物理清理，并以本次请求中传入的题目列表为准重新生成。

接口基本信息

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

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

请求调用示例

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

{
  "formKey": "ICGqvdBR",
  "name": "全量覆盖重构后的表单",
  "description": "已精简填报字段，仅保留核心联系方式",
  "items": [
    {
      "id": "rep_name",
      "type": "INPUT",
      "label": "真实姓名",
      "required": true,
      "placeholder": "请输入姓名"
    },
    {
      "id": "rep_mobile",
      "type": "INPUT",
      "label": "联系手机号",
      "required": true,
      "placeholder": "请输入手机号码"
    },
    {
      "id": "rep_corp",
      "type": "INPUT",
      "label": "就职单位全称",
      "required": false
    }
  ]
}

响应参数说明 (Response Body - FormDetailV2VO)

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "formKey": "ICGqvdBR",
    "name": "全量覆盖重构后的表单",
    "description": "已精简填报字段，仅保留核心联系方式",
    "type": "ORDINARY",
    "status": "STOP",
    "folderId": 0,
    "items": [
      {
        "id": "rep_name",
        "type": "INPUT",
        "label": "真实姓名",
        "required": true,
        "placeholder": "请输入姓名",
        "sort": 0
      },
      {
        "id": "rep_mobile",
        "type": "INPUT",
        "label": "联系手机号",
        "required": true,
        "placeholder": "请输入手机号码",
        "sort": 1
      },
      {
        "id": "rep_corp",
        "type": "INPUT",
        "label": "就职单位全称",
        "required": false,
        "sort": 2
      }
    ],
    "updateTime": "2026-08-20 09:45:00"
  }
}