Tulip applica limiti di velocità alle API delle tabelle per garantire un’esperienza coerente e affidabile e assicurare prestazioni elevate e disponibilità sulla piattaforma Tulip. La limitazione della velocità verrà implementata gradualmente su tutte le istanze di Tulip nel corso della primavera del 2026.
Limiti di velocità per le tabelle
Per i piani Essentials, Professional ed Enterprise, si applicano i seguenti limiti di velocità per ogni tabella all’interno di un’area di lavoro.
| Categoria API | Valore del limite di velocità | Endpoint |
|---|---|---|
| Scrittura di record | 10 scritture al secondo per tabella | POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/record/:recordId/increment (incrementRecord) |
| Cancellazione di record | 10 cancellazioni al secondo per tabella | DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord) |
| Lettura di un record (singolo) | 50 letture al secondo per tabella | GET /api/v3/tables/:tableId/records/:recordId (getRecord) |
| Lettura record (multipla) | 10 letture al secondo per tabella | 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".
Come viene calcolato il limite?
I limiti di frequenza vengono applicati per (istanza, tabella, operazione). Tutti gli account di servizio su una singola istanza condividono lo stesso bucket per una determinata tabella e operazione: la creazione di account di servizio aggiuntivi non aumenta il limite di frequenza effettivo.
Come faccio a sapere se ho raggiunto il limite di frequenza?
Le notifiche relative ai limiti di frequenza delle tabelle vengono visualizzate nella parte superiore della pagina di ciascuna tabella.
Quando raggiungi l’80% del limite di frequenza, vedrai il seguente banner di avviso:
{height="" width=""}Quando raggiungi il limite di frequenza, vedrai il seguente banner di errore:
{height="" width=""}I banner di avviso/errore riflettono una finestra mobile di 7 giorni. Una volta raggiunta la soglia, il banner rimane visibile per un massimo di 7 giorni dopo che l’utilizzo è sceso nuovamente al di sotto della soglia. I banner mostreranno una data di “ultimo superamento” per indicare quando la soglia è stata superata l’ultima volta
Cosa devo fare se supero il limite di frequenza?
- Esamina l’errore 429. La tabella e ti aiuteranno a identificare il motivo per cui un determinato account di servizio sta riscontrando limiti di frequenza.
- Se possibile, raggruppa le richieste. Ad esempio, supponiamo che tu abbia un’app che deve recuperare dati per un insieme di record di una tabella. Anziché inviare richieste singole per ogni record, ti conviene inviare un’unica query che includa tutti gli ID dei record (o i criteri di filtraggio) necessari, per poi elaborare i risultati localmente nell’app.
- Metti in cache i risultati. Anziché inviare richieste frequenti, memorizza nella cache i dati provenienti da una richiesta precedente. Successivamente, aggiorna i dati quando richiesto (ad esempio quando un utente desidera esplicitamente aggiornare i dati in un’app) oppure a intervalli periodici che rispettino i limiti di frequenza.
- Assicurati che lo script gestisca correttamente le richieste soggette a limiti di frequenza. Assicurati che lo script riprovi a elaborare le richieste degli utenti dopo un errore 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.Hai trovato quello che cercavi?}}