한도와 크기

플랫폼의 안정성을 위해 API에는 요청 빈도와 전송 데이터 크기에 대한 제한이 있습니다.

요청 빈도

허용된 요청 빈도를 초과하면 서버가 429 Too Many Requests 코드로 응답합니다. 올바른 대응은 지수 백오프로 재시도하는 것입니다: 재시도 간 간격을 늘리고 요청을 집중적으로 보내지 마세요. 대량 작업은 시간에 분산하고, 병렬 버스트가 아닌 하나의 토큰을 순차적으로 재사용하세요.

요청 본문 크기

일반 REST 요청의 JSON 본문 크기는 2 MiB로 제한됩니다. 반응, 컬렉션, 설정의 모든 구성에 충분합니다. 본문이 더 크면 작업을 나누세요 (예: 반응을 배치로 가져오기).

가져오기 시 본문 크기

가져오기 엔드포인트는 대형 번들을 위해 설계되어 별도의 더 높은 한도가 있습니다: 데이터 가져오기는 최대 64 MiB, 미디어가 포함된 가져오기는 최대 256 MiB. 번들이 더 크면 여러 가져오기로 나누세요.

한도 초과

  • 빈도 한도 초과 — 429, 지연 후 재시도.
  • 허용 크기 초과 본문 — 요청 거부 (엔드포인트에 따라 413 또는 400); 페이로드를 줄이거나 나누세요.

다음 단계