rhr.php¶

Модуль управления заявками на удаленные работы (Remote Hands Requests): создание, фильтрация, обновление статусов и коммуникация по заявкам.

Методы API¶

Метод	Действие	Описание
`add`	создание запроса	Создает новый запрос Remote Hands (RHR). Поддерживает типы KVM, UNBLOCK и SERVICE. При наличии клиента автоматически создает тикет в системе поддержки.
`chat`	отправка сообщения в чат	Отправляет сообщение в существующий запрос Remote Hands. Если запрос инициирован клиентом, автоматически создается тикет поддержки и прикрепляются медиафайлы.
`discard`	отмена/утилизация запроса	Утилизирует (отменяет) запрос Remote Hands по его ID. Если предоставлен текст ответа, он сохраняется в историю логов клиента.
`list`	получение списка запросов	Возвращает список доступных задач Remote Hands (RHR) с возможностью фильтрации по датам, статусам и локациям. Для клиентов также возвращается история изменений.

rhr/add¶

Создает новый запрос Remote Hands (RHR). Поддерживает типы KVM, UNBLOCK и SERVICE. При наличии клиента автоматически создает тикет в системе поддержки.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
token	✅	string	Токен авторизации
params[eq_id]	✅	integer	ID оборудования (equipment ID)
params[type]	✅	string	Тип запроса: KVM, UNBLOCK или SERVICE
params[request_origin]	❌	string	Источник запроса (если клиент не авторизован)
params[request]	✅	string	Текст запроса (не может содержать эмодзи)

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

curl -s "https://invapi.hostkey.ru/rhr.php" -X POST \
--data "token=HOSTKEY_TOKEN" \
--data "params[eq_id]=12345" \
--data "params[type]=KVM" \
--data "params[request]=Please restart the server"

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

{
"requests": [
{
"id": 123,
"request": "Please restart the server",
"status": "pending",
"type": "KVM",
"photosExtra": "[{\"objectKey\": \"path/to/photo.jpg\"}]"
}
]
}

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

``` { "code": 400, "message": "Emoji are not allowed in RHR requests" }

```

rhr/chat¶

Отправляет сообщение в существующий запрос Remote Hands. Если запрос инициирован клиентом, автоматически создается тикет поддержки и прикрепляются медиафайлы.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
id	✅	int	ID запроса (request ID)
message	✅	string	Текст сообщения

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

curl -s "https://invapi.hostkey.ru/rhr.php" -X POST \
--data "id=12345" \
--data "message=Hello support!"

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

{
"history": [
{
"id": 12345,
"message": "Hello support!",
"component_id": 67890,
"tags": [
"new"
]
}
],
"requests": [
{
"id": 12345,
"request": "Sample request text",
"status": "active"
}
]
}

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

``` { "code": 400, "message": "Please provide request ID" }

```

rhr/discard¶

Утилизирует (отменяет) запрос Remote Hands по его ID. Если предоставлен текст ответа, он сохраняется в историю логов клиента.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
id	✅	int	ID запроса Remote Hands
params[response]	❌	string	Текст ответа/комментарий для сохранения в историю логов клиента

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

curl -s "https://invapi.hostkey.ru/rhr.php" -X POST \
--data "id=123" \
--data "params[response]=Your comment here"

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

{
"result": "OK",
"action": "discard",
"requests": [
{
"id": 123,
"status": "CANCELED",
"request_origin": "CLIENT",
"component_id": 456,
"tags": []
}
],
"history": [
{
"message": "User comment here",
"created_at": "2024-01-15T10:30:00Z"
}
]
}

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

``` { "code": 400, "message": "Please provide request ID" }

```

rhr/list¶

Возвращает список доступных задач Remote Hands (RHR) с возможностью фильтрации по датам, статусам и локациям. Для клиентов также возвращается история изменений.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
params[location]	❌	string	Фильтр по локации (word)
params[status][]	❌	array	Статус запроса (поддерживает перечисление через запятую или точку с запятой)
params[deleted]	❌	boolean	Показывать удаленные записи (true/false)
params[date_from]	❌	string	Дата начала периода (для date_issued)
params[date_to]	❌	string	Дата окончания периода (для date_issued)
params[date][]	❌	array	Массив конкретных дат для фильтрации (для date_issued)
token	✅	string	API-токен аутентификации

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

curl -s "https://invapi.hostkey.ru/rhr.php" -X POST \
--data "action=list" \
--data "token=HOSTKEY_TOKEN" \
--data "params[status][]=active" \
--data "params[status][]=pending"

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

{
"result": "OK",
"action": "list",
"requests": [
{
"id": 123,
"status": "active",
"location": "NL",
"date_created": "2024-05-20T12:00:00Z",
"date_assigned": "2024-05-20T13:00:00Z",
"date_started": "2024-05-20T14:00:00Z",
"date_resolved": "2024-05-20T15:00:00Z",
"date_closed": "2024-05-20T16:00:00Z",
"date_failed": null,
"resolved_by": "admin"
}
],
"history": [
{
"component_id": 123,
"tags": [
{
"name": "tag1",
"value": "val1"
}
]
}
]
}

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

``` { "code": -1, "message": "Empty search parameters disallowed (no known keys)" }

```