시작하기

요청 한도

각 사용자는 보유한 모든 키를 합산하여 분당 최대 120건의 요청을 보낼 수 있습니다. 카운터는 매분 0초에 초기화됩니다.

유효한 키로 요청하면 응답의 다음 헤더에서 사용량을 확인할 수 있습니다.

이름	타입	설명
`X-RateLimit-Limit`	`integer`	분당 허용되는 요청 수.
`X-RateLimit-Remaining`	`integer`	현재 1분 동안 남은 요청 수.
`X-RateLimit-Reset`	`integer`	카운터가 초기화될 때까지 남은 시간(초).
`Retry-After`	`integer`	`429` 응답에만 포함: 다시 시도하기 전에 기다려야 하는 시간(초).

한도를 초과하면 rate_limited 코드와 함께 429 응답이 반환됩니다. Retry-After에 표시된 시간만큼 기다린 후 다시 시도하세요.

유효한 키 없이 보낸 요청(키 없음, 잘못된 키 또는 폐기된 키)은 IP 주소마다 분당 30회로 제한됩니다.

한도에 도달하지 않으려면

per_page를 최대 100까지 지정하면 더 적은 요청으로 더 많은 항목을 가져올 수 있습니다.
TV 상태를 모니터링할 때는 1분에 한 번 조회하는 것으로 충분합니다.
대량 작업을 할 때는 요청을 시간에 걸쳐 분산하고 X-RateLimit-Remaining 값을 확인하세요.

응답 헤더200

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

한도 도달429

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}