customers.php¶

Модуль управления клиентами: управление списком доступа по IP, обновление данных и работа с заказами

Методы API¶

Метод	Действие	Описание
`set_order_status`	установка статуса заказа	Устанавливает статус заказа в системе WHMCS на основе ID клиента.
`update_acl`	обновление списка доступа по IP	Обновляет список разрешенных IP-адресов (ACL) для клиента. Если передать пустой список, текущий ACL будет удален.

customers/update_acl¶

Обновляет список разрешенных IP-адресов (ACL) для клиента. Если передать пустой список, текущий ACL будет удален.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `update_acl`
token	✅	string	Токен авторизации
id	✅	integer	Идентификатор клиента
ips	✅	string	Список IP-адресов через пробел. Если пусто, список будет очищен.

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

curl -s "https://invapi.hostkey.ru/customers.php" -X POST \
--data "action=update_acl" \
--data "token=HOSTKEY_TOKEN" \
--data "id=123" \
--data "ips=192.168.1.1 10.0.0.1"

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

{
"result": "OK"
}

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

{
"code": -1,
"message": "invalid customer id 0"
}

customers/set_order_status¶

Устанавливает статус заказа в системе WHMCS на основе ID клиента.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `set_order_status`
token	✅	string	Токен авторизации
id	✅	integer	Идентификатор клиента
params[status]	✅	string	Статус заказа для установки.
location	❌	string	Локация (биллинг) клиента.
status	✅	string	Параметр `status`

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

curl -s "https://invapi.hostkey.ru/customers.php" -X POST \
--data "action=set_order_status" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE" \
--data "params[status]=VALUE" \
--data "status=VALUE"

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

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

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

{
"code": -1,
"message": "Error message from WHMCS integration"
}