A partir de 1º de dezembro de 2023, o WebOffice cobra por chamada de API em vez de cobrar por abertura de documento. Essa alteração se aplica apenas a projetos criados nessa data ou posteriormente. Projetos criados antes de 1º de dezembro de 2023 mantêm o modelo de cobrança por abertura.
Comparação entre modelos de faturamento
No modelo de cobrança por chamada, cada solicitação para GenerateWebofficeToken ou RefreshWebofficeToken gera uma cobrança. Cada token tem validade de 30 minutos e permite que apenas um usuário abra o documento. Se vários usuários tentarem usar o mesmo token de acesso para abrir o mesmo documento, somente o último solicitante conseguirá acessá-lo. As permissões concedidas aos usuários anteriores são revogadas. Para evitar falhas de acesso quando múltiplos usuários precisarem acessar o documento, gere um token separado para cada usuário sempre que ele abrir o documento.
|
Descrição |
Cobrança por abertura (antes de 1º de dezembro de 2023) |
Cobrança por chamada (em ou após 1º de dezembro de 2023) |
|
Projetos afetados |
Projetos criados antes de 1º de dezembro de 2023 |
Projetos criados em ou após 1º de dezembro de 2023 |
|
Momento da cobrança |
Abertura de documento pelo usuário (estabelecimento e posterior desconexão). |
Chamada de GenerateWebofficeToken ou RefreshWebofficeToken. |
|
Validade do token |
Sem limite. O token permanece válido indefinidamente. |
30 minutos por token. |
|
Acesso multiusuário |
Vários usuários podem compartilhar um único token. |
Um token por usuário por vez. Usuários adicionais precisam de tokens separados. |
|
Aberturas repetidas dentro da validade do token |
Cada abertura gera uma cobrança. |
Apenas a primeira chamada é cobrada. Reabrir o documento dentro de 30 minutos é gratuito. |
Migrar para o plano de cobrança por chamada
Para adotar a cobrança por chamada, crie um novo projeto e atualize sua integração para utilizá-lo.
Crie um novo projeto no console do IMM. Novos projetos usam a cobrança por chamada por padrão.
-
Atualize seu código para chamar GenerateWebofficeToken sempre que um usuário abrir um documento e forneça o token retornado exclusivamente a esse usuário. Não reutilize tokens entre diferentes usuários.
// Generate a new token for each document open request token = GenerateWebofficeToken(project=<new-project-id>, ...) // Pass token to the requesting user only Atualize o parâmetro
projectnas chamadas de API para referenciar o novo projeto.