今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
レート制限をわかりやすく解説
レート制限はわかりにくいという評判があり、何かが壊れて初めて意味がわかる例外や細則だらけです。当社のレート制限はそれよりも単純で、1か所でわかりやすく説明しておく価値があります。
すべてのアドレスには、キーなしで2,500件の1日あたりの無料リクエストがあります。この割り当ては個々のアドレスごとではなく、ネットワーク全体で共有されます。同じ/24内のすべてのIPv4アドレスと、同じ/48内のすべてのIPv6アドレスが、1つの枠を一緒に使います。共有のオフィス回線や大規模なネットワークアドレス変換の環境の背後にいる場合、これは重要です。キーを使っているかどうかにかかわらず、無料割り当てを同じネットワークセグメント上のほかの全員と共有することになるからです。
さらに各キーには、ネットワークがすでに提供している分とは別に、2,500リクエストの独自の1日あたりの無料割り当てがあります。キーの割り当ては同じネットワーク上のほかのトラフィックによって減ることはなく、ネットワークの割り当ても、キーの個別の割り当てをすでに使い切ったトラフィックによって減ることはありません。2つの割り当ては互いに競合するのではなく、並んで存在します。
その日の両方の割り当てを超えると、リクエストはアカウントの設定に応じて、1リクエストあたり€0.0001のプリペイドクレジットから消費されるか、月額€50のUnlimitedパッケージでカバーされます。リクエストを黙って遅くするスロットリングも、説明のない予期せぬブロックもありません。すべてのレスポンスには、X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit、X-Quota-Resetという割り当てヘッダーが付いているため、リクエストが失敗する前に、現在の状況を正確に確認できます。
一括またはバッチの呼び出しにも、呼び出し単位ではなく項目単位で同じルールが適用されます。1回の呼び出しで送信した100件の住所は、適用される割り当てに対して100リクエストとしてカウントされ、100回の個別の呼び出しとして送信した場合とまったく同じです。
これらはすべて、すべてのエンドポイントと17の互換ホストのそれぞれに同じように適用されます。OpenCageやipstack形式のリクエストも、/v1/forwardや/v1/ipへの直接のリクエストとまったく同じルールでレート制限され、見慣れたレスポンス形式の裏に、別のより厳しい上限が隠れていることはありません。
1日のリセットの仕組みや各ヘッダーの意味を含む詳細は、/docs/rate-limits/に記載されています。連携でレート制限に関する疑問が生じた場合、その答えはほぼ必ず、そのきっかけとなったレスポンスのヘッダーに直接表示されています。