Wialon для разработчиков Руководство пользователя Документация API item add_log_record

add_log_record

Чтобы добавить запись в журнал элемента, используйте метод item/add_log_record.

Copied!

svc=item/add_log_record&params={"itemId":<long>,
								"action":"<text>",
								"newValue":"<text>",
								"oldValue":"<text>"}

Параметры

Название	Описание
`itemId`	ID элемента.
`action`	ID действия, которое записывается в журнал элемента. Список доступных действий приведен ниже.
`newValue`	Параметр действия № 1 (сохраняется как параметр журнала `p1`). Его значение зависит от `action`.
`oldValue`	Параметр действия № 2 (сохраняется как параметр журнала `p2`). Его значение зависит от `action`; для многих действий может быть пустым.

Ниже приведены доступные действия и соответствующий им текст записи в журнале.

Общие

ID действия	Описание действия	Текст действия
`custom_msg`	Произвольная запись	Произвольная запись: ‘%s’.
`create_unit`	Создание элемента	Объект ‘%s’ создан.
`create_user`	Создание элемента	Пользователь ‘%s’ создан.
`create_group`	Создание элемента	Группа объектов ‘%s’ создана.
`create_resource`	Создание элемента	Ресурс ‘%s’ создан.
`create_account`	Создание элемента	Учетная запись ‘%s’ создана.
`delete_item`	Удаление элемента	Элемент ‘%s’ удален.
`delete_account`	Удаление элемента	Учетная запись ‘%s’ удалена.
`update_name`	Изменение имени	Имя объекта изменено с ‘%s’ на ‘%s’.
`update_access`	Изменение доступа	Доступ к пользователю ‘%s’ изменен. Доступ к объекту ‘%s’ изменен. Доступ к группе объектов ‘%s’ изменен. Доступ к ресурсу ‘%s’ изменен. Доступ к маршруту ‘%s’ изменен. Изменены права доступа для пользователя ‘%s’

Свойства объекта

ID действия	Описание действия	Текст действия
`update_unit_icon`	Изменение иконки	Изменена иконка объекта.
`update_unit_pass`	Изменение пароля доступа	Изменен пароль доступа к объекту.
`update_unit_phone`	Изменение телефонного номера	Телефонный номер изменен с ‘%s’ на ‘%s’.
`update_unit_phone2`	Изменение телефонного номера	Второй телефонный номер изменен с ‘%s’ на ‘%s’.
`update_unit_uid`	Изменение уникального ID	Уникальный ID изменен с ‘%s’ на ‘%s’.
`update_unit_uid2`	Изменение уникального ID	Второй уникальный ID изменен с ‘%s’ на ‘%s’.
`update_unit_hw`	Изменение устройства	Тип устройства изменен с ‘%s’ на ‘%s’.
`update_unit_hw_cfg`	Изменение устройства	Изменена конфигурация устройства.

Счетчики

ID действия	Описание действия	Текст действия
`update_unit_calcflags` (обновление настроек расчета для датчика)	Счетчики	Изменены флаги расчета.
`update_unit_milcounter`	Счетчики	Счетчик пробега изменен с %d %s на %d %s.
`update_unit_bytecounter` (обновление значения счетчика GPRS-трафика)	Счетчики	Счетчик GPRS-трафика изменен с %d Кбайт на %d Кбайт.
`update_unit_ehcounter`	Счетчики	Счетчик моточасов изменен с %.2f ч. на %.2f ч.

Настройки отчетов и треков

ID действия	Описание действия	Текст действия
`update_unit_drat` (активность водителя)	Настройки отчета	Изменен метод определения активности водителя.
`update_unit_fuel_cfg`	Настройки отчета	Изменены настройки расхода топлива.
`update_unit_trip_cfg`	Настройки отчета	Изменены настройки детектора поездок.
`update_unit_report_cfg` (обновление параметров, используемых в отчетах)	Настройки отчета	Изменены параметры объекта, используемые в отчетах.
`update_msgs_filter_cfg` (обновление настроек фильтрации местоположения объекта в сообщениях)	Настройки отчета	Изменены настройки фильтрации сообщений.
`update_speed_settings`	Настройки отчета	Изменены настройки источника скорости.
`convert_measure_units`	Настройки отчета	Система мер изменена на %s. Конвертация в %s.
`update_track_color_setting`	Треки	Настройки цвета трека изменены на «По поездкам». Настройки цвета трека изменены на «Однотонный». Настройки цвета трека изменены на «По скорости». Настройки цвета трека изменены на «По датчику».

