RevorRevor

潜在客户发现

Revor AI 根据自然语言条件持续查找符合要求的企业或人物，并把结果保存为可分页、可实时订阅的潜客名单。API 中使用 websets / webset 表示这份名单。

推荐流程

创建新名单

  1. 调用 POST /websets 创建名单，保存 webset.id。
  2. 调用 GET /websets/{id}/items 获取权威快照。
  3. 使用快照的 stream_cursor + items_revision 连接 Items SSE。
  4. 按 items.changed 更新本地结果，收到 complete 后结束。
  5. 收到 reset 时重新读取快照并用新 checkpoint 建立连接。

扩展更多结果

  1. 读完当前 Items 快照并保存第一页返回的 checkpoint。
  2. 调用 POST /websets/{id}/find-more，保存 item.id。
  3. 使用该 job_id 和旧 checkpoint 连接 Find More SSE。
  4. 应用增量，收到 complete 后结束。

先取快照、再建流可以覆盖两个请求之间发生的变化。SSE 不传 checkpoint 时只接收连接之后的变化，不返回完整快照。

接口

方法与路径说明
POST /api/v2/websets创建企业或人物潜客名单。
GET /api/v2/websets分页查询当前用户的名单。
GET /api/v2/websets/{id}查询名单状态、条件和进度。
GET /api/v2/websets/{id}/strategy读取条件和搜索策略。
GET /api/v2/websets/{id}/items分页读取权威结果快照。
GET /api/v2/websets/{id}/items/stream实时读取状态、策略和 Item 增量。
POST /api/v2/websets/{id}/find-more在已有名单上继续挖掘。
GET /api/v2/websets/{id}/find-more/stream订阅指定 Find More 任务。

权限

读取接口和 SSE 需要 websets:read；创建和 Find More 需要 websets:write。资源按 API Key 所属用户隔离；访问其他用户的 ID 返回 404 webset_not_found。

状态

Text
draft | generating_criteria | ready | queued | searching | verifying |
completed | failed | cancelled

preparation_job 只表示创建或 Find More 是否成功启动。Webset 状态才表示潜客挖掘是否完成。

两种游标

  • REST 响应的 next_cursor 是不透明分页游标，只能原样用于下一页。
  • stream_cursor 是数字 SSE 事件游标，必须和 items_revision 成对保存。
  • 两种 cursor 不能混用。