【表单数据】修改单条填报数据

根据数据唯一标识 dataId，对已有的一条填报记录进行局部或全量字段更新。

接口基本信息

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

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

字段名	类型	必填	说明	示例
`formKey`	String	是	表单全局唯一标识 Key	`"ICGqvdBR"`
`dataId`	String	是	待修改的数据全局唯一业务 ID	`"1cea9de46f3e4522acb5103cd62d880d"`
`data`	Object	是	待更新的键值对字典（如更新姓名和城市）	见请求示例

请求调用示例

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

{
  "formKey": "ICGqvdBR",
  "dataId": "1cea9de46f3e4522acb5103cd62d880d",
  "data": {
    "q_name": "张三（已完成现场签到）",
    "q_city": "杭州",
    "q_rating": 5
  }
}

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Boolean	操作结果布尔值（`true` 表示修改成功）

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": true
}

官方文档·

约 3 分钟阅读 (1070 字)

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

这篇文章对您有帮助吗？

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

【表单数据】获取表单数据列表

【表单数据】上传附件 / 图片