В Wialon Local действие update_speed_settings доступно начиная с версии 2404.

События с топливом

ID действия	Описание действия	Текст действия
`mark_filling_event`	События	Заправка объемом %s, выполненная %s, отмечена как ложная.
`unmark_filling_event`	События	С заправки объемом %s, выполненной %s, снята отметка ложной.
`mark_theft_event`	События	Слив объемом %s, выполненный %s, отмечен как ложный.
`unmark_theft_event`	События	Со слива объемом %s, выполненного %s, снята отметка ложного.

Для этих действий newValue (параметр журнала p1) содержит объем топлива, а oldValue (параметр журнала p2) — время события в формате UNIX.

В Wialon Local эти действия доступны начиная с версии 2404.

Диагностика

ID действия	Описание действия	Текст действия
`update_health_check_parameters`	Параметры диагностики	Обновлены параметры диагностики объекта.

В Wialon Local действие update_health_check_parameters доступно начиная с версии 2504.

Датчики

ID действия	Описание действия	Текст действия
`create_sensor`	Датчики	Создан датчик ‘%s’.
`update_sensor`	Датчики	Датчик ‘%s’ изменен.
`delete_sensor`	Датчики	Датчик ‘%s’ удален.

Команды

ID действия	Описание действия	Текст действия
`create_alias`	Команды	Команда ‘%s’ создана.
`update_alias`	Команды	Команда ‘%s’ изменена.
`delete_alias`	Команды	Команда ‘%s’ удалена.

Интервалы техобслуживания

ID действия	Описание действия	Текст действия
`create_service_interval`	Интервалы техобслуживания	Интервал техобслуживания ‘%s’ создан.
`update_service_interval`	Интервалы техобслуживания	Интервал техобслуживания ‘%s’ изменен.
`delete_service_interval`	Интервалы техобслуживания	Интервал техобслуживания ‘%s’ удален.

Поля

ID действия	Описание действия	Текст действия
`create_custom_field`	Поля	Произвольное поле ‘%s’ создано.
`update_custom_field`	Поля	Произвольное поле ‘%s’ изменено.
`delete_custom_field`	Поля	Произвольное поле ‘%s’ удалено.
`create_admin_field`	Поля	Административное поле ‘%s’ создано.
`update_admin_field`	Поля	Административное поле ‘%s’ изменено.
`delete_admin_field`	Поля	Административное поле ‘%s’ удалено.
`update_profile_field`	Поля	Характеристика ‘%s’ изменена.
`delete_profile_field`	Поля	Характеристика ‘%s’ удалена.

Импорт и экспорт

ID действия	Описание действия	Текст действия
`import_item_cfg`	Импорт	Свойства импортированы.
`import_unit_cfg`	Импорт	Свойства импортированы.
`import_unit_msgs`	Импорт	Сообщения импортированы.
`export_unit_msgs`	Экспорт	Сообщения экспортированы.

Сообщения

ID действия	Описание действия	Текст действия
`delete_unit_msg`	Удаление сообщений	Удалено SMS-сообщение от %s. Удалено сообщение об отправке команды от %s. Удалено зарегистрированное событие от %s. Удалено сообщение с данными от %s.
`delete_unit_msgs`	Удаление сообщений	Удалено %s SMS-сообщений. Удалено %s сообщений об отправке команд. Удалено %s зарегистрированных событий. Удалено %s сообщений с данными.

Для этих действий oldValue (параметр журнала p2) содержит тип удаленных сообщений: 256 (0x0100) для SMS-сообщений, 512 (0x0200) для команд, 1536 (0x0600) для событий. Любое другое значение означает сообщения с данными. Для delete_unit_msg параметр newValue (параметр журнала p1) содержит время сообщения в формате UNIX. Для delete_unit_msgs параметр newValue содержит количество удаленных сообщений.

Водители

