A Tulip aplica limites de taxa às APIs de tabela para proporcionar uma experiência consistente e confiável e garantir alto desempenho e disponibilidade na plataforma Tulip. A implementação dos limites de taxa está ocorrendo em etapas em todas as instâncias da Tulip durante a primavera de 2026.
Limites de taxa para tabelas
Para os planos Essentials, Professional e Enterprise, os seguintes limites de taxa se aplicam por tabela dentro de um espaço de trabalho.
| Categoria de API | Valor do limite de taxa | Endpoints |
|---|---|---|
| Gravação de registros | 10 gravações por segundo por tabela | POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/records/:recordId/increment (incrementRecord) |
| Exclusão de registro | 10 exclusões por segundo por tabela | DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord) |
| Leitura de registro (individual) | 50 leituras por segundo por tabela | GET /api/v3/tables/:tableId/records/:recordId (getRecord) |
| Leitura de registro (múltipla) | 10 leituras por segundo por tabela | 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".
Como o limite é calculado?
Os limites de taxa são aplicados por (instância, tabela, operação). Todas as contas de serviço em uma única instância compartilham o mesmo bucket para uma determinada tabela e operação — a criação de contas de serviço adicionais não aumenta o limite de taxa efetivo.
Como saberei se atingi o limite de taxa?
Notificações sobre os limites de taxa das tabelas aparecem na parte superior da página de cada tabela.
Quando você atingir 80% do limite de taxa, verá o seguinte banner de aviso:
{height="" width=""}Quando você atingir o limite de taxa, verá o seguinte banner de erro:
{height="" width=""}Os banners de aviso/erro refletem um período móvel de 7 dias. Depois de atingir o limite, o banner permanece visível por até 7 dias após o uso voltar a ficar abaixo do limite. Os banners exibirão uma data de “última ultrapassagem” para indicar quando o limite foi ultrapassado pela última vez
O que devo fazer se exceder o limite de taxa?
- Analise o erro 429. A tabela e ajudarão você a identificar por que uma determinada conta de serviço está enfrentando limites de taxa.
- Agrupe as solicitações, se possível. Por exemplo, suponha que você tenha um aplicativo que precise buscar dados para um conjunto de registros de tabela. Em vez de enviar solicitações individuais para cada registro, é recomendável enviar uma única consulta que inclua todos os IDs de registro (ou critérios de filtragem) necessários — e, em seguida, processar os resultados localmente no aplicativo.
- Armazene os resultados em cache. Em vez de enviar solicitações frequentes, armazene em cache os dados de uma solicitação anterior. Em seguida, atualize os dados quando solicitado (como quando um usuário deseja explicitamente atualizar os dados em um aplicativo) ou periodicamente, de forma a respeitar os limites de taxa.
- Certifique-se de que seu script esteja lidando corretamente com solicitações limitadas por taxa. Certifique-se de que seu script repita as solicitações do usuário após o erro 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.Você encontrou o que estava procurando?}}