跳到正文
LumiPath API

限流与重试

能发多少请求,以及如何退避重试。

访问社交平台的接口

帖子、数据洞察、评论、账号连接详情这几类接口,每次请求都会调用社交平台的 API。平台额度由所有 LumiPath 用户共享,所以按分钟限流:

窗口上限
每个用户、每个接口120 次/分钟
每个用户、每个接口、每个连接20 次/分钟
POST /api/v1/comments/reply30 次/分钟(用户和连接两个维度)

这些响应在我们这边会缓存几分钟,所以对同一个连接每分钟轮询超过一次,基本拿不到新数据。

超限时返回:

HTTP/1.1 429 Too Many Requests
Retry-After: 37
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1763382000

{ "error": "RATE_LIMITED", "resetsAt": 1763382000000 }

resetsAt 是毫秒级 Unix 时间戳;X-RateLimit-Reset 是秒级。

自动化相关限制

部分自动化操作(例如 AI 生成策略)有单独的每用户限制,同样返回 429 RATE_LIMITED 和 resetsAt。 套餐额度用完则返回 402 QUOTA_EXCEEDED,重试解决不了。

如何重试

  1. 遇到 429:有 Retry-After 头就等这么多秒;没有就等到 resetsAt;两者都没有就从 1 秒开始指数退避。
  2. 遇到 502 UPSTREAM_ERROR 或 500 INTERNAL_ERROR:指数退避加随机抖动重试(例如 1s、2s、4s、8s,大约 5 次后放弃)。
  3. 除 429 外,不要重试其他 4xx 错误,同样的请求还会失败。
  4. 重试 POST /api/v1/social-posts 时,带上同一个 Idempotency-Key,避免重复发帖。

本页目录