公開 API
限流與參數上限
各端點的預設限額、參數範圍與退避方式。
以下是應用程式預設值,實際限制可能受部署設定和邊緣規則影響。
欄位
型別
公開 RSS 的 limit 只接受無前導零的整數 1..100,重複、空值或格式錯誤回傳 400;預設 limit=100 會正規化為省略參數的 URL。個人 RSS 使用獨立規則。
RSS 的 q/search 與 Torznab 的 q 正規化後最多 160 個 UTF-8 位元組,/magnets 的 q 最多 300 字元。比對規則見資源搜尋。Bangumi 搜尋、季度標題查詢與標題匹配各有字元數限制,不能共用長度規則。公開 RSS 沒有 cursor/page 分頁;Torznab 使用有界 offset。
JSON 介面與種子下載的限流服務暫時無法計數時,回傳 503 SERVICE_UNAVAILABLE,帶 Retry-After: 15 與 Cache-Control: no-store,不回傳 429。這不表示請求過多,等待後重試即可。釋出端點(含 whoami)、/api/subtitle-groups/me 與同步狀態在校驗 Key 之前計數,因此帶有效 Key 的請求也可能收到這個 503。公開 RSS 與 Torznab 不適用此規則。
收到 429 時依 Retry-After 等待,單位為秒。公開 RSS 的 503 表示後端暫時無法使用,不是限流:應用程式回傳的 503 帶 Retry-After: 30 與 Cache-Control: no-store,不會以空 feed 代替,等待後重試即可。沒有此欄位的錯誤不能假定 2 秒後成功。普通 RSS 建議至少間隔 5 分鐘並避免並行請求;304 仍可能消耗額度。
