Límites de tasa y reintentos automáticos
Cómo 2sync maneja los límites de tasa de API de Notion, Google y Microsoft
2sync se comunica con APIs externas (Notion, Google, Microsoft, Todoist) en cada ciclo de sincronización. Estas APIs imponen límites de tasa para prevenir sobrecarga. 2sync maneja los límites de tasa automáticamente con reintentos y retroceso, para que tus datos se sincronicen de forma confiable sin intervención manual.
¿Qué son los límites de tasa?
Los límites de tasa son restricciones establecidas por los proveedores de API sobre cuántas solicitudes puede hacer una aplicación en un período de tiempo dado. Cuando 2sync alcanza un límite de tasa, la API rechaza temporalmente solicitudes adicionales hasta que el límite se restablece.
Cada proveedor tiene límites diferentes:
| Proveedor | Comportamiento |
|---|---|
| Notion | Limita solicitudes por integración por segundo |
| Limita cuota por usuario en Calendar, Tasks, Contacts y Gmail | |
| Microsoft | Limita por aplicación y por usuario en servicios de Outlook |
| Todoist | Limita solicitudes por usuario por minuto |
¿Cómo maneja 2sync los límites de tasa?
2sync usa retroceso exponencial para todos los reintentos. Cuando se alcanza un límite de tasa:
- La sincronización se pausa para la API afectada
- 2sync espera un intervalo creciente antes de reintentar (1s, 2s, 4s, 8s, etc.)
- Los reintentos continúan hasta que la API acepta solicitudes nuevamente
- La sincronización se reanuda desde donde se pausó
Este proceso completo es transparente. No necesitas hacer clic en nada ni reiniciar tu automatización.
Los límites de tasa no son errores. Son comportamiento normal de la API durante operaciones de alto volumen. 2sync está diseñado para trabajar dentro de estos límites automáticamente.
¿Qué activa los límites de tasa?
Los límites de tasa son más probables durante:
- Sincronización inicial de una base de datos grande (cientos o miles de elementos)
- Cambios masivos aplicados a muchos elementos a la vez
- Múltiples automatizaciones sincronizando el mismo proveedor simultáneamente
- Otras aplicaciones usando la misma cuota de API en tu cuenta
¿Cómo ayuda el procesamiento por lotes?
Para operaciones de sincronización grandes, 2sync agrupa cambios en lotes en lugar de enviar una solicitud por elemento. Esto reduce el número total de llamadas a la API y mantiene las operaciones dentro de los límites de tasa de forma más efectiva.
Los tamaños de lote se ajustan dinámicamente según el proveedor y el estado actual del límite de tasa.
¿Qué debo esperar durante sincronizaciones de alto volumen?
Durante la configuración inicial o después de una pausa prolongada, 2sync puede necesitar procesar miles de elementos. En estos casos:
- Los tiempos de sincronización pueden ser más largos que el ciclo habitual
- El estado de la automatización muestra Sincronizando durante un período extendido
- Todos los elementos se sincronizarán eventualmente; no se necesita intervención manual
Si ves un error "Límite de tasa" en tu automatización, significa que el ciclo de sincronización actual se pausó debido a los límites de la API. La siguiente sincronización programada procederá normalmente. No se pierden datos.
¿Cómo reduzco el impacto de los límites de tasa?
Reduce tu ventana de tiempo: Sincronizar 6 meses de eventos requiere menos llamadas a la API que 2 años.
Usa filtros: Excluye elementos que no necesitas. Menos elementos sincronizados significa menos solicitudes a la API por ciclo.
Escalona las automatizaciones: Si ejecutas múltiples automatizaciones para el mismo proveedor, considera tiempos de sincronización ligeramente diferentes para distribuir la carga.
Evita cambios masivos justo antes de una sincronización: Si modificas cientos de elementos, deja que se complete un ciclo de sincronización antes de hacer más cambios.
Antes de habilitar una sincronización grande por primera vez, ejecuta una Ejecución de prueba para estimar la cantidad de cambios. Esto te ayuda a anticipar cuánto tardará la sincronización inicial y si los límites de tasa serán un factor. Consulta Configuración avanzada de sincronización para detalles.
Relacionado
- Códigos de error para resolver estados de Límite de tasa y otros errores
- Configuración avanzada de sincronización para controlar el comportamiento de lotes y el tiempo de sincronización
- Problemas de sincronización para solucionar sincronizaciones lentas o detenidas
- Planes y precios para diferencias de frecuencia de sincronización por plan
Preguntas frecuentes
¿Necesito hacer algo cuando 2sync alcanza un límite de tasa?
No. 2sync maneja los límites de tasa automáticamente usando retroceso exponencial. La sincronización se pausa brevemente y se reanuda cuando la API lo permite. No se necesita ninguna acción manual.
¿Los límites de tasa causan pérdida de datos?
No. Los límites de tasa solo ralentizan la sincronización temporalmente. Todos los cambios pendientes se ponen en cola y se procesan una vez que el límite se restablece. Nada se omite ni se pierde.
¿Por qué mi primera sincronización está tardando tanto?
Las sincronizaciones iniciales procesan toda tu base de datos dentro de la ventana de tiempo configurada. Esto puede significar miles de llamadas a la API, lo que puede activar límites de tasa y requerir múltiples ciclos de reintento. Las sincronizaciones posteriores solo procesan cambios y son mucho más rápidas.
¿Puedo aumentar mis límites de tasa de API?
Los límites de tasa son establecidos por los proveedores de API (Google, Microsoft, Notion), no por 2sync. 2sync opera dentro de estos límites y optimiza las solicitudes para minimizar el impacto. No hay configuración para aumentarlos.
Estoy teniendo problemas de límites de tasa con Notion. ¿Qué puedo hacer?
Los límites de tasa de Notion dependen del tamaño de tu base de datos. Si alcanzas los límites frecuentemente, reduce la cantidad de elementos sincronizados acortando tu período de sincronización o agregando filtros. La mayoría de las sincronizaciones tienen éxito después de los reintentos automáticos, pero los problemas persistentes con bases de datos muy grandes pueden requerir dividir los datos en múltiples bases de datos.