응답 헤더에 현재 요청 한도 상태가 표시됩니다.
각 엔드포인트별 요청 한도는 아래 표에서 확인할 수 있습니다. 이러한 한도는 개발자 콘솔에서도 확인할 수 있습니다.
별도 표기가 없는 한, 한도는 15분 단위로 표시됩니다(예: “/24hrs” 또는 “/sec”).
요청 한도를 초과하면 429 응답을 받게 됩니다.
- 제한 윈도우가 언제 재설정되는지 확인하기 위해
x-rate-limit-reset값을 확인합니다. - 재시도하기 전에 해당 시점까지 대기합니다.
- 필요하다면 지수 백오프를 사용합니다.
응답 캐시
반복 요청을 줄이기 위해 결과를 로컬에 캐시합니다.
스트리밍 사용
실시간 데이터의 경우 폴링 대신 필터링된 스트림을 사용합니다.
헤더 모니터링
남은 요청 수를 추적해 요청 한도에 도달하지 않도록 합니다.
요청 분산
요청을 전체 시간 구간에 고르게 분산합니다.
요청 한도와 과금은 서로 별개입니다:
요청 한도 내에 있으면서도 사용량 요금이 청구될 수 있으며, 추가 비용 없이 요청 한도에 도달할 수도 있습니다.
Enterprise 고객에게는 전용 요청 한도가 적용됩니다. 계정 담당자에게 문의하거나 Enterprise 액세스를 신청하세요.
오류 처리
429 및 기타 errors를 적절히 처리하세요.
시작하기
액세스 수준과 기능에 대해 알아보세요.