今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
ipinfo.ioとの互換ホストが利用可能に
ipinfo.ioは、このIPアドレスはどこにあり、どのネットワークに属しているのか、という1つの問いにすばやく答えたいだけのチームによく選ばれます。連携は通常小さく、1つのHTTP呼び出しを包む関数1つ程度なので、チームが他の点では積極的に比較検討する場合でも、何年もそのままにされがちです。私たちの互換ホストを使えば、その小さな連携を簡単に向け直せます。
これまでipinfo.ioに送っていたリクエストを代わりに私たちのホストに向けると、レスポンスはフィールド単位で同じ形で返ってきます。例外は著作権、規約、プライバシーに関する文言で、これは私たちのものです。コードがJSON本文から国、地域、都市、座標、組織の情報を読み取っている場合も、同じ位置から同じフィールドを読み取り続けられます。
/v1/ipはIPv4とIPv6の両方のアドレスを完全に解決するので、互換ホストも同様です。8.8.8.8のようなアドレスの検索は、どちらのアドレスファミリーにも個別の設定を必要とせず、想定どおりの形で位置情報とネットワークのフィールドをすぐに返します。
認証は、すべてのMy Geocodeホストと同じように機能します。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。4つともここで受け付けられるので、既存のipinfo.ioとの連携がすでに送っている方法をそのまま使ってください。
その下にある料金体系は私たちのもので、プラットフォームのどこでも一貫しています。どのアドレスにも、キーなしで1日あたり2,500件の無料検索があります。これはネットワーク単位で数えられるため、共有の回線を多数のキーに分けてその割り当てを増やすことはできません。キーごとに1日あたり2,500件の無料リクエストが追加されます。それを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50で利用をカバーでき、このホストと他のホストで料金が分かれることはありません。
すべてのレスポンスには私たちの割り当てヘッダーが付き、ipinfo.ioとの素の連携では得られない水準で毎日の利用状況を把握できます。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remainingが、すべての呼び出しに付きます。
標準のIPレスポンス以上のものが欲しい場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、IPの脅威情報やネットワークの詳細などのオプションの追加情報が互換の形の上に加わります。これは完全に任意です。付けなければ、レスポンスはipinfo.ioの形式と正確に一致します。
このホストのドキュメントは/compatibility/ipinfo/にあり、基盤となるIP検索の動作は/docs/ipv4-lookup/と/docs/ipv6-lookup/で詳しく説明しています。