指南
授權與限流
你只需要提供 appKey 與裝置驗證方式;SDK 會用裝置金鑰取得 30 分鐘有效的 token 並自動續期。appKey 是公開值,單獨持有換不到 token。
流程
- 第一次啟動時,SDK 在裝置上產生不可匯出的金鑰(iOS Secure Enclave、Android Keystore)。
- 以平台驗證證明「這是你的 App 在真實裝置上執行」:iOS 用 App Attest、Android 用 Play Integrity,換取 token。
- 之後只用裝置簽章續期,每 24 小時需重新驗證一次;全部由 SDK 處理。
- token 只存在記憶體,到期前 15 到 20 分鐘自動續期。
Web SDK 不做裝置驗證,由你的後端取得 token 後交給 tokenSource。
限流
- 以上為目前的起始值,會依試點實測調整。
- 「安裝」不是「裝置」:重裝 App 或清除資料就是新的安裝。
- 資料請求一律計入每日上限,包含回傳 304 的請求。唯一例外是
/v1/release/current帶目前的 ETag 而回 304(版本沒變)時,不計入每日次數,只計入每秒限流。請善用 SDK 的快取,不要在迴圈裡重複取同一份資料。 - 一般使用(打開個股、切換分頁)遠低於上限;前景每分鐘 1 次的換版輪詢在版本沒變時不占每日額度,一天只有實際換版的 1 到 2 次會計入。