移行

ipstackからの移行

ipstackは access_key クエリパラメータで認証し、type(ipv4またはipv6)、continent_codelatitudelongitude などのフィールドを持つJSONレスポンスを返します。上位のプランでは、自律システムとISPの詳細を最上位のフィールドとは別に持つ、ネストされた connection オブジェクトも返します。このネストされたconnectionの構造は、一部の競合のよりフラットな形式に比べるとやや複雑で、ISPとネットワークの詳細を位置情報フィールドと混ぜずに、独自の論理的なまとまりとして扱いたいアプリケーションに適しています。

この種のネストされた構造の移行には、フラットなレスポンスよりも少し注意が必要です。単純に、レスポンスのツリーの中でフィールド名が異なる可能性のある場所が多いからです。移行が完了したとみなす前に、最上位のフィールドだけでなく、ネストされたパスについても特にテストする価値があります。

My Geocodeのipstack互換ホストは、typecontinent_codelatitudelongitude のフィールドとネストされた connection オブジェクトを含む構造全体を再現しており、変更されるのは著作権表示、利用規約、プライバシーに関するテキストだけです。リファレンスの詳細は/compatibility/ipstack/にあります。response.connection.ispresponse.type を読み取るコードは、新しいキーで新しいホストに向ければ、同じ形式の値を返すはずです。

My GeocodeではIP検索がエンドツーエンドで完全に動作しているため、ここでの結果は形式だけの説明ではなく具体的なものです。あるアドレスに対する検索は、国、地域、都市、座標、接続の詳細をライブで返します。これは、まれなバッチ更新に頼るのではなく、IPジオロケーションを最新の状態に保つキャッシュレイヤーと照合されています。

ipstack連携の移行に関する具体的な注意点:

  • access_key クエリパラメータのパターンは当社のクエリパラメータの方式にそのまま対応します。認証方式も同時に変えたい場合は、同じ移行の中で X-API-Key ヘッダー、Authorization: Bearer、HTTPベーシック認証に移ることもできます
  • オプションの追加フィールド(該当する場合は標高、IPの脅威情報、より詳しいネットワーク情報)は、mg_extras=1 または X-MG-Extras ヘッダーで利用でき、標準の形式を置き換えるのではなく、それに追加されます
  • プロキシや脅威の検出のために連携コードがsecurityフィールドを確認している場合、それらの値は基本の互換レスポンスではなくオプションの追加情報に含まれます。完全な同等性を前提にする前に、コードが実際にどのフィールドに依存しているかを確認してください

料金については、キーなしで1日あたり2,500リクエストが無料で、さらに各キーにはネットワーク単位でカウントされる1日あたり2,500リクエストの無料枠が個別に付与されます。それを超えると、1リクエストあたり€0.0001のプリペイドクレジット、または月額€50のUnlimitedキーが一律に適用され、この互換ホストを含むすべてのエンドポイントが同じ料金です。ipstackのconnectionオブジェクトを自社の内部モデルで独立したデータのまとまりとして扱っているアプリケーションでは、そのまとまりがそのまま引き継がれるため、その構造の上に構築された下流のコード、ダッシュボード、データウェアハウスはそのまま維持されます。