Para manter o desempenho e a estabilidade ideais do sistema, a Conexão Saúde impõe limites de taxa às conexões de clientes com a API Health Connect.
Neste guia, descrevemos os limites impostos às operações de leitura e gravação da API na Conexão Saúde e como evitar a limitação de taxa com um design de app eficiente.
Limites da API
Os limites das operações de API em primeiro e segundo plano são limitados como cotas de taxa de solicitação fixas.
Os limites de taxa e memória são variáveis com base no tipo de operação que seu app está executando e se essa operação ocorre em primeiro ou segundo plano.
Limites de leitura e do registro de mudanças
Para os limites de leitura e do registro de mudanças, a Conexão Saúde impõe dois limites ao número de chamadas de API disponíveis para o app:
- Um limite periódico no número de chamadas que o app pode fazer para a API.
- Um limite diário para o número de chamadas de API que seu app pode fazer.
Limites de inserção, atualização e exclusão
A Conexão Saúde estabelece quatro limites distintos para operações de inserção, atualização e exclusão:
- Um limite periódico no número de chamadas que o app pode fazer para a API.
- Um limite diário para o número de chamadas que o app pode fazer para a API.
- Um limite de memória para inserções em massa.
- Um limite de memória para inserções de registro único.
Práticas recomendadas
Recomendamos que as interações do app com a API Health Connect sejam realizadas de uma forma que minimiza o uso da bateria, mantém a integridade ideal do sistema e promove o gerenciamento eficiente de dados em todas as operações CRUD.
Confira algumas práticas recomendadas a serem seguidas.
Chamadas de API em segundo plano
O uso da bateria para operações em segundo plano piora a experiência do usuário e levanta dúvidas sobre a privacidade de dados.
Dessa forma, a limitação da taxa de segundo plano é mais rigorosa do que a da taxa de primeiro plano. Portanto, é importante limitar a quantidade de chamadas de API que o app realiza em segundo plano.
Como processar exceções
Se o app encontrar uma exceção ao gravar dados na Conexão Saúde, recomendamos tentar de novo do ponto onde ela ocorreu.
Não basta excluir todos os dados em questão e repetir toda a solicitação de gravação. Essa abordagem consome sua cota de inserção, reduz o desempenho e tem um impacto negativo na duração da bateria.
Processamento do registro de mudanças
Para minimizar o risco da limitação de taxa do app, use o gerenciamento de registro de mudanças para sincronizar seu banco de dados com os dados da Conexão Saúde, em vez de depender demais de solicitações de leitura brutas.