Quotas and limits
본 문서는 Cloud 버전의 Quotas and limits 에 대해 다룹니다.
Cloud 버전에만 이 정책이 적용되며, Self-Hosted 로 구축된 경우 별도의 Quota 정책이 존재하지 않습니다.
Quotas and limits
안정적인 서비스 운영을 위해 각 프로젝트 별로 Quota를 가지고 있습니다.
프로젝트 생성시 기본 Quotas
처음 프로젝트를 생성하면 다음과 같은 Quota를 가지고 있으며 별도의 요청을 통하여 Quota를 증가 시킬 수 있습니다.
- 유효 운송장 번호 개수 : 1,000 건 / 월 [1]
- 동시에 활성화 되어있는 Track Webhook 개수 : 30 건 [2]
- API Call Rate Limit : 10 건 / 초 [3]
Quota 가 추가로 필요하신 경우 contact@tracker.delivery 로 문의 바랍니다.
Important
주어진 Quota를 정확히 꽉 채워 사용하는 것을 지양해야 하며 일부 여유 범위를 두고 사용하는 것을 권장 합니다. 여러 요인과 Quota 종류에 따라 허용된 Quota 범위를 일부 넘겨도 즉시 차단되지 않을 수 있으며, 반대로 주어진 Quota를 초과 사용하여 차단 되었다가 허용 범위로 돌아오더라도 차단 해제 반영에는 시간이 소요될 수 있습니다.
[1] 유효 운송장 번호 개수
Query.track API 에 사용된 고유 운송장 번호 개수를 의미 합니다. 존재하는 운송장 번호만 카운팅 되며, 동일 운송장 번호에 대해서는 월 1회만 카운팅 됩니다.
[2] 동시에 활성화 되어있는 Track Webhook 개수
Mutation.registerTrackWebhook API 를 통해 동시에 추적 가능한 활성화된 Webhook 개수를 의미합니다. Quota를 초과하는 경우 Mutation.registerTrackWebhook 에 새로운 Webhook 을 등록 시도하는 경우 에러가 발생하며, 기존 Webhook 을 제거하면 일정 시간 이후 다시 등록이 가능합니다.
[3] API Call Rate Limit
API Call 횟수 제한 입니다. Webhook API 사용을 통해 API Call Rate Limit 증가가 필요없는 경우가 많습니다.