根据ID查询收集表详情

最后更新:2026/10/13

根据收集表ID查询收集表的详细信息

请求方式: POST(HTTPS)

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

Query参数:

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

Body参数:

{
  "form_id": 1634567890987645,
  "share_userid": "woDkH9EAAAdsSWgIDXXjUREWuIS9Yktg"
}
参数 类型 必填 说明
form_id long 是 收集表的ID
share_userid string 否 收集表推广人用户ID,当需要生成带分享人参数的链接时填写

返回值:

{
    "code": "00000",
    "msg": "请求成功",
    "data": {
        "id": "1703702408451883585",
        "title": "信息收集表",
        "material_id": "1703702408636438338",
        "template_id": "1696470627877185985",
        "form_status": 1,
        "gmt_create": "2023-09-18T17:28:02.092",
        "summary": "用于收集填写的信息",
        "sync_mode": 0,
        "read_num": 128,
        "write_num": 85,
        "commit_num": 72,
        "sync_fail_num": 3,
        "creator": "woDkH9EAAAMdYPgCxGWMiXCHDjnNS3Qg",
        "multi_commit": 0,
        "ad_code": "110000",
        "qrcode_url": "https://qr.wshoto.com/qr/1703702408451883585.png",
        "form_url": "https://h5.wshoto.com/form/1703702408451883585",
        "short_url": "https://s.wshoto.com/f/abc123",
        "target_type": 1,
        "visible_dept_ids": ["1001"],
        "visible_user_ids": ["user456"],
        "allow_edit_submitted": 1,
        "allow_relate_user": 1
    }
}

返回说明:

参数 类型 说明
code string 出错返回码,为"00000"表示成功,其他表示调用失败
msg string 返回码描述
data object 收集表详情数据
id string 收集表ID
title string 收集表标题
material_id string 素材ID
template_id string 自定义字段模板id
form_status int 状态 0-暂存、1-已发布、10-已结束
gmt_create datetime 创建时间
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 指定使用区域
qrcode_url string 收集表投放二维码图片URL(默认轨迹形式)
form_url string 收集表投放链接URL
short_url string 收集表投放短链(已配置过企业域名的才会返回)
target_type int 填写对象:0-客户填写,1-员工填写;历史未设置类型的表单按 0 返回
visible_dept_ids string[] 员工填写时的可见部门ID列表
visible_user_ids string[] 员工填写时的可见员工ID列表
allow_edit_submitted int 允许编辑已提交内容:0-否,1-是
allow_relate_user int 员工填写时允许关联人员:0-否,1-是;客户表不使用该配置

说明:

  • 请求参数不变,无需传入填写对象类型。
  • 员工表详情会返回已配置的可见范围;可见部门和可见员工均无配置时,不限制可见范围。
  • sync_mode 对应客户数据同步功能;员工填写不执行该同步流程。

results matching ""

    No results matching ""