HTTP 注意事項

接口限流

📌為避免異常請求或者攻擊影響整體服務，我們對接口的請求進行了限制。

默認用戶總接口調用頻率為 800 次/分鐘。

如果 token 在 1 分鐘內超過限定請求次數，會被封禁，下一分鐘自動解封。

目前我們只會為深度合作的客戶提供更高請求頻率權限的 token，如有需要請聯絡商務。

接口更新

a. 請求接口，獲取初始化數據
*接入列表類接口，page（頁數）、per_page（每頁數據條數）為非必填參數，不填時，返回 1 頁 20 條

b. 數據更新，有 2 種方式獲取變化

通過 recent_update 字段，獲取數據變化

接入推送，獲取變化數據

空數據格式

字段類型為空時：
對象：null
數組：[]
字符串：""
整型：0
浮點型：0.0

API 權限規則

檢查用戶權限
a. 用戶密碼校驗 - 用戶或密碼錯誤
b. 用戶狀態校驗 - 用戶無權限

檢查 IP 白名單 - IP 未授權

檢查用戶請求總次數（時間段內） - 總次數超限

接口次數檢測（時間段內） - 接口超限

檢查接口權限（根據規則判斷列表還是詳情接口）
a. 列表接口
a1. 參數 sport_id（支持多個，以逗號分隔）檢測。
該參數無值，則取權限的 sport_id 作為參數，通過且往下傳遞。
該參數有值，與權限的 sport_id，如是子集則通過，有非交集則不通過 - 無權限
b. 詳情接口（路徑有規則帶有 sport_id）
b1. 取該 path 的 sport_id，與權限的 sport_id 比較，方法同上 - 無權限
b2. 參數 ids（暫定支持 10 個，以逗號分隔）檢測，超過 10 個 - 拒絕

HTTP 注意事項

接口限流#

接口更新#

空數據格式#

API 權限規則#

接口限流

接口更新

空數據格式

API 權限規則