ip.php¶

IP address and network infrastructure management module: retrieving IP information, managing PTR records, traffic monitoring, working with subnets and VLANs.

API Methods¶

Method	Action	Description
`get_client_ip`	get client IP	Returns the current IP address of the client making the request to the API.
`get_ip`	get IP information	Returns full network configuration information for a specific IP address (mask, gateway, etc.)
`get_ptr`	check IP PTR record	Checks whether the specified IP address belongs to a server with a given ID and returns the current PTR record for this IP in the specified location.
`get_traffic`	get traffic	Returns inbound and outbound traffic data for the specified IP address for the selected period. Can return both summary information and detailed timestamps.
`list_free_ip`	get list of free IPs	Returns a list of unused IPv4 addresses for a specific location based on Route Reflector tags. For clients, it is only available within their own subnets.
`set_main`	set main IP for server	Sets the specified IP address as the primary (main) for the server's network interface. Updates data in the WHMCS billing system if necessary.
`update_ptr`	update PTR record	Updates the reverse DNS record (PTR) for the specified IP address. Requires permission verification and proof of IP ownership by the server.

ip/get_client_ip¶

Returns the current IP address of the client making the request to the API.

HTTP-method: GET

Parameters:

Parameter	Required	Type	Description
action	✅	string	Method identifier: `get_client_ip`
token	✅	string	Authorization token

Example Request

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

Example of a successful response

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

Failure response

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

```

ip/get_ip¶

Returns full network configuration information for a specific IP address (mask, gateway, etc.)

HTTP-method: POST|GET

Parameters:

Parameter	Required	Type	Description
action	✅	string	Method identifier: `get_ip`
token	✅	string	Authorization token
ip	✅	string	IP address to retrieve information for

Example Request

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

Example of a successful response

{
"result": "OK",
"module": "ip",
"action": "get_ip",
"data": {
"network": "192.168.1.0",
"netmask": "255.255.255.0",
"gateway": "192.168.1.1"
}
}

Failure response

``` { "code": -1, "message": "No data for the loopback address" }

```

ip/get_ptr¶

Checks whether the specified IP address belongs to a server with a given ID and returns the current PTR record for this IP in the specified location.

HTTP-method: POST

Parameters:

Parameter	Required	Type	Description
action	✅	string	Method identifier: `get_ptr`
token	✅	string	Authorization token
ip	✅	string	IP address
id	✅	int	Server ID
location	❌	string	Location for PTR check

Example Request

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

Example of a successful response

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

Failure response

``` { "code": -1, "message": "invalid request" }

```

ip/get_traffic¶

Returns inbound and outbound traffic data for the specified IP address for the selected period. Can return both summary information and detailed timestamps.

HTTP-method: POST|GET

Parameters:

Parameter	Required	Type	Description
token	✅	string	Authorization token
ip	✅	string	IP address to retrieve traffic for
period_start	❌	int	Start of the period (timestamp)
period_stop	❌	int	End of the period (timestamp)
summary	❌	int	1 - return only summary (in/out in GB), 0 - detailed timestamps
unbilled	❌	int	1 - unpaid traffic only, 0 - all traffic

Example Request

curl -s "https://invapi.hostkey.com/ip.php" -X POST \
--data "token=HOSTKEY_TOKEN" \
--data "ip=1.2.3.4"

Example of a successful response

{
"result": "OK",
"traffic": [
{
"timestamp": "2024-05-20T12:00:00Z",
"in": 1.45,
"out": 0.89
}
]
}

Failure response

``` { "code": -1, "message": "no significant traffic detected for [IP] in the period [DD-MM-YYYY] - [DD-MM-YYYY]" }

```

ip/list_free_ip¶

Returns a list of unused IPv4 addresses for a specific location based on Route Reflector tags. For clients, it is only available within their own subnets.

HTTP-method: POST|GET

Parameters:

Parameter	Required	Type	Description
action	✅	string	Action name (list_free_ip)
token	✅	string	Authorization token
exclude_special	❌	int	Exclude special addresses (0 or 1)
location	✅	string	Location to search for free IPs

Example Request

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

Example of a successful response

{
"result": "OK",
"ip": [
"192.168.1.1",
"10.0.0.5"
]
}

Failure response

``` { "code": -1, "message": "illegal IP subnet" }

```

ip/set_main¶

Sets the specified IP address as the primary (main) for the server's network interface. Updates data in the WHMCS billing system if necessary.

HTTP-method: POST

Parameters:

Parameter	Required	Type	Description
action	✅	string	Method identifier: `set_main`
token	✅	string	Authentication token
id	✅	int	Server ID
ip	✅	string	IP address to set as main
main	❌	int	Main flag (0 for IPMI or 1 for IPv4)
description	❌	string	Description for the IP

Example Request

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

Example of a successful response

{
"result": "OK",
"message": "Data from ipv4_set_main function"
}

Failure response

``` { "code": -1, "message": "invalid request or invalid IP for server id" }

```

ip/update_ptr¶

Updates the reverse DNS record (PTR) for the specified IP address. Requires permission verification and proof of IP ownership by the server.

HTTP-method: POST

Parameters:

Parameter	Required	Type	Description
action	✅	string	Method identifier: `update_ptr`
token	✅	string	Authorization token
ip	✅	string	IP address
id	✅	integer	Server ID
ptr	✅	string	New PTR record
location	❌	string	Location

Example Request

curl -s "https://invapi.hostkey.com/ip.php" -X POST \
--data "action=update_ptr" \
--data "token=HOSTKEY_TOKEN" \
--data "ip=1.2.3.4" \
--data "id=5" \
--data "ptr=example.com"

Example of a successful response

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

Failure response

{
"code": -1,
"message": "IP 1.2.3.4 is not assigned for server id 5"
}