Ograniczanie szybkości

Prev Next

Tulip stosuje ograniczenia szybkości w interfejsach API tabel, aby zapewnić spójne i niezawodne działanie oraz zagwarantować wysoką wydajność i dostępność platformy Tulip. Ograniczenia szybkości są wprowadzane etapowo we wszystkich instancjach Tulip wiosną 2026 roku.

Limity częstotliwości dla tabel

W przypadku planów Essentials, Professional i Enterprise obowiązują następujące limity częstotliwości dla poszczególnych tabel w obrębie obszaru roboczego.

Kategoria API Wartość limitu częstotliwości Punkty końcowe
Zapis rekordów 10 operacji zapisu na sekundę na tabelę POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/records/:recordId/increment (incrementRecord)
Usuwanie rekordów 10 operacji usunięcia na sekundę na tabelę DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord)
Odczyt rekordu (pojedynczego) 50 odczytów na sekundę na tabelę GET /api/v3/tables/:tableId/records/:recordId (getRecord)
Odczyt rekordu (wiele) 10 odczytów na sekundę na tabelę 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
:::

Feature rename

Prior to r383, Service Accounts were called "API Tokens".

Jak obliczany jest limit?

Limity częstotliwości są egzekwowane na poziomie (instancji, tabeli, operacji). Wszystkie konta usługowe w ramach jednej instancji korzystają z tego samego puli dla danej tabeli i operacji — utworzenie dodatkowych kont usługowych nie zwiększa efektywnego limitu częstotliwości.

Skąd będę wiedzieć, czy osiągnąłem limit?

Powiadomienia dotyczące limitów częstotliwości dla tabel pojawiają się u góry strony każdej tabeli.

Po osiągnięciu 80% limitu częstotliwości wyświetli się następujący baner ostrzegawczy:Image{height="" width=""}Po osiągnięciu limitu częstotliwości wyświetli się następujący baner błędu:Image{height="" width=""}Banery ostrzegawcze i błędów odzwierciedlają 7-dniowe okno kroczące. Po osiągnięciu progu baner pozostaje widoczny przez maksymalnie 7 dni od momentu, gdy wykorzystanie spadnie poniżej progu. Banery będą wyświetlać datę „ostatniego przekroczenia”, wskazującą, kiedy po raz ostatni przekroczono próg

Co zrobić, jeśli przekroczę limit częstotliwości?

  • Sprawdź błąd 429. Tabela i pomogą Ci ustalić, dlaczego dane konto usługowe napotyka ograniczenia szybkości.
  • Jeśli to możliwe, grupuj żądania. Załóżmy na przykład, że masz aplikację, która musi pobrać dane dla zestawu rekordów tabeli. Zamiast wysyłać osobne żądania dla każdego rekordu, warto wysłać jedno zapytanie zawierające wszystkie potrzebne identyfikatory rekordów (lub kryteria filtrowania), a następnie przetworzyć wyniki lokalnie w aplikacji.
  • Zapisuj wyniki w pamięci podręcznej. Zamiast wysyłać częste żądania, zapisz dane z poprzedniego żądania w pamięci podręcznej. Następnie odświeżaj dane na żądanie (na przykład gdy użytkownik wyraźnie chce odświeżyć dane w aplikacji) lub okresowo, zgodnie z limitami częstotliwości.
  • Upewnij się, że skrypt poprawnie obsługuje żądania objęte limitami częstotliwości. Upewnij się, że skrypt ponawia próby realizacji żądań użytkownika po wystąpieniu błędu 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.Czy znalazłeś to, czego szukałeś?}}