Limites de taxa e tentativas automáticas
Como o 2sync lida com limites de taxa de API do Notion, Google e Microsoft
O 2sync se comunica com APIs externas (Notion, Google, Microsoft, Todoist) em cada ciclo de sincronização. Essas APIs impõem limites de taxa para evitar sobrecarga. O 2sync lida com limites de taxa automaticamente com tentativas e recuo exponencial, para que seus dados sincronizem de forma confiável sem intervenção manual.
O que são limites de taxa?
Limites de taxa são restrições definidas por provedores de API sobre quantas solicitações um aplicativo pode fazer em um determinado período. Quando o 2sync atinge um limite de taxa, a API rejeita temporariamente solicitações adicionais até que o limite seja redefinido.
Cada provedor tem limites diferentes:
| Provedor | Comportamento |
|---|---|
| Notion | Limita solicitações por integração por segundo |
| Limita cota por usuário em Calendar, Tasks, Contacts e Gmail | |
| Microsoft | Limita por aplicativo e por usuário em serviços do Outlook |
| Todoist | Limita solicitações por usuário por minuto |
Como o 2sync lida com limites de taxa?
O 2sync usa recuo exponencial para todas as tentativas. Quando um limite de taxa é atingido:
- A sincronização pausa para a API afetada
- O 2sync aguarda um intervalo crescente antes de tentar novamente (1s, 2s, 4s, 8s, etc.)
- As tentativas continuam até que a API aceite solicitações novamente
- A sincronização retoma de onde parou
Este processo é totalmente transparente. Você não precisa clicar em nada ou reiniciar sua automação.
Limites de taxa não são erros. São comportamento normal de API durante operações de alto volume. O 2sync é projetado para trabalhar dentro desses limites automaticamente.
O que aciona limites de taxa?
Limites de taxa são mais prováveis durante:
- Sincronização inicial de um banco de dados grande (centenas ou milhares de itens)
- Alterações em massa aplicadas a muitos itens de uma vez
- Múltiplas automações sincronizando o mesmo provedor simultaneamente
- Outros aplicativos usando a mesma cota de API na sua conta
Como o processamento em lote ajuda?
Para grandes operações de sincronização, o 2sync agrupa alterações em lotes em vez de enviar uma solicitação por item. Isso reduz o número total de chamadas de API e mantém as operações dentro dos limites de taxa de forma mais eficaz.
Os tamanhos dos lotes se ajustam dinamicamente com base no provedor e no status atual do limite de taxa.
O que devo esperar durante sincronizações de alto volume?
Durante a configuração inicial ou após uma longa pausa, o 2sync pode precisar processar milhares de itens. Nesses casos:
- Os tempos de sincronização podem ser mais longos que o ciclo usual
- O status da automação mostra Sincronizando por um período prolongado
- Todos os itens serão eventualmente sincronizados; nenhuma intervenção manual é necessária
Se você vir um erro de "Limite de Taxa" na sua automação, significa que o ciclo de sincronização atual foi pausado devido a limites de API. O próximo ciclo agendado prosseguirá normalmente. Nenhum dado é perdido.
Como reduzo o impacto dos limites de taxa?
Restrinja sua janela de tempo: Sincronizar 6 meses de eventos requer menos chamadas de API do que 2 anos.
Use filtros: Exclua itens que você não precisa. Menos itens sincronizados significa menos solicitações de API por ciclo.
Escalone automações: Se você executa múltiplas automações para o mesmo provedor, considere horários de sincronização ligeiramente diferentes para distribuir a carga.
Evite alterações em massa logo antes de uma sincronização: Se você modificar centenas de itens, deixe um ciclo de sincronização completar antes de fazer mais alterações.
Antes de ativar uma grande sincronização pela primeira vez, execute uma Simulação para estimar o número de alterações. Isso ajuda a antecipar quanto tempo a sincronização inicial levará e se os limites de taxa serão um fator. Veja Configurações avançadas de sincronização para detalhes.
Relacionados
- Códigos de erro para resolver status de Limite de Taxa e outros erros
- Configurações avançadas de sincronização para controlar comportamento de lotes e timing de sincronização
- Problemas de sincronização para solucionar sincronizações lentas ou travadas
- Planos e preços para diferenças de frequência de sincronização por plano
FAQ
Preciso fazer algo quando o 2sync atinge um limite de taxa?
Não. O 2sync lida com limites de taxa automaticamente usando recuo exponencial. A sincronização pausa brevemente e retoma quando a API permite. Nenhuma ação manual é necessária.
Limites de taxa causam perda de dados?
Não. Limites de taxa apenas desaceleram a sincronização temporariamente. Todas as alterações pendentes são enfileiradas e processadas quando o limite é redefinido. Nada é pulado ou perdido.
Por que minha primeira sincronização está demorando tanto?
Sincronizações iniciais processam todo o seu banco de dados dentro da janela de tempo configurada. Isso pode significar milhares de chamadas de API, que podem acionar limites de taxa e exigir múltiplos ciclos de tentativas. Sincronizações subsequentes processam apenas alterações e são muito mais rápidas.
Posso aumentar meus limites de taxa de API?
Limites de taxa são definidos pelos provedores de API (Google, Microsoft, Notion), não pelo 2sync. O 2sync opera dentro desses limites e otimiza solicitações para minimizar o impacto. Não há configuração para aumentá-los.
Estou enfrentando problemas de limite de taxa com o Notion. O que posso fazer?
Limites de taxa do Notion dependem do tamanho do seu banco de dados. Se você atinge limites frequentemente, reduza o número de itens sincronizados restringindo seu período de sincronização ou adicionando filtros. A maioria das sincronizações é bem-sucedida após tentativas automáticas, mas problemas persistentes com bancos de dados muito grandes podem exigir dividir dados em múltiplos bancos de dados.