【表单数据】批量新增填报数据

批量向表单写入多条填报数据，适用于外部系统批量数据导入、历史问卷数据同步或高频批量录入场景。单次请求最大支持 100 条。

接口基本信息

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

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

请求调用示例

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

{
  "formKey": "ICGqvdBR",
  "list": [
    {
      "q_name": "李四",
      "q_gender": "女",
      "q_city": "上海",
      "q_interests": [
        "高性能计算"
      ],
      "q_exp_years": 3,
      "q_rating": 4,
      "q_avatar": "https://example.com/avatars/lisi.jpg",
      "q_resume": "https://example.com/attachments/resume-lisi.pdf",
      "q_sign": "https://example.com/signatures/sign-lisi.png",
      "q_region": "上海市/上海市/浦东新区",
      "q_location": "上海市浦东新区张江高科技园区",
      "q_suggestion": "希望增加实操环节"
    },
    {
      "q_name": "王五",
      "q_gender": "男",
      "q_city": "深圳",
      "q_interests": [
        "安全与合规"
      ],
      "q_exp_years": 8,
      "q_rating": 5,
      "q_avatar": "https://example.com/avatars/wangwu.jpg",
      "q_resume": "https://example.com/attachments/resume-wangwu.pdf",
      "q_sign": "https://example.com/signatures/sign-wangwu.png",
      "q_region": "广东省/深圳市/南山区",
      "q_location": "广东省深圳市南山区高新南道",
      "q_suggestion": "希望能多分享生产案例"
    }
  ]
}

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

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "successCount": 2,
    "dataIds": [
      "2dea9de46f3e4522acb5103cd62d880e",
      "3eea9de46f3e4522acb5103cd62d880f"
    ]
  }
}