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。