ipstackの互換ホスト
ipstackの標準検索とcheckのエンドポイントが、ipstack.mygeocode.comで同じトップレベルのフィールドとlocationオブジェクトで応答します。すべてのプランでHTTPSに対応しています。
ホスト名を1つ変えるだけ
| 元のホスト |
|
|---|---|
| 代わりに使うホスト | ipstack.mygeocode.com |
| キーのパラメーター | access_key（任意：どのアドレスでもキーなしで1日あたり2,500件のリクエストが使えます。クレジット、パッケージ、利用履歴を使うにはここにMy Geocodeのキーを入れてください） |
変更前
curl "http://api.ipstack.com/8.8.8.8?access_key=YOUR_IPSTACK_KEY"変更後
curl "https://ipstack.mygeocode.com/8.8.8.8?access_key=YOUR_MYGEOCODE_KEY"エンドポイント
レスポンスの例
上記のリクエストはこれを返します。フィールド名、入れ子構造、型はipstackに準拠しています。その中身のデータだけが当社のものです。
ipstack.mygeocode.comからのレスポンス
{
"ip": "8.8.8.8",
"type": "ipv4",
"continent_code": "NA",
"continent_name": "North America",
"country_code": "US",
"country_name": "United States",
"region_code": "CA",
"region_name": "California",
"city": "Mountain View",
"zip": "94043",
"latitude": 37.4056,
"longitude": -122.0775,
"location": {
"geoname_id": 5375480,
"capital": "Washington D.C.",
"languages": [ { "code": "en", "name": "English", "native": "English" } ],
"country_flag": "https://www.mygeocode.com/assets/img/flags/us.svg",
"country_flag_emoji": "🇺🇸",
"country_flag_emoji_unicode": "U+1F1FA U+1F1F8",
"calling_code": "1",
"is_eu": false
}
}詳細と相違点
1日あたり最初の2,500件のリクエストにはキーは不要です。My Geocodeのキーを使う場合は、ipstackのキーがあった場所、つまりaccess_keyクエリパラメーターに入れてください。X-API-Keyヘッダー、Authorization: Bearer、HTTP Basic認証（キーをユーザー名として使用）もすべてのホストで使えるため、独自の方法で認証するクライアントライブラリも変更なしで動作し続けます。
回答にはipstackが返すフィールドだけが含まれるため、すでにipstackを解析しているコードにレスポンスをそのまま渡せます。当社の追加データ（地表の標高、脅威情報、ネットワークの詳細）はリクエストに応じて利用できます：クエリにmg_extras=1を追加するか、X-MG-Extras: 1を送信してください。
time_zoneブロックには、ID、現在の現地時刻、オフセット、略称、夏時間が適用中かどうかが入ります。- キーがない場合はエラー101
missing_access_key、キーが誤っている場合は101invalid_access_keyで応答します。 region_codeは、米国、カナダ、オーストラリアでは短いコードです。それ以外の地域では、データセットに正式名称しかありません。- 一括検索では、ipstackと同様にカンマ区切りで最大50件のアドレスを受け付け（それを超えると
302 too_many_ipsで応答します）、ipstackの数え方と同じく各アドレスが1リクエストとして数えられます。 - 当社がまだライセンスを取得していないデータセットを必要とするフィールド（geoname ID、首都、言語、国際電話番号）は、nullとして含まれます。
お使いのクライアントがここに記載されていないフィールドや動作に依存している場合は、お知らせください。互換性の差異はたいてい小さいため、すぐに修正されます。