深色模式

指南

授權與限流

你只需要提供 appKey 與裝置驗證方式;SDK 會用裝置金鑰取得 30 分鐘有效的 token 並自動續期。appKey 是公開值,單獨持有換不到 token。

流程

  1. 第一次啟動時,SDK 在裝置上產生不可匯出的金鑰(iOS Secure Enclave、Android Keystore)。
  2. 以平台驗證證明「這是你的 App 在真實裝置上執行」:iOS 用 App Attest、Android 用 Play Integrity,換取 token。
  3. 之後只用裝置簽章續期,每 24 小時需重新驗證一次;全部由 SDK 處理。
  4. token 只存在記憶體,到期前 15 到 20 分鐘自動續期。

Web SDK 不做裝置驗證,由你的後端取得 token 後交給 tokenSource。

待確認:正式環境的授權服務仍在規劃中,目前 staging 只接受開發用驗證。appKey 申請方式待定。

限流

項目
上限
超過時
每個安裝、每秒
10 次,可突發 30 次
429 RATE_LIMITED,帶 Retry-After
每個安裝、每日
3,000 次
429 QUOTA_EXCEEDED,台北時間次日 00:00 恢復
每個 App、每秒
3,000 次
429 RATE_LIMITED
  • 以上為目前的起始值,會依試點實測調整。
  • 「安裝」不是「裝置」:重裝 App 或清除資料就是新的安裝。
  • 資料請求一律計入每日上限,包含回傳 304 的請求。唯一例外是 /v1/release/current 帶目前的 ETag 而回 304(版本沒變)時,不計入每日次數,只計入每秒限流。請善用 SDK 的快取,不要在迴圈裡重複取同一份資料。
  • 一般使用(打開個股、切換分頁)遠低於上限;前景每分鐘 1 次的換版輪詢在版本沒變時不占每日額度,一天只有實際換版的 1 到 2 次會計入。

超過上限的處理見 錯誤處理與重試;底層端點見 HTTP API。