update_events

Чтобы отметить заправку или слив топлива как ложное событие либо снять такую отметку, используйте метод unit/update_events.

События, отмеченные как ложные, показываются в отчетах только при включенной опции Показывать ложные события в настройках шаблона отчета.

svc=unit/update_events&params={
    "events": [
        {
            "itemId": <long>,
            "resourceId": <long>,
            "eventType": <text>,
            "timeFrom": <uint>,
            "timeTo": <uint>,
            "params": {
                "mark": <uint>,
                "mark_type": <text>
            }
        }
    ]
}

Запрос должен содержать следующие параметры:

Заправка и слив топлива могут быть зарегистрированы в один и тот же промежуток времени. Используйте mark_type, чтобы указать, какое из событий отметить как ложное. Без этого параметра отметка применяется к обоим событиям.

При успешном выполнении запроса возвращается ответ в следующем формате:

{
  "items": [
    {
      "itemId": <long>,   /* ID объекта. */
      "error": <uint>     /* Результат для события: 0, если отметка обновлена, 7, если нет права доступа. */
    }
  ]
}

Массив items содержит один объект для каждого события из запроса, в том же порядке.

Поле error содержит 7, если у пользователя нет права доступа Создание, редактирование и удаление шаблонов отчетов на ресурс или права доступа Просмотр элемента и его основных свойств на объект.

Если запрос не выполнен, возвращается код ошибки.

Чтобы отметить два события заправки топлива объекта с ID 1285 как ложные, используется следующий запрос. Параметр mark_type указан как fillings, чтобы отметить только заправки, а не сливы топлива, зарегистрированные в то же время:

svc=unit/update_events&params={
  "events": [
    {
      "itemId": 1285,
      "resourceId": 123,
      "eventType": "lls",
      "timeFrom": 1689734883,
      "timeTo": 1689734883,
      "params": {
        "mark": 1,
        "mark_type": "fillings"
      }
    },
    {
      "itemId": 1285,
      "resourceId": 123,
      "eventType": "lls",
      "timeFrom": 1689737145,
      "timeTo": 1689737145,
      "params": {
        "mark": 1,
        "mark_type": "fillings"
      }
    }
  ]
}

Ответ содержит один объект для каждого события из запроса. В этом примере error: 0 для обоих событий означает, что отметка ложного события успешно обновлена:

{
  "items": [
    {
      "itemId": 1285,
      "error": 0
    },
    {
      "itemId": 1285,
      "error": 0
    }
  ]
}