geoip.php¶

В этой статье

Методы API

geoip/import_networks

geoip/import_country

geoip/resolve

geoip/proxy_config

Модуль управления GeoIP данными: импорт сетей и метаданных стран, разрешение IP-адресов и экспорт конфигурации прокси с языковыми тегами

Методы API¶

Метод	Действие	Описание
`import_country`	импорт стран	Импорт метаданных стран и континентов из GeoLite2 CSV. Перезаписывает таблицу geoip_locations.
`import_networks`	импорт сетей	Импорт диапазонов IPv4/IPv6 из CSV-файлов GeoLite2. Очищает существующие таблицы перед загрузкой.
`proxy_config`	экспорт прокси	Экспорт IPv4 CIDR диапазонов с языковыми тегами (plain text output).
`resolve`	разрешение IP	Преобразование публичного IPv4/IPv6 адреса в данные о местоположении (geoname_id, locale_code и др.).

geoip/import_networks¶

Импорт диапазонов IPv4/IPv6 из CSV-файлов GeoLite2. Очищает существующие таблицы перед загрузкой.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `import_networks`
token	✅	string	Токен авторизации

Пример запроса

curl -s "https://invapi.hostkey.ru/geoip.php" -X POST \
--data "action=import_networks" \
--data "token=HOSTKEY_TOKEN"

Пример успешного ответа

{
"result": "OK",
"message": "IP import OK, v4 1500 done, v6 500 done"
}

Примеры ошибок

{
"code": -1,
"message": "Cannot read input stream"
}

geoip/import_country¶

Импорт метаданных стран и континентов из GeoLite2 CSV. Перезаписывает таблицу geoip_locations.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `import_country`
token	✅	string	Токен авторизации

Пример запроса

curl -s "https://invapi.hostkey.ru/geoip.php" -X POST \
--data "action=import_country" \
--data "token=HOSTKEY_TOKEN"

Пример успешного ответа

{
"result": "OK",
"message": "countries import OK, {records} done"
}

Примеры ошибок

{
"result": "fail",
"message": "Cannot read input stream"
}

geoip/resolve¶

Преобразование публичного IPv4/IPv6 адреса в данные о местоположении (geoname_id, locale_code и др.).

HTTP-метод: POST/GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `resolve`
ip	✅	string	Публичный IPv4 или IPv6 адрес для разрешения.
token	❌	string	Уникальный идентификатор сессии или ключ доступа для авторизации запроса.

Пример запроса

curl -s "https://invapi.hostkey.ru/geoip.php" -X POST \
--data "action=resolve" \
--data "ip=8.8.8.8"

Пример успешного ответа

{
"geoname_id": 123,
"locale_code": "US",
"continent_code": "NA",
"continent_name": "North America",
"country_iso_code": "US",
"country_name": "United States",
"is_in_european_union": 0
}

Примеры ошибок

{
"-1: no IP specified": {
"result": -1,
"error": "no IP specified"
},
"-1: invalid IP specified": {
"result": -1,
"error": "invalid IP specified"
},
"-1: not found": {
"result": -1,
"error": "not found"
}
}

geoip/proxy_config¶

Экспорт IPv4 CIDR диапазонов с языковыми тегами (plain text output).

HTTP-метод: POST

Параметры:

action	✅	string	Идентификатор метода: `proxy_config`
lang	❌	string	Код языка для фильтрации CIDR диапазонов.
token	❌	string	Уникальный идентификатор сессии или ключ авторизации для выполнения запроса.

Пример запроса

curl -s "https://invapi.hostkey.ru/geoip.php" -X POST \
--data "action=proxy_config" \
--data "lang=en" \
--data "token=your_token_here"

Пример успешного ответа

{
"content_type": "text/plain",
"format": "<CIDR> \"<lang>\"\n<CIDR> \"<lang>\""
}

Примеры ошибок

{}