메인 콘텐츠로 건너뛰기
GetQR API는 베타 버전이며 일부 워크스페이스에서만 사용할 수 있습니다. 정식 출시 전에 세부 사항이 변경될 수 있습니다.
GetQR API는 API 키마다 보낼 수 있는 요청 수를 제한합니다. 하나의 통합이 모든 사용자의 API 속도를 떨어뜨리지 않도록 하기 위해서입니다.

한도

한도는 1분 단위의 슬라이딩 윈도로 계산되며 모든 엔드포인트에 합산하여 적용됩니다. 상태 확인은 키가 필요 없고 한도에 포함되지도 않습니다.

요청 한도 헤더

유효한 API 키를 사용한 요청의 응답에는 오류 응답을 포함하여 다음 헤더가 담깁니다.

한도를 초과한 경우

한도를 초과하면 API는 rate_limit_exceeded 코드와 같은 헤더를 담아 429를 반환합니다.
초기화 시각까지 기다린 뒤 다음 요청을 보내세요. 여러 워커가 동시에 재시도하지 않도록 지터를 추가하고, 5xx 오류에는 지수 백오프를 적용하세요.
POST /api/v1/qrs는 Idempotency-Key 헤더를 붙인 경우에만 재시도하세요. 그러면 재시도로 두 번째 QR 코드가 만들어지지 않습니다. 멱등성을 참조하세요.

한도 안에서 사용하기

  • X-RateLimit-Remaining을 확인하고 0에 도달하기 전에 속도를 줄이세요.
  • QR 코드마다 요청을 하나씩 보내는 대신 QR 코드 대량 생성을 사용하세요.
  • pageSize=100으로 페이지당 최대 100개의 결과를 가져오세요. 페이지네이션을 참조하세요.
  • QR 이미지를 캐시하세요. 다운로드는 ETag를 반환하므로 If-None-Match를 보내면 변경 사항이 없을 때 304 Not Modified를 받습니다.

다음 단계

오류

QR 코드