ID действия	Описание действия	Текст действия
`bind_unit_driver`	Водители	Водитель ‘%s’ был назначен в ‘%s’.
`unbind_unit_driver`	Водители	Водитель ‘%s’ был снят в ‘%s’.
`create_driver`	Водители	Водитель ‘%s’ создан.
`update_driver`	Водители	Водитель ‘%s’ обновлен.
`delete_driver`	Водители	Водитель ‘%s’ удален.
`driver_reset_image`	Водители	Водитель ‘%s’ обновлен.
`delete_driver_msg`	Водители	Удалено сообщение от %s о назначении/снятии водителя ‘%s’.
`ignore_bind_unit_driver`	Водители	Назначение водителя ‘%s’ отмечено как ложное %s.
`ignore_unbind_unit_driver`	Водители	Снятие водителя ‘%s’ отмечено как ложное %s.
`ignore_any_unit_driver`	Водители	Все назначения и снятия водителя ‘%s’ в интервале были отмечены как ложные %s.
`delete_driver_action_bind`	Водители	Назначение водителя ‘%s’ удалено %s.
`delete_driver_action_unbind`	Водители	Снятие водителя ‘%s’ удалено %s.
`delete_driver_action_ignore_bind`	Водители	С назначения водителя ‘%s’ удалена отметка ложного %s.
`delete_driver_action_ignore_unbind`	Водители	Со снятия водителя ‘%s’ удалена отметка ложного %s.
`delete_driver_action_ignore_any`	Водители	Со всех назначений и снятий водителя ‘%s’ в интервале сняты отметки ложных %s.
`resource_bind_unit_driver`	Водители	Водитель ‘%s’ назначен ‘%s’ на объект ‘%s’.
`resource_unbind_unit_driver`	Водители	Водитель ‘%s’ снят %s с объекта ‘%s’.
`resource_ignore_bind_unit_driver`	Водители	Назначение водителя ‘%s’ на объект ‘%s’ отмечено как ложное %s.
`resource_ignore_unbind_unit_driver`	Водители	Снятие водителя ‘%s’ с объекта ‘%s’ отмечено как ложное %s.
`resource_ignore_any_unit_driver`	Водители	Все назначения и снятия водителя ‘%s’, связанные с объектом ‘%s’, были отмечены как ложные %s.
`resource_delete_driver_action_bind`	Водители	Назначение водителя ‘%s’ на объект ‘%s’ удалено %s.
`resource_delete_driver_action_unbind`	Водители	Снятие водителя ‘%s’ с объекта ‘%s’ удалено %s.
`resource_delete_driver_action_ignore_bind`	Водители	С назначения водителя ‘%s’ на объект ‘%s’ удалена отметка ложного %s.
`resource_delete_driver_action_ignore_unbind`	Водители	Со снятия водителя ‘%s’ с объекта ‘%s’ удалена отметка ложного %s.
`resource_delete_driver_action_ignore_any`	Водители	Со всех назначений и снятий водителя ‘%s’, связанных с объектом ‘%s’, в интервале сняты отметки ложных %s.
`create_drivers_group`	Водители	Группа водителей ‘%s’ создана.
`update_drivers_group`	Водители	Группа водителей ‘%s’ обновлена.
`delete_drivers_group`	Водители	Группа водителей ‘%s’ удалена.
`update_driver_units` (обновление списка водителей, которые должны назначаться на объекты автоматически)	Изменение групп	Объект прикреплен к ресурсу водителей ‘%s’. Объект откреплен от ресурса водителей ‘%s’. Группа объектов прикреплена к ресурсу водителей ‘%s’. Группа объектов откреплена от ресурса водителей ‘%s’. Список автоматического назначения водителей обновлен.

Действия с префиксом resource_ записываются в журнал ресурса, а остальные действия, связанные с назначением водителей, — в журнал объекта.

Действия ignore_*, delete_driver_action_*, resource_ignore_*, resource_delete_driver_action_*, resource_bind_unit_driver и resource_unbind_unit_driver недоступны в Wialon Local.

Прицепы

