速率限制
获取 API 密钥Sofia API 在三个窗口内统计请求：15 分钟、24 小时和 30 天。
| 令牌 | 15 分钟 | 24 小时 | 30 天 |
|---|---|---|---|
| 个人密钥（按账号） | 150 | 1,000 | 10,000 |
| OAuth 客户端 | 100 | 500 | 15,000 |
| OAuth 客户端，每位已授权用户（最多 1,000） | +10 | +25 | +100 |
请求头
每个响应都会按 IETF 格式告诉你剩余额度：
RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000r 是剩余请求数，t 是窗口重置前的秒数，q 是配额，w 是窗口时长（秒）。
当窗口用尽时
响应为 429 rate_limit_exceeded，附带 Retry-After 请求头，并在 details 中给出已用尽的窗口。请等待相应时间后再重试。
高效使用 API
- 注册 webhook，而不是轮询帖子。
- 将
limit设为最高 100，以更少的页数读取列表。 - 缓存很少变化的内容：平台、门店、已连接的账号。