先验证「中介—买家记录」是否有效,再考虑关联屋主委托。
项目已有明确的中介—买家记录关系:
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。
POST /entrust/viewing-verification/links请求:
{
"customer_ids": [1089, 1090]
}处理规则:
customer_id + agent_id 校验客户归属。customer_id 生成一个随机 token。响应:
{
"links": [
{
"customer_id": 1089,
"token": "aK9x2Qm4f7Bd",
"short_url": "https://example.com/v/aK9x2Qm4f7Bd"
}
]
}POST /entrust/viewing-verification/collect请求:
{
"token": "aK9x2Qm4f7Bd",
"client": "ios",
"conditions": ["silent"],
"data": {
"idfv": "",
"device_id": "",
"browser_id": "",
"cookie_id": "",
"line_user_id": ""
}
}
| 字段 | 说明 |
|---|---|
client | web_pc、web_touch、ios、android 或 line |
conditions | 无感、登录、授权、安装 App、LIFF 授权等取得条件 |
data | 客户端实际取得的数据;字段可扩展,候选 ID 允许为空 |
每次调用新增一条记录,重复请求不合并。服务端同时保存 IP、User-Agent、Referer、device 和 deviceid 请求头。
| 表名 | 关键字段 | 用途 |
|---|---|---|
agent_customer_verification_link | agent_id、customer_id、token | 保存中介客户记录与 token 的关系 |
agent_customer_verification_collect | link_id、client、conditions、payload、请求环境 | 保存每次客户端采集结果 |
| 客户端 | 候选唯一 ID | 重点前置条件 |
|---|---|---|
| Web PC / 触屏 | cookie ID、localStorage ID、browser ID | HTTPS、隐私模式、浏览器限制 |
| iOS | IDFV、App device ID、WebView cookie | 安装或唤起 App、系统授权 |
| Android | SSAID、OAID、App device ID、WebView cookie | 安装 App、设备厂商能力、授权 |
| LINE | LINE user ID、LINE WebView cookie | LIFF、登录和 profile 授权 |
agent_customer.device_id 与 agent_customer_viewing.device_id 是中介录入客户或带看时的提交设备,不是买家设备。customer_id 是中介客户记录 ID,不是认证后的真实买家 ID。