2023-12-01 起,WebOffice 對建立專案的計費方式由按文檔開啟次數改為按API介面調用次數,涉及介面為擷取Weboffice憑證和重新整理Weboffice憑證。此前建立的專案不受影響,仍按開啟次數計費。
計費邏輯對比
開啟計費(2023-12-01 之前建立的專案):檔案開啟後與服務端建立長串連,串連斷開時產生一次計費。token 不限時間長度、不限使用者數量,同一個 token 可供多使用者多次開啟文檔,每次開啟均單獨計費。
介面計費(2023-12-01 之後建立的專案):每次調用 GenerateWebofficeToken 或 RefreshWebofficeToken 產生一次計費。單次調用擷取一個 token,該 token 有效期間為 30 分鐘,有效期間內可重複開啟文檔,不重複計費。每個 token 僅限單使用者使用——若多個使用者同時使用同一 token 開啟同一文檔,僅最後發起請求的使用者能正常開啟,之前使用者的存取權限將被收回。為避免此問題,每次開啟文檔時應為對應使用者擷取獨立的 token。
下表對比兩種計費模式的關鍵差異:
|
對比項 |
開啟計費(2023-12-01 之前) |
介面計費(2023-12-01 之後) |
|
適用專案 |
2023-12-01 之前建立的專案 |
2023-12-01 之後建立的專案 |
|
計費時機 |
使用者開啟文檔後串連斷開 |
調用 GenerateWebofficeToken 或 RefreshWebofficeToken |
|
token 有效期間 |
不限時間長度 |
30 分鐘 |
|
使用者限制 |
不限制,同一 token 可多使用者共用 |
單使用者,不同使用者須使用不同 token |
|
token 有效期間內重複開啟 |
每次開啟均計費 |
僅首次調用計費,有效期間內重複開啟不再計費 |
切換介面計費方案
切換至介面計費方案,需建立新專案並更新整合代碼。
在 IMM 控制台建立新專案,新專案預設使用介面計費模式。
-
修改代碼邏輯:每次使用者開啟文檔時,調用 GenerateWebofficeToken 擷取新的 token,並將該 token 僅傳遞給發起請求的使用者,不在多使用者間共用。
// 每次文檔開啟請求時產生新 token token = GenerateWebofficeToken(project=<new-project-id>, ...) // 將 token 僅傳遞給當前請求的使用者 將API調用中的 project 參數更新為新專案的 ID。