eq_callback.php¶

Модуль обработки асинхронных ответов от worker-ов для управления оборудованием (EQ) и виртуальными машинами. Обрабатывает статусы задач (deploy, reinstall, backup, network), обновляет биллинг и отправляет уведомления клиентам.

Методы API¶

Метод	Действие	Описание
`check`	проверка статуса асинхронной задачи	Проверяет текущий статус задачи по ключу (key) и возвращает контекст выполнения, если задача завершена или находится на промежуточном этапе.
`reinstall`	обработка ответа о переустановке сервера	Обработчик колбэка от worker-а после завершения операции переустановки (reinstall). Обновляет статус сервера, очищает временные теги, отправляет письмо клиенту с данными доступа и обновляет биллинг.

eq_callback/check¶

Проверяет текущий статус задачи по ключу (key) и возвращает контекст выполнения, если задача завершена или находится на промежуточном этапе.

HTTP-метод: GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `check`
key	✅	string	Уникальный идентификатор асинхронной задачи (32 символа, a-z0-9).

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

curl -s "https://invapi.hostkey.ru/eq_callback.php" -X GET \
--data "action=check" \
--data "key=VALUE"

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

{
"result": "OK",
"action": "check",
"scope": {
"id": 12345,
"location": "NL",
"preset": "vps-s-1"
},
"context": {
"action": "deploy",
"id": 12345,
"ip": "192.168.1.10",
"ip_ipmi": "192.168.1.1",
"interface_id": 5678,
"port": "eth0",
"User": "root",
"password": "censored"
},
"debug": "Task completed successfully",
"key": "7bc29eb23fb1b879b21fce509597f07c"
}

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

{
"code": -1,
"message": "AsyncKey not found",
"key": "7bc29eb23fb1b879b21fce509597f07c"
}

eq_callback/reinstall¶

Обработчик колбэка от worker-а после завершения операции переустановки (reinstall). Обновляет статус сервера, очищает временные теги, отправляет письмо клиенту с данными доступа и обновляет биллинг.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `reinstall`
key	✅	string	Уникальный идентификатор асинхронной задачи (32 символа, a-z0-9).
status	✅	string	JSON-строка или текстовый статус от worker-а (например, 'deploy_done', 'Error').
stage	❌	string	Этап выполнения задачи (по умолчанию 'done').
id	❌	int	ID сервера (если не передан в статусе).

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

curl -s "https://invapi.hostkey.ru/eq_callback.php" -X POST \
--data "action=reinstall" \
--data "key=VALUE" \
--data "status=VALUE"

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

{
"result": "OK",
"action": "reinstall",
"callback": "7bc29eb23fb1b879b21fce509597f07c"
}

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

{
"code": -1,
"message": "Key not found",
"action": "eq_callback",
"key": "7bc29eb23fb1b879b21fce509597f07c"
}