ID действия	Описание действия	Текст действия
`bind_unit_trailer`	Прицепы	Прицеп ‘%s’ был назначен в ‘%s’.
`unbind_unit_trailer`	Прицепы	Прицеп ‘%s’ был снят в ‘%s’.
`create_trailer`	Прицепы	Прицеп ‘%s’ создан.
`update_trailer`	Прицепы	Прицеп ‘%s’ обновлен.
`delete_trailer`	Прицепы	Прицеп ‘%s’ удален.
`trailer_reset_image`	Прицепы	Прицеп ‘%s’ обновлен.
`delete_trailer_msg`	Прицепы	Удалено сообщение от %s о назначении/снятии прицепа ‘%s’.
`create_trailers_group`	Прицепы	Группа прицепов ‘%s’ создана.
`update_trailers_group`	Прицепы	Группа прицепов ‘%s’ обновлена.
`delete_trailers_group`	Прицепы	Группа прицепов ‘%s’ удалена.
`update_trailer_units` (обновление списка прицепов, которые должны назначаться на объекты автоматически)	Изменение групп	Объект прикреплен к ресурсу прицепов ‘%s’. Объект откреплен от ресурса прицепов ‘%s’. Группа объектов прикреплена к ресурсу прицепов ‘%s’. Группа объектов откреплена от ресурса прицепов ‘%s’. Список автоматического назначения прицепов обновлен.

Пассажиры

ID действия	Описание действия	Текст действия
`bind_unit_tag`	Пассажиры	Пассажир ‘%s’ был назначен в ‘%s’.
`unbind_unit_tag`	Пассажиры	Пассажир ‘%s’ был снят в ‘%s’.
`create_tag`	Метки	Пассажир ‘%s’ создан.
`update_tag`	Метки	Пассажир ‘%s’ обновлен.
`tag_reset_image`	Метки	Пассажир ‘%s’ обновлен.
`delete_tag`	Метки	Пассажир ‘%s’ удален.
`delete_tag_msg`	Метки	Удалено сообщение от %s о посадке/высадке пассажира ‘%s’.
`update_tag_units`	Метки	Список автоматического назначения пассажиров обновлен.

Настройки пользователя

ID действия	Описание действия	Текст действия
`update_hosts_mask`	Настройки пользователя	Маска хоста изменена на ‘%s’.
`update_user_pass`	Настройки пользователя	Пароль пользователя изменен.
`update_user_flags`	Настройки пользователя	Флаги пользователя изменены.
`update_user_locale`	Настройки пользователя	Первый день недели изменен.
`create_user_notify`	Настройки пользователя	Информационное сообщение пользователю: ‘%s’.
`delete_user_notify`	Настройки пользователя	Удалено сообщение пользователю: ‘%s’.

Группы объектов

ID действия	Описание действия	Текст действия
`units_group` (добавление объектов в группу или их удаление из группы)	Изменение групп	Объект добавлен в группу ‘%s’. Объект удален из группы ‘%s’. Объекты в группе обновлены.

Геозоны

ID действия	Описание действия	Текст действия
`create_zone`	Геозоны	Геозона ‘%s’ создана.
`update_zone`	Геозоны	Геозона ‘%s’ обновлена.
`delete_zone`	Геозоны	Геозона ‘%s’ удалена.
`import_zones`	Геозоны	Геозоны импортированы.
`create_zones_group`	Геозоны	Группа геозон ‘%s’ создана.
`update_zones_group`	Геозоны	Группа геозон ‘%s’ обновлена.
`delete_zones_group`	Геозоны	Группа геозон удалена.
`zone_reset_image`	Геозоны	Геозона ‘%s’ обновлена.

Задания

ID действия	Описание действия	Текст действия
`create_job`	Задания	Задание ‘%s’ создано.
`switch_job`	Задания	Задание ‘%s’ включено/выключено.
`update_job`	Задания	Задание ‘%s’ обновлено.
`delete_job`	Задания	Задание ‘%s’ удалено.

Уведомления

ID действия	Описание действия	Текст действия
`create_notify`	Уведомления	Уведомление ‘%s’ создано.
`switch_notify`	Уведомления	Уведомление ‘%s’ включено/выключено.
`update_notify`	Уведомления	Уведомление ‘%s’ обновлено.
`delete_notify`	Уведомления	Уведомление ‘%s’ удалено.

