TDucKX技术文档
产品能力分析
表单数据对接
TDuckMCP 和 Skill
TDuckX 后端项目
TDuckX 前端项目
Uniapp 移动端
表单开放API
【文件夹】移动表单到文件夹
【表单】复合更新表单
【表单】修改单题
【表单】修改表单基础信息
【表单】停止表单收集
TDuck 表单开放平台 V2 题型与配置模型手册
【表单】全量覆盖替换题目
【文件夹】创建文件夹
【文件夹】获取文件夹列表
【表单数据】批量新增填报数据
【表单数据】删除单条填报数据
【表单】发布表单
【表单】获取表单列表
【表单】获取题目列表
【表单】查询表单详情
【表单】逻辑删除表单
【表单】删除单题
【表单】创建表单 (V2 极简模式)
【表单】复制表单
【表单】追加单题
【表单数据】上传附件 / 图片
【表单数据】修改单条填报数据
【表单数据】获取表单数据列表
【表单数据】获取单条数据明细
【表单数据】新增单条填报数据
TDuck MCP Server 与 OAuth 2.0 接入指南
接入说明
用户登录集成
多数据库适配
系统配置
如何部署或更新

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

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

分页查询表单已回收的数据列表。响应中的填报数据字段已自动映射为表单设计时的自定义题目 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 字)