Tulip применяет ограничения скорости к API таблиц, чтобы обеспечить стабильный и надёжный интерфейс, а также высокую производительность и доступность платформы Tulip. Ограничение скорости внедряется поэтапно во всех экземплярах Tulip весной 2026 года.
Ограничения скорости для таблиц
Для тарифных планов «Essentials», «Professional» и «Enterprise» применяются следующие ограничения скорости на каждую таблицу в рабочей области.
| Категория API | Значение ограничения скорости | Конечные точки |
|---|---|---|
| Запись записи | 10 операций записи в секунду на каждую таблицу | POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/records/:recordId/increment (incrementRecord) |
| Удаление записи | 10 удалений в секунду на каждую таблицу | DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord) |
| Чтение записи (отдельной) | 50 операций чтения в секунду на каждую таблицу | GET /api/v3/tables/:tableId/records/:recordId (getRecord) |
| Чтение записи (несколько записей) | 10 чтений в секунду на таблицу | 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".
Как рассчитывается лимит?
Ограничения скорости применяются на уровне (экземпляра, таблицы, операции). Все служебные учетные записи на одном экземпляре используют один и тот же контейнер для данной таблицы и операции — создание дополнительных служебных учетных записей не увеличивает фактическое ограничение скорости.
Как я узнаю, что достиг лимита скорости?
Уведомления об ограничениях по скорости для таблиц отображаются в верхней части страницы каждой таблицы.
Когда вы достигнете 80 % лимита, вы увидите следующий предупреждающий баннер:
{height="" width=""}Когда вы достигнете лимита, вы увидите следующий баннер с ошибкой:
{height="" width=""}Предупреждающие и ошибочные баннеры отображают данные за скользящий 7-дневный период. После достижения порога баннер остается видимым в течение 7 дней после того, как ваш уровень использования снова опустится ниже порога. На баннерах будет отображаться дата «последнего превышения», указывающая, когда порог был превышен в последний раз
Что делать, если превышен лимит скорости?
- Изучите ошибку 429. Таблица и помогут вам определить, почему для данной учетной записи службы действуют ограничения скорости.
- По возможности объединяйте запросы в пакеты. Например, предположим, у вас есть приложение, которому необходимо получить данные для набора записей таблицы. Вместо отправки отдельных запросов для каждой записи лучше отправить один запрос, включающий все необходимые идентификаторы записей (или критерии фильтрации), а затем обработать результаты локально в приложении.
- Кэшируйте результаты. Вместо отправки частых запросов кэшируйте данные из предыдущего запроса. Затем обновляйте данные либо по запросу (например, когда пользователь явно хочет обновить данные в приложении), либо периодически, соблюдая ограничения по частоте запросов.
- Убедитесь, что ваш скрипт правильно обрабатывает запросы с ограничением скорости. Убедитесь, что ваш скрипт повторяет попытки обработки запросов пользователей после ошибки 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.Нашли ли вы то, что искали?}}

