查询收集表列表

最后更新：2026/10/13

根据条件查询收集表列表信息。

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/collect/form/queryCollectFormList?access_token=x

Query参数：

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

Body参数：

{
  "title": "测试",
  "user_id": "",
  "limit": 100,
  "cursor": "",
  "form_status": "",
  "start_create_time": 1700620462,
  "end_create_time": 1700620463
}
参数 类型 必填 说明
title string 否 收集表标题，支持模糊查询
user_id string 否 用户ID
limit int 否 每页数量，默认100
cursor string 否 分页游标，用于下一页查询
form_status string 否 收集表状态筛选
start_create_time long 否 创建时间开始戳（秒）时间区间左闭右开
end_create_time long 否 创建时间结束戳（秒）
target_type int 否 填写对象：0-客户填写，1-员工填写；不传或为 null 时查询全部类型，其他值不支持

返回值：

{
    "code": 0,
    "msg": "请求成功",
    "data": {
        "records": [
            {
                "id": 1727153519619769538,
                "tenant_id": "wpDkH9EAAAl-jvVONmO99BCvgnJhT4gw",
                "title": "测试数据-普通-前s",
                "material_id": 1727153521867910914,
                "template_id": 1688384007978396162,
                "form_status": 1,
                "gmt_create": "2023-11-22T10:34:22.7",
                "create_time": 1700620462,
                "summary": "",
                "sync_mode": 0,
                "read_num": 16,
                "write_num": 9,
                "commit_num": 9,
                "sync_fail_num": 0,
                "creator": "woDkH9EAAA9Tu9nPfkPmJQQAsjwlL1IQ",
                "multi_commit": 1,
                "ad_code": null,
                "target_type": 0,
                "allow_edit_submitted": 1,
                "allow_relate_user": 1
            }
        ],
        "next_cursor": null
    },
    "sub_code": "00000"
}

返回说明：

参数 类型 说明
code int 出错返回码，为0表示成功，其他表示调用失败
msg string 返回码描述
sub_code string 子错误码，为"00000"表示成功
data object 收集表列表数据
records array 收集表记录列表
next_cursor string 下一页游标，null表示没有更多数据
id long 收集表ID
tenant_id string 租户ID
title string 收集表标题
material_id long 素材ID
template_id long 自定义字段模板id
form_status int 状态 0-暂存、1-已发布、10-已结束
gmt_create datetime 创建时间
create_time long 创建时间戳（秒）
summary string 摘要、说明
sync_mode int 同步模式, 默认0-不同步，1-同步至线索池,2-同步至客户信息
read_num long 阅读数
write_num long 填写数
commit_num long 提交数
sync_fail_num long 同步失败数
creator string 创建人
multi_commit int 同一客户是否可提交多次 1 是 0 否 默认为0
ad_code string 指定使用区域，null表示不限制
target_type int 填写对象：0-客户填写，1-员工填写；历史未设置类型的表单按客户表处理
allow_edit_submitted int 允许编辑已提交内容：0-否，1-是
allow_relate_user int 员工填写时允许关联人员：0-否，1-是；客户表不使用该配置

注：列表不加载 visible_dept_ids、visible_user_ids，其缺失或为 null 不代表表单未配置可见范围；需要完整配置时，请调用根据ID查询收集表详情接口。员工填写不执行 sync_mode 对应的客户同步流程。

results matching ""

    No results matching ""