Шаблоны отчетов

ID действия	Описание действия	Текст действия
`create_report`	Шаблоны отчетов	Шаблон отчета ‘%s’ создан.
`update_report`	Шаблоны отчетов	Шаблон отчета ‘%s’ обновлен.
`delete_report`	Шаблоны отчетов	Шаблон отчета ‘%s’ удален.

Ретрансляторы

ID действия	Описание действия	Текст действия
`create_retranslator`	Ретрансляторы	Ретранслятор ‘%s’ создан.
`update_retranslator`	Ретрансляторы	Свойства изменены.
`units_retranslator`	Ретрансляторы	Объекты обновлены.
`switch_retranslator`	Ретрансляторы	Запущен/Остановлен.
`msgs_history_retranslator`	Ретрансляторы	Запущена ретрансляция истории. Остановлена ретрансляция истории.

Маршруты

ID действия	Описание действия	Текст действия
`create_route`	Маршруты	Маршрут ‘%s’ создан.
`update_route_points`	Маршруты	Контрольные точки обновлены.
`update_route_cfg`	Маршруты	Свойства изменены.
`create_round`	Маршруты	Рейс ‘%s’ создан.
`update_round`	Маршруты	Рейс ‘%s’ обновлен.
`delete_round`	Маршруты	Рейс ‘%s’ удален.
`create_schedule`	Маршруты	Расписание ‘%s’ создано.
`update_schedule`	Маршруты	Расписание ‘%s’ обновлено.
`delete_schedule`	Маршруты	Расписание ‘%s’ удалено.

Учетные записи

ID действия	Описание действия	Текст действия
`change_account`	Учетная запись	Учетная запись изменена с ‘%s’ на ‘%s’.
`switch_account`	Учетная запись	Учетная запись заблокирована/Учетная запись разблокирована.
`update_dealer_rights`	Учетная запись	Права дилера включены/выключены.
`do_payment`	Учетная запись	Зарегистрирована оплата или дни.
`update_account_flags`	Учетная запись	Флаги учетной записи изменены.
`update_account_block_balance`	Учетная запись	Изменен баланс для блокировки учетной записи.
`update_account_deny_balance`	Учетная запись	Изменен баланс для ограничения активности.
`update_account_min_days`	Учетная запись	Изменен счетчик лимита дней.
`update_account_plan`	Учетная запись	Тарифный план изменен на ‘%s’.
`update_account_history_period`	Учетная запись	Срок хранения истории изменен на %s дней.
`update_account_subplans`	Учетная запись	Перечень доступных тарифных планов изменен.
`update_service`	Учетная запись	Сервис ‘%s’ обновлен.
`set_business_sphere`	Учетная запись	Сфера бизнеса учетной записи изменена на ‘%s’.

В Wialon Local действие set_business_sphere доступно начиная с версии 2404.

Заявки

ID действия	Описание действия	Текст действия
`create_order`	Заявки	Заявка ‘%s’ создана.
`update_order`	Заявки	Заявка ‘%s’ обновлена.
`delete_order`	Заявки	Заявка ‘%s’ удалена.
`create_order_route`	Заявки	Маршрут заявок ‘%s’ создан.
`update_order_route`	Заявки	Маршрут заявок ‘%s’ обновлен.
`delete_order_route`	Заявки	Маршрут заявок ‘%s’ удален.

Критерии

ID действия	Описание действия	Текст действия
`criteria_updated`	Критерии	Критерии обновлены.

Деактивация и активация объектов

ID действия	Описание действия	Текст действия
`set_active`	Активация/деактивация	`0`: Объект деактивирован. `1`: Объект активирован. `2`: Объект активирован автоматически.

Действие set_active записывается для объекта, указанного в itemId; параметр newValue (параметр журнала p1) хранит состояние активации: 0 — деактивирован, 1 — активирован, 2 — активирован автоматически.

Оповещения об истечении срока действия кодов активации

ID действия	Описание действия	Текст действия
`create_notice`	Создание оповещения об истечении срока действия кода активации	Оповещение ‘%s’ создано для пользователя.
`update_notice`	Обновление оповещения об истечении срока действия кода активации	Оповещение ‘%s’ обновлено для пользователя.
`delete_notice`	Удаление оповещения об истечении срока действия кода активации	Оповещение ‘%s’ удалено.
`trigger_notice`	Отправка оповещения об истечении срока действия кода активации	Оповещение ‘%s’ отправлено пользователю.

