My Geocode

Совместимая замена ipstack

Стандартный эндпоинт поиска и эндпоинт check от ipstack отвечают на ipstack.mygeocode.com с теми же полями верхнего уровня и объектом location, по HTTPS на любом тарифе.

Измените одно имя хоста

Исходный хост
  • api.ipstack.com
Используйте вместо негоipstack.mygeocode.com
Параметр ключаaccess_key (необязательно: любой адрес получает 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 работает только по HTTP и ограничен 100 запросами в месяц. Здесь каждый ключ получает 2 500 запросов в день по HTTPS.

Та же бесплатная квота, с ключом или без. Запросы к ipstack.mygeocode.com учитываются в тех же 2 500 бесплатных запросах в день, которые ваш адрес или ваш ключ получает на наших собственных эндпоинтах. Сверх этого: предоплаченный баланс по 0,0001 € за запрос или 50 € в месяц за ключ Unlimited. Для регистрации нужен только адрес электронной почты.

Смотреть цены Получить бесплатный ключ

Эндпоинты

Путь на ipstack.mygeocode.comЧто делаетНа основе
/{ip}Стандартное определениеОпределение IPv4
/checkОпределение вызывающей стороныОпределение IPv4
/{ip},{ip},{ip}Массовое определениеОпределение IPv4

Пример ответа

Вот что возвращает запрос выше. Названия полей, вложенность и типы соответствуют 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
  }
}

Подробности и отличия

Для первых 2 500 запросов в день ключ не нужен. Чтобы использовать ключ My Geocode, укажите его там, где был ключ ipstack: в параметре запроса access_key. Заголовок X-API-Key, Authorization: Bearer и базовая HTTP-аутентификация (ключ в качестве имени пользователя) тоже работают на каждом хосте, поэтому клиентские библиотеки со своим способом аутентификации продолжают работать без изменений.

Ответы содержат те поля, которые возвращает ipstack, и ничего больше, поэтому ответ можно передать коду, который уже разбирает ipstack. Наши дополнительные данные (высота рельефа, угрозы и сведения о сети) доступны по запросу: добавьте mg_extras=1 в запрос или отправьте X-MG-Extras: 1.

  • Блок time_zone заполнен: идентификатор, текущее местное время, смещение, аббревиатура и признак действия летнего времени.
  • Отсутствующий ключ возвращает ошибку 101 missing_access_key, а неверный 101 invalid_access_key.
  • region_code является коротким кодом для США, Канады и Австралии; для остальных стран в наборе данных есть только полное название.
  • Массовое определение принимает до 50 адресов через запятую, как и ipstack (при большем количестве возвращается 302 too_many_ips), и каждый адрес считается одним запросом, как их считает ipstack.
  • Поля, для которых нужен набор данных, который мы пока не лицензируем (geoname id, столица, языки, телефонный код), присутствуют и равны null.

Если ваш клиент зависит от поля или поведения, которого здесь нет, сообщите нам. Пробелы в совместимости исправляются быстро, потому что обычно они невелики.

Другие совместимые хосты

Как работают совместимые хосты, обзор и совместимые замены для библиотек JavaScript.