RevorRevor

实时订阅 Find More

GET/api/v2/websets/{webset_id}/find-more/stream

订阅一次指定 Find More job 的状态、策略和 Items 增量。需要 websets:read 权限。

请求

cURL
curl -N "https://revor.ai/api/v2/websets/WEBSET_ID/find-more/stream?job_id=JOB_ID&cursor=289&items_revision=18&match=qualified"   -H "Authorization: Bearer sk-revor-REPLACE_ME"   -H "Accept: text/event-stream"
参数必填说明
job_id是Find More 响应中的 item.id。
cursor与 revision 成对Find More 启动前快照的 stream_cursor。
items_revision与 cursor 成对Find More 启动前快照的 items_revision。
match否默认 qualified。

必须绑定本次 job_id。服务端会等待该 job 对应的新挖掘轮次真正出现,不会把上一轮残留的 completed 误判为本轮完成。

事件

该接口包含 Items SSE 的 ready、webset.state、webset.strategy、items.changed、reset、complete、reconnect 和 error,并增加以下事件。

find_more.state

JSON
{
  "webset_id": "webset-uuid",
  "job_id": "job-uuid",
  "job_status": "running",
  "run_observed": true
}

run_observed=true 表示本次 Find More 的新轮次已经被观察到。

find_more.failed

JSON
{
  "webset_id": "webset-uuid",
  "job_id": "job-uuid",
  "job_status": "failed",
  "error_code": "webset_find_more_failed"
}

当 job 在启动新轮次之前失败或取消时发送,随后关闭连接。若新轮次已经启动,最终结果以 items.changed 和 complete 为准。

ready、complete 和 reconnect 会额外包含 find_more_job_id。收到 complete 后即可结束;收到 reset 时重新读取完整 Items 快照。