速率限制
取得 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，以更少的頁數讀取清單。 - 快取很少變動的內容：平台、門市、已連結的帳號。