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

根据数据唯一标识 dataId 查询单条表单填报明细。响应中的 data 属性已按自定义题目 ID（如 q_name）格式化返回。

接口基本信息

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

请求参数 (Query Parameters)

参数名	类型	必填	说明	示例
`formKey`	String	是	表单全局唯一标识 Key	`ICGqvdBR`
`dataId`	String	是	待查询数据的全局唯一业务 ID	`1cea9de46f3e4522acb5103cd62d880d`

请求调用示例

1. HTTP 报文请求

GET /tduck-api/open/v2/form/data/detail?formKey=ICGqvdBR&dataId=1cea9de46f3e4522acb5103cd62d880d 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/detail?formKey=ICGqvdBR&dataId=1cea9de46f3e4522acb5103cd62d880d" \
  -H "Authorization: Basic R1JzMHc5QXl6ZjVjV2dUYzpha3ZETlFSamVqVFdEZWxmOFRPTUVRTVcyMTFDM2Zqaw=="

响应参数说明 (Response Body)

字段名	类型	说明
`code`	Integer	状态码（`200` 表示成功）
`msg`	String	提示信息
`data`	Object	单条填报明细对象（`FormDataItemV2VO`）
├─ `id`	Long	自增序号
├─ `dataId`	String	数据全局唯一业务 ID
├─ `formKey`	String	所属表单 Key
├─ `submitAddress`	String	提交地理位置
├─ `submitOs`	String	操作系统
├─ `submitBrowser`	String	浏览器
├─ `submitRequestIp`	String	客户端请求 IP
├─ `createTime`	String	提交时间戳
└─ `data`	Object	填报数据字典（Key 为自定义题目 ID，Value 为题目对应填报值）

响应示例 (HTTP 200)

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "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": "期待大会圆满成功！"
    }
  }
}

官方文档·

约 5 分钟阅读 (1893 字)

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

这篇文章对您有帮助吗？

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

【表单数据】删除单条填报数据

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