今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
ip-api.comとの互換ホストが利用可能に
ip-api.comは、開発者が最初に手に取るIPジオロケーションサービスであることが多く、その主な理由はすぐに試せてスクリプトに組み込みやすいことです。私たちの互換ホストは、まさにそのシンプルさを保ちながら、異なる割り当てと料金のルールの下で動くように作られています。
このホストはip-api.comのリクエスト処理とレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは私たちのものです。これまでip-api.comのエンドポイントに送っていたリクエストは代わりに私たちのエンドポイントに送ることができ、返ってくるJSONは同じフィールド名が同じ位置にあり、同じように解析できます。
/v1/ipは両方のアドレスファミリーを完全に解決するので、この互換ホストもIPv4とIPv6の検索を同じように扱います。IPv4アドレスの検索もIPv6アドレスの検索も、どちらのアドレスかをホストに伝える追加のフラグなしで、正しい形で返ってきます。
ここでもキーは、My Geocodeの他のすべての場所と同じ方法で認証できます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。現在の連携がすでに使っている方式は、変更なしでそのまま受け付けられます。
このホストの料金は、私たちが運営する他のすべてのホストやエンドポイントと同じです。どのアドレスにも、キーなしで1日あたり2,500件の無料IP検索があり、ネットワーク単位で数えられます。キーごとに、それとは別に1日あたり2,500件の無料リクエストが追加されます。それを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50ですべてをカバーでき、/v1/ipを直接使う代わりに互換ホストを使うことによる割増はありません。
ここでもすべてのレスポンスに割り当てのヘッダーが付きます。これはip-api.comとの素の連携では通常得られないものです。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がすべて含まれます。
標準の検索以上のものが欲しいプロジェクトでは、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、IPの脅威情報やネットワークの詳細などのオプションのフィールドが互換レスポンスの上に加わります。要求しない限り、基本の形は変わりません。
詳細は/compatibility/ip-api/にあります。スタックのどこかのスクリプトがすでにip-api.comと通信しているなら、ここに向け直すことで、割り当てを把握できてユーロ建ての料金のホストがどんな違いをもたらすかをすばやく確かめられます。