tags_mgr.php¶

В этой статье

Методы API

tags_mgr/add

tags_mgr/assist

tags_mgr/components

tags_mgr/delete

tags_mgr/duplicates

tags_mgr/edit

tags_mgr/entities

tags_mgr/export

tags_mgr/histories

tags_mgr/import

tags_mgr/list

tags_mgr/merge

tags_mgr/news

tags_mgr/view

Модуль управления тегами: редактирование существующих тегов и просмотр информации о них

Методы API¶

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

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,
"type": "duplicate",
"reason": "similar name"
}
]
}
}

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

{
"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",
"type": "system"
}
]
}
}

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

{
"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": {
"items": [
{
"id": 10,
"name": "duplicate_tag",
"matches": [
"original_tag"
]
}
]
}
}

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

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

tags_mgr/edit¶

Обновляет существующий тег или его параметры

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "edit",
"data": {
"id": 123,
"status": "updated"
}
}

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

{
"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": {
"file_url": "https://example.com/exports/tags_2024.csv",
"status": "processing",
"job_key": "7bc29eb23b1b879b21fce509597f07c"
}
}

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

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

tags_mgr/histories¶

Получение истории действий и изменений тегов

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
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": 1024,
"user_name": "admin",
"action": "edit",
"created_at": "2024-05-20T14:30:00Z",
"details": {
"field": "name",
"old_value": "old_tag",
"new_value": "new_tag"
}
}
]
}
}

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

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

tags_mgr/import¶

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

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
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": "success",
"imported_count": 45,
"callback": "7bc29eb23b1b879b21fce509597f07c"
}
}

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

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

tags_mgr/list¶

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

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
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",
"status": "active",
"created_at": "2024-01-01T00:00:00Z"
},
{
"id": 2,
"name": "staging",
"status": "active",
"created_at": "2024-01-02T12:00:00Z"
}
],
"total": 2
}
}

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

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

tags_mgr/merge¶

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

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
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": {
"merged_id": 1,
"removed_ids": [
2,
3,
4
],
"callback": "7bc29eb23b1b879b21fce509597f07c"
}
}

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

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

tags_mgr/news¶

Получение ленты новостей системы тегов

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
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": "System Update",
"content": "New tag management features added.",
"date": "2024-05-20T10:00:00Z"
}
]
}
}

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

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

tags_mgr/view¶

Детальная информация о конкретном теге

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "view",
"data": {
"id": 123,
"name": "example_tag",
"description": "Tag description here",
"status": "active",
"created_at": "2024-01-15T10:30:00Z"
}
}

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

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