查找并解锁展会

当集成需要从展会发现进入完整数据访问时，请使用本指南。 Lensmor 允许先查看 Exhibitor 和 Personnel 预览，再选择实际需要的访问层。Visitor 是通过主办方或数据合作伙伴获得的注册参会访客，只有部分展会提供。

1. 搜索展会

curl "https://platform.lensmor.com/external/events/list?keyword=retail&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

2. 获取展会详情

curl "https://platform.lensmor.com/external/events/139574" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

解锁前请确认 name、dateStart、dateEnd、venue、country 和 url。

3. 查看展会范围人员

curl "https://platform.lensmor.com/external/personnel/list?event_id=139574&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

示例响应中的人员可以带有来源标签：

{
  "items": [
    {
      "id": "789",
      "fullName": "Jane Doe",
      "title": "VP of Partnerships",
      "companyName": "Example Retail Co",
      "sourceType": ["exhibitor", "social"],
      "email": null,
      "contactUnlockStatus": "locked"
    }
  ],
  "semantics": {
    "accessMode": "preview",
    "previewLimit": 50,
    "unlock": {
      "requiredForMoreResults": true,
      "actionType": "unlock_event_personnel",
      "credits": 2000
    }
  }
}

semantics.accessMode 只描述基础 Event Access。即使它为 "full"，也不能据此判断 Visitor Access 已解锁。

4. 解锁基础 Event Access

curl -X POST "https://platform.lensmor.com/external/events/139574/unlock" \
  -H "Authorization: Bearer $LENSMOR_API_KEY" \
  -H "x-call-source: api"

第一次成功解锁通常消耗 2000 Credits；重复解锁不重复收费。以接口响应和商业协议为最终计费依据。

5. 增加 Visitor Access 或解锁 Full Access

POST /external/events/:id/visitors/unlock：在基础 Event Access 已存在、账号有有效订阅且展会有 Visitor 数据时，第一次成功解锁消耗 3000 Credits。
POST /external/events/:id/full-access/unlock：一次性补齐缺失访问层，动态消耗 0、2000、3000 或 5000 Credits。

执行前调用 precheck：

curl -X POST "https://platform.lensmor.com/external/actions/precheck" \
  -H "Authorization: Bearer $LENSMOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_type": "unlock_event_full_access",
    "call_source": "api",
    "params": {
      "event_id": "139574"
    }
  }'

只有 allowed 为 true 时才继续，并向用户展示返回的 credits。通过 detail.visitor_data_available 判断 Visitor 数据是否可用。如果 Full Access precheck 因没有 Visitor 数据返回 no_contacts_available，但仍需要 Exhibitor/Personnel 覆盖，可以改用基础 Event Access。

常见错误

未检查 Preview 内容就直接解锁。
把 semantics.accessMode: "full" 当作 Visitor Access 已解锁。
把 Social Signals 当作主办方正式注册证明；当前只有 Visitor 标签代表注册参会访客。
Visitor 解锁前没有先获得基础 Event Access。
对付费操作自动重试，导致用户难以核对最终状态。

开始使用

参会人员数据

访问与数据补全

查找并解锁展会

推荐流程

1. 搜索展会

2. 获取展会详情

3. 查看展会范围人员

4. 解锁基础 Event Access

5. 增加 Visitor Access 或解锁 Full Access

常见错误

相关文档

​推荐流程

​1. 搜索展会

​2. 获取展会详情

​3. 查看展会范围人员

​4. 解锁基础 Event Access

​5. 增加 Visitor Access 或解锁 Full Access

​常见错误

​相关文档

推荐流程

1. 搜索展会

2. 获取展会详情

3. 查看展会范围人员

4. 解锁基础 Event Access

5. 增加 Visitor Access 或解锁 Full Access

常见错误

相关文档