【表单】获取题目列表

查询指定表单包含的所有题目扁平列表结构。

接口基本信息

接口路径：/open/v2/form/item/list
请求方法：GET
认证方式：HTTP Basic Auth (Authorization: Basic <base64(appId:appSecret)>)
数据格式：application/json

请求参数 (Query Parameters)

参数名	类型	必填	说明	示例
`formKey`	String	是	表单唯一标识 Key	`ICGqvdBR`

请求调用示例

GET /tduck-api/open/v2/form/item/list?formKey=ICGqvdBR HTTP/1.1
Host: api.example.com
Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Array<Object>	题目列表数组（`List<FormItemV2VO>`）
├─ `id`	String	自定义题目 ID
├─ `type`	String	题型代码
├─ `label`	String	题目标题
├─ `required`	Boolean	是否必填
├─ `placeholder`	String	输入提示文案
├─ `sort`	Integer	排序序号
├─ `options`	Array	选项列表
└─ `exam`	Object	考试属性（分值、标准答案、解析）

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "id": "q_name",
      "type": "INPUT",
      "label": "参会人员姓名",
      "required": true,
      "placeholder": "请输入您的真实姓名",
      "sort": 1
    },
    {
      "id": "q_gender",
      "type": "RADIO",
      "label": "性别",
      "required": true,
      "options": [
        {"label": "男", "value": "男"},
        {"label": "女", "value": "女"}
      ],
      "sort": 2
    },
    {
      "id": "q_interests",
      "type": "CHECKBOX",
      "label": "感兴趣的专题方向",
      "required": true,
      "options": [
        {"label": "AI 大模型", "value": "AI 大模型"},
        {"label": "云原生架构", "value": "云原生架构"}
      ],
      "sort": 3
    }
  ]
}

官方文档·

约 4 分钟阅读 (1267 字)

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

这篇文章对您有帮助吗？

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

【表单】查询表单详情

【表单】获取表单列表