スタートガイド

レート制限

各ユーザーが送信できるリクエストは、そのユーザーのすべてのキーを合わせて1分あたり120件までです。カウンターは毎分0秒にリセットされます。

有効なキーによるリクエストのレスポンスには、使用状況を示す次のヘッダーが含まれます。

名前	型	説明
`X-RateLimit-Limit`	`integer`	1分あたりに許可されるリクエスト数。
`X-RateLimit-Remaining`	`integer`	現在の1分間に残っているリクエスト数。
`X-RateLimit-Reset`	`integer`	カウンターがリセットされるまでの秒数。
`Retry-After`	`integer`	`429`レスポンスのみ：再試行までに待つ必要がある秒数。

制限を超えると、コードrate_limitedを含む429レスポンスが返されます。Retry-Afterの時間が経過してから再試行してください。

有効なキーを伴わないリクエスト（キーなし、誤ったキー、無効化されたキー）は、IPアドレスごとに1分あたり30回までに制限されます。

制限に達しないために

per_pageに最大100まで指定すれば、少ないリクエストで多くの項目を取得できます。
TVのステータスを監視するなら、1分に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."
  }
}