中介买家点击采集 POC

先验证「中介—买家记录」是否有效,再考虑关联屋主委托。

结论

项目已有明确的中介—买家记录关系:


    
    
    
  agent_customer.id       → customer_id,买家记录 ID
agent_customer.agent_id → 所属中介

当前代码已经使用 customer_id + agent_id 校验客户归属。因此,测试 token 可以直接绑定:


    
    
    
  agent_id + customer_id + token

不需要先绑定 entrust_id

需要注意:customer_id 唯一标记一条中介客户记录,不是跨中介统一真人 ID。同一名买家被不同中介录入时,会产生不同的 customer_id

API 1:生成测试短链接


    
    
    
  POST /entrust/viewing-verification/links

请求:


    
    
    
  {
  "customer_ids"
: [1089, 1090]
}

处理规则:

  1. 1. 中介 ID 从登录上下文取得。
  2. 2. 使用 customer_id + agent_id 校验客户归属。
  3. 3. 每个 customer_id 生成一个随机 token。
  4. 4. 相同中介和客户重复请求时返回原 token。

响应:


    
    
    
  {
  "links"
: [
    {

      "customer_id"
: 1089,
      "token"
: "aK9x2Qm4f7Bd",
      "short_url"
: "https://example.com/v/aK9x2Qm4f7Bd"
    }

  ]

}

API 2:记录客户端采集结果


    
    
    
  POST /entrust/viewing-verification/collect

请求:


    
    
    
  {
  "token"
: "aK9x2Qm4f7Bd",
  "client"
: "ios",
  "conditions"
: ["silent"],
  "data"
: {
    "idfv"
: "",
    "device_id"
: "",
    "browser_id"
: "",
    "cookie_id"
: "",
    "line_user_id"
: ""
  }

}
字段说明
clientweb_pcweb_touchiosandroidline
conditions无感、登录、授权、安装 App、LIFF 授权等取得条件
data客户端实际取得的数据;字段可扩展,候选 ID 允许为空

每次调用新增一条记录,重复请求不合并。服务端同时保存 IP、User-Agent、Referer、devicedeviceid 请求头。

两张新增表

表名关键字段用途
agent_customer_verification_linkagent_idcustomer_idtoken保存中介客户记录与 token 的关系
agent_customer_verification_collectlink_idclientconditionspayload、请求环境保存每次客户端采集结果

四类客户端调研内容

客户端候选唯一 ID重点前置条件
Web PC / 触屏cookie ID、localStorage ID、browser IDHTTPS、隐私模式、浏览器限制
iOSIDFV、App device ID、WebView cookie安装或唤起 App、系统授权
AndroidSSAID、OAID、App device ID、WebView cookie安装 App、设备厂商能力、授权
LINELINE user ID、LINE WebView cookieLIFF、登录和 profile 授权

重要边界