扩展更多潜客

POST/api/v2/websets/{webset_id}/find-more

在已有 Webset 上启动一轮新的挖掘。count 表示希望新增的数量，不是新的总数。需要 websets:write 权限，会消耗积分并异步执行。

调用前

先读完当前 Items 快照，保存第一页的 stream_cursor + items_revision。启动成功后，这对旧 checkpoint 用于订阅本次 Find More 的全部变化。

请求

Idempotency-Key 必填；网络重试复用同一个值。

cURL复制
curl -X POST "https://revor.ai/api/v2/websets/WEBSET_ID/find-more"   -H "Authorization: Bearer sk-revor-REPLACE_ME"   -H "Idempotency-Key: find-more-001"   -H "Content-Type: application/json"   -d '{"count":25}'

count 可为 25、100、500 或 1000，并受会员档位限制。

响应

HTTP 202：

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job-uuid",
    "action": "websets.find_more",
    "status": "queued",
    "progress": {
      "stage": "queued",
      "percent": 0
    },
    "resource": {
      "type": "webset",
      "id": "webset-uuid"
    },
    "scheduled_at": "2026-09-24T08:10:00.000Z",
    "started_at": null,
    "finished_at": null,
    "attempt_count": 0,
    "result": null,
    "error": null,
    "billing": {
      "status": "pending",
      "charged_credits": 0,
      "pending_units": 0
    }
  }
}

保存 item.id 作为 job_id，随后连接 Find More SSE。缺少幂等键返回 400 idempotency_key_required；同一个 Key 用于不同请求返回 409 idempotency_conflict。