追加单题

在指定表单的最后顺序追加一道全新的题目。支持设置外部自定义题目 ID、题型、必填、选项列表以及考试评分属性。

接口基本信息

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

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

字段名	类型	必填	说明	示例
`formKey`	String	是	表单全局唯一标识 Key	`"ICGqvdBR"`
`item`	Object	是	待追加的题目对象（`FormItemV2Request`）	见下表
├─ `id`	String	否	自定义题目 ID（如 `q_company`，留空自动生成）	`"q_company"`
├─ `type`	String	是	题型代码（`INPUT`, `RADIO`, `CHECKBOX`, `SELECT`, `UPLOAD` 等）	`"INPUT"`
├─ `label`	String	是	题目标题	`"就职单位名称"`
├─ `required`	Boolean	否	是否必填（默认 `false`）	`true`
├─ `placeholder`	String	否	输入占位提示文案	`"请输入公司全称"`
├─ `description`	String	否	题目描述说明	`"开具发票时使用"`
├─ `options`	Array	否	选项列表（选择类题型必填）	`["选项1", "选项2"]`
└─ `exam`	Object	否	考试专用评分配置（仅考试表单使用）	`{}`

请求调用示例

1. HTTP 报文请求

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

{
  "formKey": "ICGqvdBR",
  "item": {
    "id": "q_company",
    "type": "INPUT",
    "label": "就职单位全称",
    "required": true,
    "placeholder": "请输入企业或机构名称",
    "description": "用于制作参会证胸卡"
  }
}

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Object	追加成功的题目对象（`FormItemV2VO`）
├─ `id`	String	题目 ID
├─ `type`	String	题型代码
├─ `label`	String	题目标题
├─ `required`	Boolean	是否必填
├─ `placeholder`	String	输入提示文案
├─ `sort`	Integer	生成的题目顺序序号
└─ `options`	Array	选项列表

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": "q_company",
    "type": "INPUT",
    "label": "就职单位全称",
    "required": true,
    "placeholder": "请输入企业或机构名称",
    "description": "用于制作参会证胸卡",
    "sort": 13
  }
}

官方文档·

约 5 分钟阅读 (1748 字)

最后更新于 2026-08-20 09:48:29

这篇文章对您有帮助吗？

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