【表单数据】新增单条填报数据

通过开放接口直接向表单录入一条新数据。请求体 data 中的字段 key 直接使用创建表单时自定义的题目 id（如 q_name, q_mobile 等）。

接口基本信息

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

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

字段名	类型	必填	说明
`formKey`	String	是	表单全局唯一标识 Key
`data`	Object	是	填报数据字典（Key 为自定义题目 ID，Value 为题目对应填报值）

各常见题型在 `data` 中的值格式对照表

题型代码	题目 ID 示例	填报值类型	填报值格式示例	说明
`INPUT` / `TEXTAREA`	`q_name`	String	`"张三"`	纯文本字符串
`NUMBER`	`q_age`	Number	`28`	整数或浮点数值
`RADIO` / `SELECT`	`q_gender`	String	`"男"`	选中项的文本或值
`CHECKBOX` / `MULTIPLE_SELECT`	`q_interests`	Array<String>	`["AI 大模型", "云原生架构"]`	选中项数组
`DATE`	`q_birthday`	String	`"1995-08-18"`	日期或时间字符串
`RATE` / `SLIDER`	`q_rating`	Number	`5`	打分或滑块数值
`PROVINCE_CITY`	`q_region`	String	`"广东省/深圳市/南山区"`	斜杠分隔的省市区路径
`INPUT_MAP`	`q_location`	String	`"北京市海淀区中关村南大街1号"`	地理位置定位文本
`SIGN_PAD`	`q_sign`	String	`"http://oss.example.com/sign.png"`	签名图片 URL 或 Base64
`IMAGE_UPLOAD` / `UPLOAD`	`q_avatar`	String	`"http://oss.example.com/avatar.png"`	附件/图片文件的公网可访问 URL

请求调用示例

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

{
  "formKey": "ICGqvdBR",
  "data": {
    "q_name": "张三",
    "q_mobile": "13800138000",
    "q_gender": "男",
    "q_city": "北京",
    "q_interests": [
      "AI 大模型",
      "云原生架构"
    ],
    "q_exp_years": 5,
    "q_rating": 5,
    "q_avatar": "https://example.com/avatars/zhangsan.jpg",
    "q_resume": "https://example.com/attachments/resume-sample.pdf",
    "q_sign": "https://example.com/signatures/sign-zhangsan.png",
    "q_region": "北京市/海淀区",
    "q_location": "北京市海淀区中关村南大街1号",
    "q_suggestion": "期待大会圆满成功！"
  }
}

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Object	写入结果对象（`FormDataSaveResultV2VO`）
├─ `dataId`	String	新生成的数据全局唯一业务 ID
└─ `formKey`	String	所属表单 Key

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "dataId": "1cea9de46f3e4522acb5103cd62d880d",
    "formKey": "ICGqvdBR"
  }
}

官方文档·

约 6 分钟阅读 (2163 字)

最后更新于 2026-08-20 15:32:22

这篇文章对您有帮助吗？

您的反馈将帮助我们不断改进平台技术文档质量

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

【表单数据】删除单条填报数据

【表单数据】新增单条填报数据

【表单数据】新增单条填报数据

接口基本信息

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

各常见题型在 data 中的值格式对照表

请求调用示例

响应参数说明 (Response Body)

响应示例 (HTTP 200)

各常见题型在 `data` 中的值格式对照表