限流与重试
能发多少请求,以及如何退避重试。
访问社交平台的接口
帖子、数据洞察、评论、账号连接详情这几类接口,每次请求都会调用社交平台的 API。平台额度由所有 LumiPath 用户共享,所以按分钟限流:
| 窗口 | 上限 |
|---|---|
| 每个用户、每个接口 | 120 次/分钟 |
| 每个用户、每个接口、每个连接 | 20 次/分钟 |
POST /api/v1/comments/reply | 30 次/分钟(用户和连接两个维度) |
这些响应在我们这边会缓存几分钟,所以对同一个连接每分钟轮询超过一次,基本拿不到新数据。
超限时返回:
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,重试解决不了。
如何重试
- 遇到
429:有Retry-After头就等这么多秒;没有就等到resetsAt;两者都没有就从 1 秒开始指数退避。 - 遇到
502 UPSTREAM_ERROR或500 INTERNAL_ERROR:指数退避加随机抖动重试(例如 1s、2s、4s、8s,大约 5 次后放弃)。 - 除
429外,不要重试其他 4xx 错误,同样的请求还会失败。 - 重试
POST /api/v1/social-posts时,带上同一个Idempotency-Key,避免重复发帖。