Публичный API [3.0]: Работа двигателя
Описание метода
Метод применяется для получения статистик работы двигателя за период.
Предусловия
- Требуется аутентификация
- Требуется OAuth 2.0 scope "units:read"
Допустимое количество машино-дней для метода - не более 3 000
Формат запроса (Request body)
Метод запроса: POST/statistics/units/engine
Метод доступен по ссылке.
| Атрибут | Тип | Обязательность | Описание |
| unitIds | UUID[] | Да | Массив идентификаторов ТС, для которых строится отчёт |
| dateFrom | String | Да | Дата и время начала периода, за который строится отчёт. ISO 8601 с обязательным указанием offset |
| dateTo | String | Да | Дата и время конца периода, за который строится отчёт. ISO 8601 с обязательным указанием offset |
Пример запроса:
{
"unitIds": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"dateFrom": "2026-05-06T06:06:17.671Z",
"dateTo": "2026-05-06T06:06:17.671Z"
}
Формат ответа (Responses Code)
В случае успеха метод возвращает ответ с кодом 200 и телом ответа в формате JSON:
| Атрибут | Тип | Обязательность | Описание | |
| units | Object[] | Да | Массив результатов по ТС | |
| id | UUID | Да | Результаты по ТС | |
| status | enum UnitReportStatus Success FailureNotFound FailureNoTerminal FailureNoSettings NoData |
Да | Статус | |
| result | Object | "Да" для status = Success, не заполняется для остальных |
Результаты запроса по ТС | |
| firstIgnitionOn | String | Нет | Дата и время первого включения двигателя за период. ISO 8601 | |
| lastIgnitionOff | Integer | Нет | Дата и время последнего выключения двигателя за период. ISO 8601 | |
| ignitionDuration | Integer | Да | Время зажигания в секундах | |
| idleDuration | Integer | Да | Время на холостом ходу в секундах | |
Пример ответа:
{
"units": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "Success",
"result": {
"firstIgnitionOn": "2026-05-06T06:06:17.672Z",
"lastIgnitionOff": "2026-05-06T06:06:17.672Z",
"ignitionDuration": "17:31:96",
"idleDuration": "00:33:22"
}
}
]
}
В случае ошибок авторизации или валидации запроса метод возвращает код, соответствующий ошибке, и тело в формате JSON, соответствующее формату Problem Details:
| Тело ответа | Тип | Обязательность | Описание | |
| type | String | Да | Тип ошибки | |
| title | String | Да | Человекочитаемая расшифровка типа ошибки (универсальная для всех запросов) | |
| detail | String | Нет | Комментарий к ошибке (специфичный для этого запроса) | |
| errors | Object[] | Нет | Массив детализированных ошибок | |
| key | String | Да | Тип ошибки | |
| 401 | Unautorized | Токен невалидный или истек срок действия | ||
| 400 | ValidationError | Некорректный формат тела запроса | ||
| 500 | InternalError | Произвольная ошибка на сервере | ||
| values | String[] | Да | Список сообщений к данной ошибке | |