查询触达任务

GET/api/v1/outreach/jobs/{id}

查询触达任务的状态和结果。该接口适用于以下接口返回的任务 ID：

• POST /api/v1/outreach/dispatches
• POST /api/v1/outreach/linkedin/post-likes

鉴权

请求必须使用创建任务时所属账号的 API Key。

Path 参数

请求示例

cURL复制
curl -X GET "https://revor.ai/api/v1/outreach/jobs/job_uuid" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

状态

响应示例

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job_uuid",
    "status": "succeeded",
    "action": "outreach.dispatch",
    "channel": "email",
    "scheduled_at": "2026-05-20T10:00:00.000Z",
    "started_at": "2026-05-20T10:00:01.000Z",
    "finished_at": "2026-05-20T10:00:08.000Z",
    "attempt_count": 1,
    "next_attempt_at": null,
    "result": {
      "account_id": "connect_account_xxx",
      "channel": "email",
      "action": "outreach",
      "resolved_action": "message",
      "message_id": "message_xxx",
      "status": "accepted"
    },
    "error": null
  }
}

响应字段

成功结果

outreach.dispatch 的 result.resolved_action 表示实际触达动作。

outreach.linkedin.post_like 的 result.status 表示点赞结果。

失败结果

任务执行失败时，该查询接口仍返回 HTTP 200，并在 item.status 和 item.error 中返回失败信息。

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job_uuid",
    "status": "failed",
    "action": "outreach.dispatch",
    "channel": "linkedin",
    "attempt_count": 2,
    "result": null,
    "error": {
      "code": "connect_account_reconnect_required",
      "message": "connect_account_reconnect_required",
      "retryable": false
    }
  }
}

请求错误

以下错误表示查询请求本身失败。