레이트 리밋

API Key별 분당 호출 한도와 응답 헤더를 설명합니다.

한도

429 응답 시 Retry-After 헤더(초)를 확인한 뒤 재시도하세요. 지수 백오프를 권장합니다.

구분설명

키당

120 req/min (슬라이딩 윈도우 60초). 초과 시 429 rate_limit_exceeded

플랜

무료 플랜은 v1 API 자체가 비활성입니다.

응답 헤더

구분설명

X-RateLimit-Limit

윈도우당 최대 요청 수

X-RateLimit-Remaining

남은 요청 수

X-RateLimit-Reset

윈도우 리셋 시각(Unix seconds)

Retry-After

429 시 재시도 대기 초

X-Qnector-Api-Version

2026-06-26

1회 요청 제한

  • Request body 최대 256KB — 초과 시 400 payload_too_large
  • Content-Type: application/json만 허용
  • 서버 타임아웃 30초 — 초과 시 504