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

分页查询表单已回收的数据列表。响应中的填报数据字段已自动映射为表单设计时的自定义题目 ID（如 q_name, q_city, q_interests），完全免去解析底层 scheme 的繁琐过程。支持时间区间过滤和全文关键字模糊搜索。

接口基本信息

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

请求参数 (Query Parameters)

参数名	类型	必填	默认值	说明与取值范围	示例
`formKey`	String	是	-	表单全局唯一标识 Key	`ICGqvdBR`
`current`	Integer	否	`1`	当前查询页码，从 `1` 开始	`1`
`size`	Integer	否	`10`	每页大小，最大支持 `100` 条	`20`
`beginDateTime`	String	否	-	提交时间起始区间（格式：`yyyy-MM-dd HH:mm:ss`）	`2026-08-01 00:00:00`
`endDateTime`	String	否	-	提交时间截止区间（格式：`yyyy-MM-dd HH:mm:ss`）	`2026-08-31 23:59:59`
`keyword`	String	否	-	模糊搜索关键字（匹配填报内容、业务数据 ID、提交 IP 等）	`张三`

请求调用示例

1. HTTP 报文请求 (带时间区间与关键字搜索)

GET /tduck-api/open/v2/form/data/list?formKey=ICGqvdBR&beginDateTime=2026-08-01%2000:00:00&endDateTime=2026-08-31%2023:59:59&keyword=张三&current=1&size=20 HTTP/1.1
Host: api.example.com
Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw==

2. cURL 命令行示例

curl -X GET "https://api.example.com/tduck-api/open/v2/form/data/list?formKey=ICGqvdBR&current=1&size=20&keyword=%E5%BC%A0%E4%B8%89" \
  -H "Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw=="

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Object	分页结果数据对象
├─ `records`	Array<Object>	数据记录列表（`List<FormDataItemV2VO>`）
│ ├─ `id`	Long	数据自增主键序号
│ ├─ `dataId`	String	数据全局唯一业务 ID（后续根据单条修改/删除数据的主键）
│ ├─ `formKey`	String	所属表单 Key
│ ├─ `submitAddress`	String	填报人地理位置（由客户端 IP 解析得到）
│ ├─ `submitOs`	String	填报人操作系统
│ ├─ `submitBrowser`	String	填报人浏览器
│ ├─ `submitRequestIp`	String	填报人客户端真实 IP
│ ├─ `createTime`	String	填报提交时间戳（`yyyy-MM-dd HH:mm:ss`）
│ └─ `data`	Object	填报内容键值字典（Key 为自定义题目 ID，Value 为填报值）
├─ `total`	Long	数据总条数
├─ `size`	Long	每页大小
├─ `current`	Long	当前页码
└─ `pages`	Long	总页数

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "records": [
      {
        "id": 1001,
        "dataId": "1cea9de46f3e4522acb5103cd62d880d",
        "formKey": "ICGqvdBR",
        "submitAddress": "北京市海淀区",
        "submitOs": "Mac OS X",
        "submitBrowser": "Chrome 120",
        "submitRequestIp": "127.0.0.1",
        "createTime": "2026-08-20 09:45:00",
        "data": {
          "q_name": "张三",
          "q_mobile": "13800138000",
          "q_gender": "男",
          "q_city": "北京",
          "q_interests": [
            "AI 大模型",
            "云原生架构"
          ],
          "q_exp_years": 5,
          "q_rating": 5,
          "q_avatar": "https://example.com/avatars/zhangsan.jpg",
          "q_sign": "https://example.com/signatures/sign-zhangsan.png",
          "q_region": "北京市/海淀区",
          "q_suggestion": "期待大会圆满成功！"
        }
      }
    ],
    "total": 1,
    "size": 20,
    "current": 1,
    "pages": 1
  }
}

官方文档·

约 7 分钟阅读 (2581 字)

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

这篇文章对您有帮助吗？

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

【表单数据】获取单条数据明细

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