【表单】获取表单列表

分页获取当前开发者/租户账号下的表单列表，支持按关键字模糊搜索、收集发布状态以及归属文件夹进行复合条件筛选。

---

接口基本信息

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

---

请求参数 (Query Parameters - FormQueryV2Request)

参数名	类型	必填	默认值	取值范围 / 说明	示例
current	Integer	否	1	当前查询页码，从 1 开始	1
size	Integer	否	20	每页返回的记录数，最大支持 100 条	20
keyword	String	否	-	表单名称/描述/formKey 模糊匹配关键字（最大 100 字符）	2026
status	String	否	-	表单收集状态筛选： • RELEASE：已发布（正在收集） • STOP：已停止收集 • CREATE：待发布草稿	RELEASE
folderId	Long	否	-	所属文件夹 ID 筛选： • 0：未归档到文件夹的根目录表单 • >0：指定文件夹 ID	0

---

请求调用示例

1. HTTP 报文请求 (复合条件查询)

GET /tduck-api/open/v2/form/list?keyword=2026&status=RELEASE&folderId=0&current=1&size=10 HTTP/1.1
Host: api.example.com
Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==

2. cURL 命令行示例

curl -X GET "https://api.example.com/tduck-api/open/v2/form/list?current=1&size=20&keyword=2026" \
  -H "Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw=="

---

响应参数说明 (Response Body - FormSummaryV2VO)

字段名	类型	说明
code	Integer	状态码。200 表示成功，其它为错误码
msg	String	业务提示信息，如 "操作成功"
data	Object	分页结果对象（PageResult<FormSummaryV2VO>）
├─ records	Array<Object>	当前页表单摘要记录数组
│ ├─ formKey	String	表单唯一标识 Key（8位字符，如 "ICGqvdBR"）
│ ├─ name	String	表单名称
│ ├─ description	String	表单描述或填报说明
│ ├─ status	String	收集状态：RELEASE (发布中), STOP (已停止), CREATE (草稿)
│ ├─ type	String	表单类型：ORDINARY (普通表单/问卷), EXAM (在线考试)
│ ├─ folderId	Long	所属文件夹 ID（0 或 null 表示未归档根目录）
│ ├─ createTime	String	表单创建时间，格式：yyyy-MM-dd HH:mm:ss
│ └─ updateTime	String	表单最后修改时间，格式：yyyy-MM-dd HH:mm:ss
├─ total	Long	符合条件的记录总数
├─ size	Long	当前每页大小
├─ current	Long	当前页码
└─ pages	Long	总页数

---

响应示例

成功响应 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "records": [
      {
        "formKey": "ICGqvdBR",
        "name": "2026年技术大会报名与调研表",
        "description": "欢迎参加本次大会，请填写真实有效信息",
        "status": "RELEASE",
        "type": "ORDINARY",
        "folderId": 0,
        "createTime": "2026-08-18 10:00:00",
        "updateTime": "2026-08-19 14:30:00"
      },
      {
        "formKey": "kL8mNpQ1",
        "name": "2026年后端工程师专业技能考核",
        "description": "答题时间 60 分钟，满分 100 分",
        "status": "STOP",
        "type": "EXAM",
        "folderId": 0,
        "createTime": "2026-08-19 09:00:00",
        "updateTime": "2026-08-19 18:20:00"
      }
    ],
    "total": 2,
    "size": 10,
    "current": 1,
    "pages": 1
  }
}