속도 제한 & 크레딧
상한이 적용되는 항목
플랜은 네 가지에 상한을 두며, 모두 GET /v1/account에서 볼 수 있습니다. 모니터링 대상, 키워드, 동시 WebSocket 연결 수, 분당 요청 수입니다. 앞의 두 가지는 details.resource와 함께 402 plan_limit을 반환하고, 세 번째는 4002로 소켓을 닫으며, 네 번째는 Retry-After 헤더와 함께 429 rate_limited를 반환합니다.
헤더
인증된 모든 응답은 현재 상태를 알려주므로, 클라이언트가 거부당하기 전에 미리 속도를 줄일 수 있습니다:
| 헤더 | 의미 |
|---|---|
X-RateLimit-Limit | 이 키의 분당 허용 요청 수 |
X-RateLimit-Remaining | 현재 분에 남은 요청 수 |
X-RateLimit-Reset | 윈도우가 초기화되는 Unix 시각 |
X-Credits-Used-Today | 00:00 UTC 이후 온디맨드 읽기로 소모한 크레딧 |
X-Request-Id | 이 값을 알려주시면 저희 로그에서 정확한 요청을 찾을 수 있습니다 |
X-Response-Time | 처리에 걸린 시간(밀리초) |
ETag | JSON 응답의 약한 검증자. If-None-Match로 돌려보냅니다 |
Idempotent-Replay | 같은 Idempotency-Key를 가진 이전 요청의 응답을 재생한 경우 true |
Retry-After | 대기해야 할 초. 모든 429에 포함 |
Location | 생성되었거나 대기열에 들어간 리소스의 위치. 201과 202에 포함 |
크레딧
스트리밍은 계량하지 않습니다. 유휴 연결과 바쁜 연결의 비용이 같고, 소켓의 프레임은 요청 예산에 포함되지 않습니다. 읽기 아래의 온디맨드 REST 읽기는 크레딧을 소모하며, 엔드포인트별로 표시된 대로 호출당 1~2 크레딧입니다. GET /v1/account/usage에서 일별 합계를 확인할 수 있습니다.