API 总览

Revor AI API 支持查询已连接账号、创建触达任务、点赞 LinkedIn 相关帖子，以及查询任务结果。

Base URL

https://revor.ai/api/v1

鉴权

每个请求都必须携带 API Key。推荐使用 Authorization: Bearer header。

cURL复制
curl "https://revor.ai/api/v1/connect/accounts" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

也可以使用 x-api-key header。

cURL复制
curl "https://revor.ai/api/v1/connect/accounts" \
  -H "x-api-key: sk-revor-REPLACE_ME"

返回结构

成功响应包含 ok: true 和 request_id。列表接口返回 items，单个资源或任务接口返回 item。

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {}
}

错误响应包含 ok: false 和 error。排查问题时应保留 request_id。

JSON复制
{
  "ok": false,
  "error": {
    "code": "api_key_invalid",
    "message": "api_key_invalid",
    "request_id": "req_xxx"
  }
}

幂等

接口支持 Idempotency-Key。同一 API Key、同一路径、同一个 Idempotency-Key：

• 请求体相同：返回第一次请求的响应，不会创建新的任务。
• 请求体不同：返回 409 idempotency_conflict。

Idempotency-Key 适用于网络超时、连接中断或客户端重试等场景。每一次新的真实触达动作应使用新的 Idempotency-Key。

异步任务

创建触达任务和点赞 LinkedIn 帖子接口会返回 HTTP 202 Accepted。item.id 是任务 ID，可通过 GET /api/v1/outreach/jobs/{id} 查询最终结果。

限流

当请求过于频繁时，Revor AI 返回 429 api_rate_limit_exceeded。响应可能包含以下 headers：

接口列表

推荐流程

1. 调用 GET /api/v1/connect/accounts 查询可用账号。
2. 使用返回的 account_id 创建触达任务或 LinkedIn 点赞任务。
3. 读取创建接口返回的 item.id。
4. 调用 GET /api/v1/outreach/jobs/{id} 查询任务结果。

常见错误