ip.php¶

Модуль управления IP-адресами и сетевой инфраструктурой: получение информации об IP, управление PTR-записями, отслеживание трафика, работа с подсетями и VLAN.

Методы API¶

ip/get_client_ip¶

Возвращает IP-адрес текущего клиента, сделавшего запрос.

HTTP-метод: POST

Параметры:

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

{
"result": "OK",
"data": {
"ip": "192.168.1.100"
}
}

{
"code": -1,
"message": "authentication required"
}

ip/get_ip¶

Возвращает полную информацию о конкретном IP-адресе, включая данные о сети, маске и принадлежности.

HTTP-метод: POST|GET

Параметры:

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

{
"result": "OK",
"module": "ip",
"action": "get_ip",
"ip": "192.168.1.1",
"network": "192.168.1.0",
"netmask": "255.255.255.0",
"location": "NL",
"vlan_id": 100,
"server_id": 12345,
"status": "active"
}

```

ip/get_ptr¶

Возвращает PTR-запись (обратное DNS-имя) для указанного IP-адреса, привязанного к серверу.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/ip.php" -X POST \
--data "action=get_ptr" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE" \
--data "ip=VALUE"

{
"result": "OK",
"message": "server.example.com"
}

{
"code": -1,
"message": "ip/get_ptr: invalid request"
}

ip/get_traffic¶

Возвращает статистику входящего и исходящего трафика для указанного IP-адреса за заданный период. Поддерживает режим сводки или детализации по временным меткам.

HTTP-метод: POST

Параметры:

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

{
"result": "OK",
"traffic": [
{
"ip": "192.168.1.10",
"timestamp": 1715625600,
"in": 1024.5,
"out": 2048.2
}
]
}

```

ip/list_free_ip¶

Возвращает список неиспользуемых IP-адресов для указанной локации или подсети. Для клиентов используется ID подсети, для администраторов — код локации.

HTTP-метод: POST

Параметры:

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

{
"result": "OK",
"action": "list_free_ip",
"ip": [
"192.168.1.10",
"192.168.1.11"
]
}

```

ip/set_main¶

Устанавливает указанный IP-адрес как основной для интерфейса сервера. Обновляет данные биллинга в WHMCS, если применимо.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/ip.php" -X POST \
--data "action=set_main" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE" \
--data "ip=VALUE"

{
"result": "OK",
"message": "IP set as main"
}

```

ip/update_ptr¶

Устанавливает обратную DNS запись (PTR) для указанного IP-адреса, привязанного к серверу.

HTTP-метод: POST

Параметры:

curl -s "https://invapi.hostkey.ru/ip.php" -X POST \
--data "action=update_ptr" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE" \
--data "ip=VALUE"

{
"result": "OK",
"message": ""
}

```