자동으로 적용되는 한도

요청 빈도

각 API 키마다 시간당 요청 허용량이 있으며, 그 크기는 여러분의 요금제가 정합니다. 허용량은 해당 키에만 속하며 슬라이딩 60분 동안 측정됩니다. 단위는 HTTP 요청 한 건이며 반환되는 레코드 수와 관계없고, 5,000개를 넘는 필드를 선택하는 문서는 비례해 차감됩니다. 모든 응답은 헤더로 한도, 남은 양, 초기화 시점을 알려 줍니다.

한도 초과

거부된 요청은 HTTP 429 상태와 RATE_LIMITED 코드, 그리고 Retry-After 헤더를 받습니다. 타입 지정 SDK는 재시도할 때 이 헤더를 따릅니다.

한도를 넘은 GraphQL 엔드포인트 읽기는 응답 캐시에서 응답받습니다. 정확히 같은 요청의 캐시된 응답이 있을 때에 한하며, 응답은 HTTP 200으로 돌아오고 헤더 X-Foir-Stale: true가 붙습니다. 캐시된 것이 없는 읽기는 429를 받습니다.

쿼리 크기

파싱된 문서에 대해 실행 전에 세 가지 상한이 적용됩니다. 최대 깊이 24, 선택 필드 기준 최대 복잡도 10,000, 최대 별칭 1,000개입니다. 복잡도는 단순한 개수입니다. 선택된 필드 하나가 1이며, 필드별 가중치도 목록에 따른 곱셈도 없고, 유니온은 가장 큰 구성원 기준으로 계산됩니다. 세 상한은 응답 헤더로도 알려 줍니다.

동시 요청

워크스페이스는 수십 건의 요청을 동시에 실행할 수 있습니다. 그보다 하나 더 들어오면 대기열에 넣지 않고 같은 한도 코드로 즉시 거부됩니다.