Эти действия недоступны в Wialon Local.

Коды активации

ID действия	Описание действия	Текст действия
`update_unit_billing_code`	Обновление параметра кода активации	Код активации обновлен.
`share_billing_code`	Коды активации	Доступ к коду активации ‘%s’ предоставлен для учетной записи ‘%s’.
`unshare_billing_code`	Коды активации	Доступ к коду ‘%s’ больше не предоставляется для учетной записи ‘%s’.

Эти действия недоступны в Wialon Local.

Задачи

ID действия	Описание действия	Текст действия
`create_task`	Задачи	Задача ‘%s’ создана.
`update_task_priority`	Задачи	Приоритет задачи ‘%s’ изменен на ‘%s’.
`update_task_status`	Задачи	Статус задачи ‘%s’ изменен на ‘%s’.
`update_task_assignee`	Задачи	Ответственный за задачу ‘%s’ изменен на ‘%s’.
`add_task_comment`	Задачи	К задаче ‘%s’ добавлен комментарий.
`edit_task_comment`	Задачи	Комментарий к задаче ‘%s’ изменен.
`delete_task_comment`	Задачи	Комментарий к задаче ‘%s’ удален.
`delete_task`	Задачи	Задача ‘%s’ удалена.

В Wialon Local эти действия доступны начиная с версии 2504.

Ключи источников карт

ID действия	Описание действия	Текст действия
`create_map_key`	Источник карт	Ключ ‘%s’ добавлен.
`update_map_key`	Источник карт	Ключ ‘%s’ обновлен.
`delete_map_key`	Источник карт	Ключ ‘%s’ удален.

В Wialon Local эти действия доступны начиная с версии 2304.

Видео

ID действия	Описание действия	Текст действия
`video_enabled_for_unit`	Видео	Видеомониторинг и его тарификация включены для объекта ‘%s’. Видеомониторинг и его тарификация включены.
`video_disabled_for_unit`	Видео	Видеомониторинг и его тарификация выключены для объекта ‘%s’. Видеомониторинг и его тарификация выключены.
`update_video_settings`	Видео	Настройки видео изменены для объекта ‘%s’. Настройки видео изменены.
`file_saved`	Видео	Файл успешно сохранен.
`file_not_saved`	Видео	Файл не сохранен.
`delete_file`	Видео	Файл объекта ‘%s’ удален. Файл удален.
`buy_packages_manually`	Видео	Пакеты трафика (%d) куплены для объекта ‘%s’. Пакеты трафика (%d) куплены.
`automatic_packages_purchase_limit_change`	Видео	Лимит на автоматическую покупку пакетов трафика изменен на ‘%d’ для объекта ‘%s’. Лимит на автоматическую покупку пакетов трафика изменен на ‘%d’.
`update_video_packets_auto`	Видео	Пакеты трафика (%d) куплены.
`video_autopay_successed`	Видео	Пакет трафика куплен автоматически.
`video_autopay_failed`	Видео	Не удалось автоматически купить пакет трафика.

Для действий с двумя вариантами текста первый вариант используется, если соответствующий параметр содержит имя объекта.

Эти действия недоступны в Wialon Local.

Действия с оповещениями об истечении срока действия кодов активации записываются в журнал каждого получателя оповещения. Для каждого действия отправляется запрос item/add_log_record со следующими параметрами:

`action`	`itemId`	`newValue`	`oldValue`
`create_notice`	ID пользователя-получателя	Имя оповещения	`""` (пусто)
`update_notice`	ID пользователя-получателя	Новое имя оповещения	`""` (пусто)
`delete_notice`	ID пользователя-получателя	Имя оповещения	`""` (пусто)

Ответ

Если запрос успешно выполнен, возвращается пустой JSON.

Copied!

{ }

В противном случае возвращается код ошибки. Возможные коды ошибок:

Код	Описание
7	Элемент не существует, или у пользователя нет права доступа Управление журналом на него.
4	Неверные входные параметры.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.