今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
ipstackとの互換ホストが利用可能に
多くのアプリケーションは、ユーザーが最初に接続した時点でちょうど一度だけIPジオロケーションを使い、国を推定したり既定の通貨を設定したりして、それで終わりです。ipstackは長い間、その1つのステップによく選ばれてきました。私たちの新しい互換ホストを使えば、そのステップを別のバックエンドに対して同じように動かし続けられます。
このホストはipstackのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これは元のプロバイダーではなくMy Geocodeの内容になっています。アプリケーションが現在ipstack向けの形で検索を送っている場所ではどこでも、同じ検索を私たちのホストに送ることができ、返ってくるフィールドは既存の解析コードが想定している位置に入ります。
ここでは、プラットフォームの他の場所での/v1/ipの動作と同じく、両方のアドレスファミリーを完全にサポートしています。IPv4アドレスもIPv6アドレスもこのホストで正しく解決され、どちらでも同じ形のレスポンスが返ります。
キーはX-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータとして送ることができ、既存のipstackとの連携がすでに使っている方式に合わせられます。4つとも、私たちが運営するすべてのホストとエンドポイントでまったく同じように受け付けられるので、認証コードを変える必要はほとんどありません。
このホストの背後にある料金は、他のすべての場所と同じです。どのアドレスにも、キーなしで1日あたり2,500件の無料検索があります。これはネットワーク単位で数えられるため、共有のオフィスや建物は多数の枠ではなく1つの枠から利用します。キーごとに、さらに1日あたり2,500件の無料リクエストが追加されます。これらの割り当てを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50でカバーでき、この互換ホストに別の料金はありません。
すべてのレスポンスには私たちの割り当てヘッダー一式も含まれます。これはipstackとの素の連携では得られないものです。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remainingが、毎回の呼び出しにすべて付きます。
プロジェクトで標準のレスポンス以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、IPの脅威情報やネットワークの詳細などのオプションのフィールドが互換の形の上に加わります。既定ではオフなので、明示的に要求しない限りレスポンスの形式は何も変わりません。
この互換ホストのドキュメントは/compatibility/ipstack/にあり、その基盤となるすべてを扱うIP検索の完全なリファレンスは/docs/ipv4-lookup/と/docs/ipv6-lookup/にあります。