Ограничение скорости

Prev Next

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
:::

Feature rename

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

Как рассчитывается лимит?

Ограничения скорости применяются на уровне (экземпляра, таблицы, операции). Все служебные учетные записи на одном экземпляре используют один и тот же контейнер для данной таблицы и операции — создание дополнительных служебных учетных записей не увеличивает фактическое ограничение скорости.

Как я узнаю, что достиг лимита скорости?

Уведомления об ограничениях по скорости для таблиц отображаются в верхней части страницы каждой таблицы.

Когда вы достигнете 80 % лимита, вы увидите следующий предупреждающий баннер:Image{height="" width=""}Когда вы достигнете лимита, вы увидите следующий баннер с ошибкой:Image{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.Нашли ли вы то, что искали?}}