【表单】修改单题

根据题目自定义 id，对指定题目的标题、必填状态、提示文字、选项列表或考试评分属性进行局部修改。

接口基本信息

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

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

字段名	类型	必填	说明	示例
`formKey`	String	是	表单全局唯一标识 Key	`"ICGqvdBR"`
`item`	Object	是	待更新的题目对象（`FormItemUpdateV2Request`）	见下表
├─ `id`	String	是	目标题目自定义 ID（必须存在）	`"q_company"`
├─ `type`	String	是	题型代码	`"INPUT"`
├─ `label`	String	是	题目标题	`"就职单位全称（已修改）"`
├─ `required`	Boolean	否	是否必填	`true`
├─ `placeholder`	String	否	占位提示文案	`"请准确填写公司完整全称"`
├─ `description`	String	否	题目描述	`"用于发票抬头与参会胸卡"`
└─ `options`	Array	否	选项列表	`[]`

请求调用示例

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

{
  "formKey": "ICGqvdBR",
  "item": {
    "id": "q_company",
    "type": "INPUT",
    "label": "就职单位全称（已修改）",
    "required": true,
    "placeholder": "请准确填写公司完整全称"
  }
}

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Object	更新后的题目对象（`FormItemV2VO`）

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": "q_company",
    "type": "INPUT",
    "label": "就职单位全称（已修改）",
    "required": true,
    "placeholder": "请准确填写公司完整全称",
    "sort": 13
  }
}

官方文档·

约 4 分钟阅读 (1410 字)

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

这篇文章对您有帮助吗？

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

【表单】修改表单基础信息

【表单】复合更新表单