pdu.php¶

В этой статье

Методы API

pdu/bind

pdu/check_overload

pdu/get

pdu/load_version

Модуль управления PDU: проверка перегрузок оборудования и выполнение системных задач по расписанию

Методы API¶

Метод	Действие	Описание
`bind`	привязка	Метод не реализован (пустой кейс).
`check_overload`	проверка перегрузки	Запуск процесса проверки PDU на наличие перегрузок (выполняется по расписанию). Метод помечен как устаревший.

Метод не реализован (пустой кейс).

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "bind"
}

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

null

Запуск процесса проверки PDU на наличие перегрузок (выполняется по расписанию). Метод помечен как устаревший.

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"module": "pdu",
"action": "check_overload"
}

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

null

Возвращает список доступных SNMP-тегов потребления энергии для конкретного PDU и данные по графикам (total, 5min, 2h, 24h).

HTTP-метод: POST

Параметры:

action	✅	string	Идентификатор метода: `get`
token	✅	string	Токен авторизации
id	✅	integer	Идентификатор PDU для получения данных о потреблении энергии

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

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

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

{
"result": "OK",
"data": [
{
"name": "SNMP Tag Name",
"id": 123,
"total": 45.5,
"5min": 42.0,
"2h": 44.2,
"24h": 43.8
}
]
}

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

{
"code": -1,
"message": "PDU: id is required"
}

Запрашивает текущую версию прошивки устройства через SNMP.

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"id": 123,
"callback": "7bc29eb23fb879b21fce509597f07c"
}

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

{
"code": -1,
"message": "equipment 123 has invalid IP address - 1.2.3.4",
"id": 123
}