tags_mgr.php¶

Модуль управления тегами: добавление, удаление, экспорт и инструменты помощи для работы с сущностями

Методы API¶

Метод	Действие	Описание
`add`	добавление	Добавляет новые теги в систему
`assist`	помощь	Запуск интеллектуального помощника по тегам
`components`	получение компонентов	Возвращает список доступных компонентов для тегирования
`delete`	удаление	Удаляет теги по их идентификаторам
`duplicates`	поиск дубликатов	Поиск дублирующихся тегов в системе
`entities`	получение сущностей	Возвращает список сущностей, связанных с тегами
`export`	экспорт	Экспортирует теги в файл или формат данных
`histories`	получение истории	Возвращает историю действий с тегами
`import`	импорт тегов	Запуск процесса импорта тегов из внешнего источника
`list`	получение списка тегов	Возвращает список доступных тегов с фильтрацией
`merge`	слияние тегов	Объединение нескольких тегов в один
`news`	получение новостей	Возвращает ленту новостей системы тегов

tags_mgr/add¶

Добавляет новые теги в систему

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "add",
"data": {
"id": 123,
"name": "new_tag",
"status": "active"
}
}

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

{
"code": -1,
"message": "Action required"
}

tags_mgr/assist¶

Запуск интеллектуального помощника по тегам

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "assist",
"data": {
"suggestions": [
{
"id": 1,
"name": "suggested_tag"
}
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/components¶

Возвращает список доступных компонентов для тегирования

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "components",
"data": {
"items": [
{
"id": 1,
"name": "component_name"
}
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/delete¶

Удаляет теги по их идентификаторам

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "delete",
"data": {
"deleted_count": 1
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/duplicates¶

Поиск дублирующихся тегов в системе

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "duplicates",
"data": {
"duplicates": [
{
"tag_id": 10,
"name": "duplicate_name",
"count": 2
}
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/entities¶

Возвращает список сущностей, связанных с тегами

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "entities",
"data": {
"items": [
{
"id": 50,
"name": "entity_name",
"type": "server"
}
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/export¶

Экспортирует теги в файл или формат данных

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "export",
"data": {
"url": "https://example.com/download/tags.csv",
"format": "csv"
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/histories¶

Возвращает историю действий с тегами

HTTP-метод: POST|GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "histories",
"data": {
"items": [
{
"id": 123,
"user_id": 45,
"action": "add",
"entity_type": "tag",
"entity_id": 789,
"created_at": "2024-05-20T14:30:00Z"
}
]
}
}

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

{
"code": -1,
"message": "Action required"
}

tags_mgr/import¶

Запуск процесса импорта тегов из внешнего источника

HTTP-метод: POST|GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "import",
"data": {
"status": "started",
"job_id": 555,
"callback": "7bc29eb23b879b21fce509597f07c"
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/list¶

Возвращает список доступных тегов с фильтрацией

HTTP-метод: POST|GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "list",
"data": {
"items": [
{
"id": 1,
"name": "production",
"color": "#FF0000",
"count": 15
},
{
"id": 2,
"name": "test",
"color": "#00FF00",
"count": 3
}
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/merge¶

Объединение нескольких тегов в один

HTTP-метод: POST|GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "merge",
"data": {
"target_id": 10,
"merged_ids": [
11,
12,
13
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}

tags_mgr/news¶

Возвращает ленту новостей системы тегов

HTTP-метод: POST|GET

Параметры:

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

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

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

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

{
"result": "OK",
"action": "news",
"data": {
"items": [
{
"id": 1,
"title": "New Tagging System",
"content": "Version 2.0 is out!",
"created_at": "2024-05-20T10:00:00Z"
}
]
}
}

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

{
"code": -1,
"message": "Action is not recognized"
}