レート制限

Prev Next

Tulipは、一貫性のある信頼性の高い体験を提供し、Tulipプラットフォーム上で高いパフォーマンスと可用性を確保するために、テーブルAPIにレート制限を適用しています。レート制限は、2026年春にかけてすべてのTulipインスタンスで段階的に導入される予定です。

テーブルのレート制限

Essentials、Professional、およびEnterpriseプランでは、ワークスペース内のテーブルごとに以下のレート制限が適用されます。

API カテゴリ レート制限値 エンドポイント
レコードの書き込み テーブルごとに 1 秒あたり 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)
レコードの削除 テーブルあたり 1 秒あたり 10 回の削除 DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord)
レコードの読み取り(個別) テーブルあたり 1 秒あたり 50 回の読み取り GET /api/v3/tables/:tableId/records/:recordId (getRecord)
レコードの読み取り(複数) テーブルあたり 1 秒あたり 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エラーを確認してください。以下の表と を参照することで、特定のサービスアカウントがレート制限に抵触している原因を特定するのに役立ちます。
  • 可能であれば、リクエストをバッチ処理してください。たとえば、一連のテーブルレコードのデータを取得する必要があるアプリがあるとします。レコードごとに個別のリクエストを送信する代わりに、必要なすべてのレコード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.
:::