속도 제한

Tulip은 일관되고 안정적인 경험을 제공하고 Tulip 플랫폼에서 높은 성능과 가용성을 보장하기 위해 테이블 API에 속도 제한을 적용합니다. 속도 제한은 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
:::

Feature rename

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