查询异步任务

GET/api/v2/jobs/{id}

查询触达、研究、海关数据或 Target 启动任务。任务只能由所属用户读取，并且 API Key 仍需具有对应功能的读取权限。

请求示例

cURL
curl "https://revor.ai/api/v2/jobs/JOB_ID" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

任务状态

状态	是否终态	说明
`queued`	否	已接受，等待处理。
`scheduled`	否	已安排稍后处理。
`running`	否	正在执行。
`settling`	否	正在确认并保存结果。
`succeeded`	是	执行成功，可读取 `result`。
`failed`	是	执行失败，可读取 `error`。
`cancelled`	是	任务已取消。

响应示例

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job-uuid",
    "action": "research.public_web",
    "status": "succeeded",
    "progress": {
      "stage": "completed",
      "percent": 100
    },
    "resource": {
      "type": "company_research_job",
      "id": "job-uuid"
    },
    "scheduled_at": "2026-08-25T08:00:00.000Z",
    "started_at": "2026-08-25T08:00:01.000Z",
    "finished_at": "2026-08-25T08:00:05.000Z",
    "attempt_count": 1,
    "result": {},
    "error": null,
    "billing": {
      "status": "settled",
      "charged_credits": 5,
      "pending_units": 0
    }
  }
}

触达任务还会返回 channel，值为 email、linkedin 或 whatsapp。触达任务不按该接口额外扣费，billing.status 通常为 not_metered。

轮询建议

建议间隔 2 至 5 秒，并对网络错误使用指数退避。
404 task_not_found 不是“尚未创建完成”，不要无限重试错误的任务 ID。
只有 succeeded、failed、cancelled 是终态。
succeeded 时 result 为对象，error 为 null。
failed 时 result 为 null，error.code 是稳定错误标识。

Target 启动任务说明

POST /api/v2/websets 返回的 preparation_job.id 只用于确认 Target 是否成功启动。该任务为 succeeded 时，目标公司发现可能仍在进行。

要判断 Target 是否真正完成，必须查询：

Http
GET /api/v2/websets/{webset_id}