GetQR API는 베타 버전이며 일부 워크스페이스에서만 사용할 수 있습니다. 정식 출시 전에 세부 사항이 변경될 수 있습니다.
한도
한도는 1분 단위의 슬라이딩 윈도로 계산되며 모든 엔드포인트에 합산하여 적용됩니다. 상태 확인은 키가 필요 없고 한도에 포함되지도 않습니다.
요청 한도 헤더
유효한 API 키를 사용한 요청의 응답에는 오류 응답을 포함하여 다음 헤더가 담깁니다.한도를 초과한 경우
한도를 초과하면 API는rate_limit_exceeded 코드와 같은 헤더를 담아 429를 반환합니다.
5xx 오류에는 지수 백오프를 적용하세요.
한도 안에서 사용하기
X-RateLimit-Remaining을 확인하고 0에 도달하기 전에 속도를 줄이세요.- QR 코드마다 요청을 하나씩 보내는 대신 QR 코드 대량 생성을 사용하세요.
pageSize=100으로 페이지당 최대 100개의 결과를 가져오세요. 페이지네이션을 참조하세요.- QR 이미지를 캐시하세요. 다운로드는
ETag를 반환하므로If-None-Match를 보내면 변경 사항이 없을 때304 Not Modified를 받습니다.