Tulip aplica límites de tasa a las API de tablas para ofrecer una experiencia coherente y fiable, y para garantizar un alto rendimiento y disponibilidad en la plataforma Tulip. La limitación de tasa se está implantando por fases en todas las instancias de Tulip durante la primavera de 2026.
Límites de tasa de las tablas
Para los planes Essentials, Professional y Enterprise, se aplican los siguientes límites de tasa por tabla dentro de un espacio de trabajo.
| Categoría de API | Valor del límite de tasa | Puntos finales |
|---|---|---|
| Escritura de registros | 10 escrituras por segundo por tabla | POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/records/:recordId/increment (incrementRecord) |
| Eliminación de registros | 10 eliminaciones por segundo por tabla | DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord) |
| Lectura de un registro (individual) | 50 lecturas por segundo por tabla | GET /api/v3/tables/:tableId/records/:recordId (getRecord) |
| Lectura de registros (múltiples) | 10 lecturas por segundo por tabla | GET /api/v3/tables/:tableId/runAggregation (runAggregation) GET /api/v3/tables/:tableId/records (listRecords) POST /api/v3/tables/:tableId/exportDataset (exportDataset) GET /api/v3/tables/:tableId/count (countRecords) |
:::(Info) NOTE: Some account plans will have custom configurations. This will be communicated to customers by Tulip Support or Customer Success Managers (CSM)
when applicable. If you are unsure, please contact support@tulip.co
:::
Prior to r383, Service Accounts were called "API Tokens".
¿Cómo se calcula el límite?
Los límites de tasa se aplican por (instancia, tabla, operación). Todas las cuentas de servicio de una misma instancia comparten el mismo cupo para una tabla y una operación determinadas; crear cuentas de servicio adicionales no aumenta el límite de tasa efectivo.
¿Cómo sabré si he alcanzado el límite de frecuencia?
Las notificaciones relativas a los límites de frecuencia de las tablas aparecen en la parte superior de la página de cada tabla.
Cuando alcances el 80 % del límite de tasa, verás el siguiente banner de advertencia:
{height="" width=""}Cuando hayas alcanzado el límite de tasa, verás el siguiente banner de error:
{height="" width=""}Los banners de advertencia/error reflejan un periodo móvil de 7 días. Una vez alcanzado el umbral, el banner permanece visible hasta 7 días después de que su uso vuelva a situarse por debajo del umbral. Los banners mostrarán una fecha de «último exceso» para indicar cuándo se superó el umbral por última vez
¿Qué debo hacer si supero el límite de tasa?
- Revisa el error 429. La tabla y te ayudarán a identificar por qué una cuenta de servicio concreta se está encontrando con límites de tasa.
- Agrupa las solicitudes en lotes si es posible. Por ejemplo, supongamos que tienes una aplicación que necesita recuperar datos de un conjunto de registros de una tabla. En lugar de enviar solicitudes individuales para cada registro, lo ideal sería enviar una única consulta que incluya todos los ID de registro (o criterios de filtrado) que necesites y, a continuación, procesar los resultados localmente en la aplicación.
- Almacena los resultados en caché. En lugar de enviar solicitudes frecuentes, almacena en caché los datos de una solicitud anterior. A continuación, actualiza los datos cuando se soliciten (por ejemplo, cuando un usuario quiera explícitamente actualizar los datos en una aplicación) o de forma periódica, respetando los límites de frecuencia.
- Asegúrate de que tu script gestiona correctamente las solicitudes con límite de frecuencia. Asegúrate de que tu script reintente las solicitudes de los usuarios tras un error 429.
:::(Info) NOTE: When calling an API via a connector function, the connector will automatically handle 429 responses, so no additional retry logic is required. External clients — scripts, automations hosted outside Tulip, or connectors calling Tulip's API from other platforms — must implement retry logic themselves.
:::
{{snippet.¿Has encontrado lo que buscabas?}}