Tulip 对表 API 实施了速率限制，以提供一致且可靠的体验，并确保 Tulip 平台的高性能和高可用性。速率限制功能将于 2026 年春季分阶段在所有 Tulip 实例中逐步推出。
表速率限制
对于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 错误。该表格和 将帮助您确定特定服务账户为何遇到速率限制。
- 如有可能，请批量发送请求。例如，假设您有一个应用程序需要获取一组表记录的数据。与其为每条记录单独发送请求，不如发送一个包含所有所需记录 ID（或筛选条件）的单一查询，然后在应用程序本地处理结果。
- 缓存结果。与其频繁发送请求，不如缓存先前请求获取的数据。随后，可在收到请求时（例如用户明确要求在应用中刷新数据时）刷新数据，或者按照符合速率限制的周期进行刷新。
- 确保您的脚本能正确处理受速率限制的请求。确保您的脚本在收到 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.
:::