history.php¶

В этой статье

Методы API

history/list

Модуль истории событий: получение списка записей истории с фильтрацией по типу сущности и дате

Методы API¶

Метод	Действие	Описание
`list`	получение списка истории	Возвращает список записей журнала событий (history), отсортированных по дате в обратном порядке, с возможностью фильтрации.

history/list¶

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

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
token	✅	string	Токен авторизации для проверки прав доступа.
component	❌	string	Название таблицы сущности или её алиас. По умолчанию: eq.
date_from	❌	string	Дата начала лога. Если не указана, берется из истории ограничений для компонента.
date_to	❌	string	Дата окончания лога. Если не указана, устанавливается на полночь следующего дня после сегодня.
id	❌	`array<integer>`	Массив ID записей лога для отображения.
type	❌	`array<string>`	Массив типов записей для фильтрации.

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

curl -s "https://invapi.hostkey.ru/history.php" -X POST \
--data "action=list" \
--data "token=HOSTKEY_TOKEN" \
--data "component=servers" \
--data "id[]=123" \
--data "type[]=reboot"

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

{
"result": "OK",
"module": "history",
"action": "list",
"history": [
{
"id": 123,
"component": "servers",
"date": "2024-05-20 14:30:00",
"type": "reboot",
"message": "--- End of log ---",
"login": "SYSTEM"
}
]
}

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

{
"-1": "No action specified",
"-2": "Authorization required"
}