获取收集表填写数据

最后更新：2026/10/13

分页获取收集表填写数据，支持客户填写和员工填写。

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/collect/detail/page?access_token=access_token

Query参数：

参数 类型 必填 说明
access_token string 是 调用接口凭证

Body参数：

{
  "form_id": 1634567890987645,
  "detail_status": 1,
  "send_user_id": "Wang",
  "start_commit_time": 1645632000,
  "end_commit_time": 1645646000,
  "current_index": 1,
  "page_size": 10
}
参数 类型 必填 说明
form_id string 是 收集表的id
send_user_id string 否 发送人id
detail_status int 否 填写的收集表详情数据的状态 0-已查看未填写，1-已填写未提交，2-已提交
start_commit_time long 否 提交时间的开始时间.到秒的时间戳
end_commit_time long 否 提交时间的结束时间.到秒的时间戳
current_index int 是 当前页数
page_size int 是 每页大小；最大不能超过200

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 20,
    "records": [
      {
        "customer_name": "幽默的魂",
        "unionid": "oLRmLxAKYJ7ARsPDBss3dq1",
        "external_userid": "wmDkH9EAAAMaUogKi6d5pyccVuqi1hWQ",
        "detail_status": 0,
        "view_time": 1645632000,
        "commit_time": 1645632012,
        "send_user_id": "woDkH9EAAAdsSWgIDXXjUREWuIS9Yktg",
        "dept_id": 1,
        "detail_data": "{\"area\":{\"code\":\"\",\"name\":\"\"},\"address\":\"\",\"cellPhoneNumber\":\"\",\"mobilePhone\":\"\",\"gender\":[],\"mf_collect_form_ddm6bj3mrxa9_51\":[{\"name\":\"865d79af8f424dd\",\"id\":\"1800356349545037315\",\"value\":\"https://pubres-test.wshoto.com/base-material-server/wpDkH9EAAAbGhTVDWDgcS9soO5YxCA3A/1800356314233230850-1718073368973.jpeg\"}],\"compellation\":\"慧琳\",\"accessCustomerChannel\":[],\"email\":\"\"}",
        "submit_user_id": null,
        "target_type": 0
      }
    ]
  }
}

返回说明：

参数 类型 说明
code int 出错返回码，为0表示成功，非0表示调用失败
msg string 返回码描述
data File 分页数据
total int 总量
records Detail[] 收集表详情列表
customer_name string 客户名称（如果有就返回）
unionid string 客户unionid（如果有就返回)
openid string 客户openid（如果有就返回)
external_userid string 客户external_userid（如果有就返回)
detail_status int 填写的收集表详情数据的状态 0-已查看未填写，1-已填写未提交，2-已提交
view_time long 查看时间.到秒的时间戳
commit_time long 提交时间.到秒的时间戳
send_user_id string 发送员工userid
dept_id int 员工主部门id
detail_data string 填写的收集表详情，支持客户填写和员工填写
submit_user_id string 填写员工ID，员工填写时返回；与发送员工 send_user_id 不同，客户记录可为空或不返回
target_type int 所属表单的填写对象：0-客户填写，1-员工填写；历史未设置类型的表单按 0 返回

员工填写说明：

  • 请求参数保持不变，使用员工收集表的 form_id 查询；不新增按填写员工或填写对象类型筛选的参数。
  • send_user_id 仍表示发送员工，dept_id 仍表示原发送员工的部门；不能将它们作为填写员工及其部门使用。
  • detail_data 返回该条填写记录的内容，同样适用于员工填写。本次只新增填写员工ID和表单类型，不新增填写员工姓名、部门或关联客户/联系人字段。

results matching ""

    No results matching ""