tags.php¶

Модуль управления метками (tags) для компонентов инфраструктуры: добавление, удаление, очистка, поиск и отображение списков тегов для серверов и переменных.

Методы API¶

Метод	Действие	Описание
`add`	добавление тега	Добавляет пользовательский тег к серверу или компоненту. Поддерживает массовое добавление через список ID.
`clear`	очистка меток	Очищает все или неэссенциальные метки от компонента. Для клиентов доступны только публичные метки.
`get`	получение меток	Получает метки для компонента. (Реализация в коде пуста, метод в whitelist)
`list`	получение списка тегов	Возвращает список тегов для конкретного сервера или компонента. Для клиентов доступно ограничение по типу компонента (eq, vars).
`remove`	удаление тега	Удаляет тег по его имени для конкретного компонента или удаляет все указанные теги из списка ID. Если передан id_list, операция выполняется массово.
`search`	поиск меток	Ищет компоненты, соответствующие конкретной метке и значению.
`search_user`	поиск оборудования пользователя	Ищет оборудование пользователя по значению метки. Используется в глобальной форме поиска.
`show`	показ возможных меток	Показывает возможные метки для компонента. (Реализация в коде пуста, метод в whitelist)

tags/add¶

Добавляет пользовательский тег к серверу или компоненту. Поддерживает массовое добавление через список ID.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `add`
token	✅	string	Токен авторизации
id	❌	int	ID сервера/компонента
tag	✅	string	Название тега (макс. 32 символа, alphanumeric)
value	❌	string	Значение тега
extra	❌	string	Дополнительная информация
id_list	❌	string	Список ID через запятую для массового добавления

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

curl -s "https://invapi.hostkey.ru/tags.php" -X POST \
--data "action=add" \
--data "token=HOSTKEY_TOKEN" \
--data "id=123" \
--data "tag=my_tag" \
--data "value=my_value"

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

{
"result": "OK",
"action": "add",
"id": 123,
"component": "eq",
"component_id": 45,
"tag": "hostname",
"value": "my-server-01",
"extra": "additional info",
"internal": 0
}

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

``` { "code": -1, "message": "tag/add: invalid token data, too long" }

```

tags/clear¶

Очищает все или неэссенциальные метки от компонента. Для клиентов доступны только публичные метки.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `clear`
token	✅	string	Токен авторизации
id	✅	int	ID сервера (компонента)
component	❌	string	Тип компонента (по умолчанию 'eq')
tag	❌	string	Фильтр очистки. Если 'all', очищаются все метки, включая исключенные

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

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

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

{
"result": "OK",
"action": "clear",
"id": 101,
"component": "eq",
"tags": [
{
"id": 501,
"tag": "preset",
"value": "standard"
}
]
}

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

{
"code": -1,
"message": "tag/clear: invalid server status, can't clean tags from the rented server"
}

tags/get¶

Получает метки для компонента. (Реализация в коде пуста, метод в whitelist)

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `get`
token	✅	string	Токен авторизации
component	❌	string	Тип компонента (eq, vars и т.д.)
component_id	❌	int	ID компонента
internal	❌	int	Флаг отображения внутренних меток (0 или 1)

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

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

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

{
"result": "OK",
"action": "get",
"data": []
}

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

{
"code": -1,
"message": "Method not implemented"
}

tags/list¶

Возвращает список тегов для конкретного сервера или компонента. Для клиентов доступно ограничение по типу компонента (eq, vars).

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
token	✅	string	Токен авторизации
id	❌	int	ID сервера или компонента
component	❌	string	Тип компонента (eq, vars)

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

curl -s "https://invapi.hostkey.ru/tags.php" -X POST \
--data "action=list" \
--data "token=HOSTKEY_TOKEN" \
--data "id=12345" \
--data "component=eq"

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

{
"result": "OK",
"action": "list",
"tags": [
{
"tag": "example_tag",
"value": "example_value",
"extra": "example_extra"
}
]
}

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

``` { "code": -1, "message": "invalid server id" }

```

tags/remove¶

Удаляет тег по его имени для конкретного компонента или удаляет все указанные теги из списка ID. Если передан id_list, операция выполняется массово.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Действие (remove)
token	✅	string	Токен авторизации

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

curl -s "https://invapi.hostkey.ru/tags.php" -X POST \
--data "action=remove" \
--data "token=HOSTKEY_TOKEN" \
--data "tag=example_tag" \
--data "component=eq" \
--data "component_id=789"

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

{
"result": "OK",
"action": "remove",
"id": 12345,
"tag": "example_tag",
"component": "eq",
"component_id": 789
}

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

``` { "code": -1, "message": "module/remove: tag example_tag not found for element 789 on eq" }

```

tags/search¶

Ищет компоненты, соответствующие конкретной метке и значению.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `search`
token	✅	string	Токен авторизации
tag	❌	string	Название метки для поиска
value	❌	string	Значение метки для поиска (поддерживает LIKE)
component	❌	string	Тип компонента (по умолчанию eq)
internal	❌	int	Флаг отображения внутренних меток (0 или 1)

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

curl -s "https://invapi.hostkey.ru/tags.php" -X POST \
--data "action=search" \
--data "token=HOSTKEY_TOKEN" \
--data "tag=location" \
--data "value=NL"

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

{
"result": "OK",
"action": "search",
"tags": [
{
"id": 1001,
"component": "eq",
"component_id": 101,
"tag": "location",
"value": "NL",
"extra": "",
"internal": 0
}
]
}

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

{
"code": -1,
"message": "tag/search: invalid token $token, logout"
}

tags/search_user¶

Ищет оборудование пользователя по значению метки. Используется в глобальной форме поиска.

HTTP-метод: POST

Параметры:

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

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

curl -s "https://invapi.hostkey.ru/tags.php" -X POST \
--data "action=search_user" \
--data "token=HOSTKEY_TOKEN" \
--data "value=VALUE"

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

{
"result": "OK",
"action": "search_user",
"servers": [
{
"id": 101,
"hostname": "server-01",
"ip": "192.168.1.1"
}
]
}

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

{
"code": -1,
"message": "tag/search_user: Nothing found for value"
}

tags/show¶

Показывает возможные метки для компонента. (Реализация в коде пуста, метод в whitelist)

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "show",
"data": []
}

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

{
"code": -1,
"message": "Method not implemented"
}