Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/07/25 10:14
on 2024/07/25 10:14
edited by Андрей Калиновский
on 2024/11/22 13:26
on 2024/11/22 13:26
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,11 +1,9 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -**Содержание страницы:** 3 +**Содержание страницы:**\ 4 4 ))) 5 5 6 -{{toc/}} 7 7 8 - 9 9 = (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) = 10 10 11 11 (% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов). ... ... @@ -14,11 +14,20 @@ 14 14 15 15 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 16 16 17 -(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователяв теле запроса! Те параметры, значения которых не будут переданы - будут стерты!15 +(% style="color:#000000" %)− (%%)При **редактировании** любой записи (пользователь, объект и т.д) необходимо передавать все параметры записи в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 18 18 17 + 18 +(% style="color:#000000; font-size:16px" %)**Рекомендации** 19 + 20 +- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 21 + 19 19 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 20 20 21 -== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 24 +(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 25 +((( 26 +(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 27 +(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 28 +))) 22 22 23 23 (% class="box successmessage" %) 24 24 ((( ... ... @@ -971,7 +971,7 @@ 971 971 972 972 Ответ: В случае успеха **Success 200** 973 973 974 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 981 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) = 975 975 976 976 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 977 977 ... ... @@ -1163,6 +1163,77 @@ 1163 1163 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1164 1164 1165 1165 1173 +== **Импортировать историю ТС (Асинхронный запрос)** == 1174 + 1175 +(% class="box successmessage" %) 1176 +((( 1177 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1178 +))) 1179 + 1180 +(% style="color:#000000" %)Метод запроса: **POST** 1181 + 1182 +(% style="color:#000000" %)URL запроса: (%%)**https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1183 + 1184 +(% style="color:#000000" %)Параметр запроса: {__**vehicleid}**__ - идентификатор транспортного средства 1185 + 1186 + 1187 +Ответ: 1188 + 1189 +{ 1190 + 1191 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1192 + 1193 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1194 + 1195 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1196 + 1197 + "Message": "string", ~/~/ Информация о выполнении запроса 1198 + 1199 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1200 + 1201 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1202 + 1203 + "Data": "string" ~/~/ Данные 1204 + 1205 +} 1206 + 1207 + 1208 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 1209 + 1210 +(% class="box infomessage" %) 1211 +((( 1212 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1213 +))) 1214 + 1215 +(% style="color:#000000" %)Метод запроса: **GET** 1216 + 1217 +(% style="color:#000000" %)URL запроса: (%%)https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1218 + 1219 +(% style="color:#000000" %)Параметр запроса: {(%%)**requestId(% style="color:#000000" %)__}__(%%)**(% style="color:#000000" %) - (%%)Уникальный идентификатор запроса 1220 + 1221 + 1222 +Ответ: 1223 + 1224 +{ 1225 + 1226 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1227 + 1228 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 1229 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1230 + 1231 + "Message": "string", ~/~/ Информация о выполнении запроса 1232 + 1233 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1234 + 1235 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1236 + 1237 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1238 + 1239 + "Data": "string" ~/~/ Данные 1240 + 1241 +} 1242 + 1243 + 1166 1166 == **Отправить команду на терминал** == 1167 1167 1168 1168 (% class="box successmessage" %) ... ... @@ -1179,8 +1179,6 @@ 1179 1179 "idTemplate": "" ~/~/ ID шаблона команды 1180 1180 } 1181 1181 1182 -(% class="wikigeneratedid" %) 1183 -== == 1184 1184 1185 1185 == **Получить ответ на отправленную на ТС команду** == 1186 1186 ... ... @@ -1365,17 +1365,31 @@ 1365 1365 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1366 1366 ~/~/ "ValueOn": "Вкл.", 1367 1367 ~/~/ "ValueOff": "Выкл." 1368 - "summaryMaxValue": 0 ~/~/ Макс. значение 1444 + "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1445 + 1446 +((( 1447 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1448 + { 1449 + "from": 0, ~/~/ С какого значения 1450 + "color": "string", ~/~/ Каким цветом 1451 + "text": "string" ~/~/ Текст подписи к этому интервалу 1452 + } 1453 + ] 1369 1369 } 1370 1370 ], 1456 +))) 1457 + 1458 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1459 + 1460 + 1371 1371 "customFields": [ ~/~/ Произвольные поля 1372 1372 { 1373 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1374 - "name": "string", 1375 - "value": "string", 1376 - "forClient": true, 1377 - "forTooltip": true, 1378 - "forReport": true 1463 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1464 + "name": "string", ~/~/ Наименование произвольного поля 1465 + "value": "string", ~/~/ Значение произвольного поля 1466 + "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1467 + "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1468 + "forReport": true ~/~/ Отобразить произвольное поле в отчете 1379 1379 } 1380 1380 ] 1381 1381 } ... ... @@ -1382,52 +1382,161 @@ 1382 1382 1383 1383 (% style="color:#000000" %)Ответ: 1384 1384 1385 -(% style="color:#000000" %){(%%) 1386 - "vehicleId": "", ~/~/ID ТС 1387 - "parentId": "", ~/~/Guid владельца ТС 1388 - "name": "", ~/~/Имя объекта 1389 - "imei": "", ~/~/IMEI 1390 - "deviceTypeId": "", ~/~/ID типа устройства 1391 - "modelId": "", ~/~/ID модели 1392 - "unitId": "", ~/~/ID подразделения 1393 - "sim1": "", ~/~/SIM1 1394 - "sim2": "", ~/~/SIM2 1395 - "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1396 - "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1397 - "counters": { ~/~/Счётчики 1398 - "mileageEnabled": true, 1399 - "motohoursEnabled": true, 1400 - "mileage": "", 1401 - "motohours": 345.0 1402 - }, 1403 - "cmsv6Parameters": { ~/~/Параметры CmsV6 1404 - "id": null, 1405 - "enabled": true, ~/~/флаг включения 1406 - "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1407 - "login": "", ~/~/ имя учетной записи 1408 - "password": "" ~/~/ пароль учетной записи 1409 - }, 1410 - "inspectionTasks": { ~/~/ задания на ТО 1411 - "id": "", ~/~/ ID задачи 1412 - "enabled": false, ~/~/ Признак включения 1413 - "name": "", ~/~/ Имя задания 1414 - "description": "", ~/~/ Описание задания 1415 - "mileageCondition": "", ~/~/ Условие по пробегу 1416 - "lastMileage": "", ~/~/ Пробег (в метрах) 1417 - "motohoursCondition": "", ~/~/ Условие по моточасам 1418 - "lastMotohours": "", ~/~/ Моточасы 1419 - "periodicCondition": "", ~/~/ Условие периодичности по времени 1420 - "kind": "", ~/~/ Вид периодичности по времени 1421 - "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1475 + 1476 +((( 1477 +((( 1478 +((( 1479 +{ 1480 + "vehicleId": 0, ~/~/ ID ТС 1481 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1482 + "name": "string", ~/~/ Имя объекта 1483 + "imei": "string", ~/~/ IMEI 1484 + "deviceTypeId": 0, ~/~/ ID типа устройства 1485 + "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1486 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1487 + "sim1": "string", ~/~/ SIM1 1488 + "sim2": "string", ~/~/ SIM2 1489 + "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1490 + "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1491 + "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1492 + "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1493 + "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1494 + "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1495 + "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1496 + "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1497 + "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1498 + "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1499 + "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1500 + "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1501 + "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1502 + "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1503 + "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1504 + "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1505 + "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1506 + "counters": { ~/~/ Dto для состояний счётчиков 1507 + "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1508 + "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1509 + "mileage": 0, ~/~/ Пробег 1510 + "motohours": 0 ~/~/ Моточасы 1511 + }, 1512 + "cmsv6Parameters": { ~/~/ Dto для CMSv6 1513 + "id": "string", ~/~/ CMSV6 Идентификатор 1514 + "enabled": true, ~/~/ Признак включения 1515 + "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1516 + "login": "string", ~/~/ CMSV6 имя учетной записи 1517 + "password": "string" ~/~/ CMSV6 — пароль учетной записи 1518 + }, 1519 + "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1520 + { 1521 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1522 + "enabled": true, ~/~/ Признак включения 1523 + "name": "string", ~/~/ Имя задания 1524 + "description": "string", ~/~/ Описание задания 1525 + "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1526 + "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1527 + "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1528 + "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1529 + "periodicCondition": 0, ~/~/ Условие периодичности по времени 1530 + "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1531 + "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1532 + "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 1422 1422 } 1423 -(% style="color:#000000" %)} 1534 + ], 1535 + "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1536 + { 1537 + "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1538 + "inputNumber": 0, ~/~/ № входа. 1539 + "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1540 + "comment": "string", ~/~/ Комментарий 1541 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1542 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1543 + "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1544 + "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1545 + } 1546 + ], 1547 + "commandTemplates": [ ~/~/ Список шаблонов команд 1548 + { 1549 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1550 + "name": "string", ~/~/ Название шаблона команд 1551 + "command": "string", ~/~/ Команда на выполнение 1552 + "retries": 0 ~/~/ Лимит попыток отправки 1553 + } 1554 + ], 1555 + "sensors": [ ~/~/ Список датчиков 1556 + { 1557 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1558 + "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1559 + "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 1560 + "name": "string", ~/~/ Имя датчика 1561 + "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1562 + "inputNumber": 0, ~/~/ Номер входа 1563 + "pseudonym": "string", ~/~/ Псевдоним 1564 + "medianDegree": 0, ~/~/ Степень медианной фильтрации 1565 + "isInverted": true, ~/~/ Признак инверсии 1566 + "disabled": true, ~/~/ Датчик не участвует в обработке 1567 + "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1568 + "gradesTables": [ ~/~/ Тарировка 1569 + { 1570 + "grades": [ ~/~/ Таблицы тарировки 1571 + { 1572 + "input": 0, ~/~/ Вход 1573 + "output": 0 ~/~/ Выход 1574 + } 1575 + ], 1576 + "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1577 + } 1578 + ], 1579 + "showInTooltip": true, ~/~/ Отображение в подсказке 1580 + "showLastValid": true, ~/~/ Отображать последнее валидное значение 1581 + "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1582 + "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1583 + "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1584 + "expr": "string", ~/~/ Выражение 1585 + "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1586 + "string" 1587 + ], 1588 + "customParams": { 1589 + "additionalProp1": "string", 1590 + "additionalProp2": "string", 1591 + "additionalProp3": "string" 1592 + }, 1593 + "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1594 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1595 + { 1596 + "from": 0, ~/~/ С какого значения 1597 + "color": "string", ~/~/ Каким цветом 1598 +))) 1424 1424 1600 +((( 1601 + "text": "string" ~/~/ Текст подписи к этому интервалу 1602 + } 1603 + ] 1604 + } 1605 + ], 1606 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1607 + "customFields": [ ~/~/ Список произвольных полей 1608 + { 1609 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1610 + "name": "string", ~/~/ Наименование произвольного поля 1611 + "value": "string", ~/~/ Значение произвольного поля 1612 + "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1613 + "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1614 + "forReport": true ~/~/ Отобразить произвольное поле в отчете 1615 + } 1616 + ], 1617 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1618 +} 1619 +))) 1620 +))) 1621 +))) 1622 + 1623 + 1425 1425 **Валидация:** 1426 1426 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1427 1427 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1428 1428 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1429 1429 1430 -== (% style="color:#000000; font-size:16px" %)**Получение па раметровобъектов**(%%) ==1629 +== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1431 1431 1432 1432 (% class="box infomessage" %) 1433 1433 ((( ... ... @@ -1468,9 +1468,12 @@ 1468 1468 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1469 1469 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1470 1470 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1471 - "parentId": null, ~/~/ ID клиента (Guid, опционально) 1472 - "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1473 - "customFields": null ~/~/ значение любого из произвольных полей ТС 1670 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1671 + "unitName": "string", ~/~/ Название подразделения (опционально) 1672 + "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1673 + "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1674 + "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1675 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1474 1474 } 1475 1475 1476 1476 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1477,8 +1477,15 @@ 1477 1477 1478 1478 (% style="color:#000000" %)Ответ: 1479 1479 1480 -(% style="color:#000000" %){ 1481 - "vehicleId": "" ~/~/ идентификатор объекта 1682 +(% style="color:#000000" %)[ 1683 +{ 1684 + 1685 +((( 1686 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1687 +))) 1688 + 1689 +((( 1690 +(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1482 1482 "name": "" ~/~/ наименование объекта 1483 1483 "imei": "" ~/~/ IMEI объекта 1484 1484 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1503,9 +1503,21 @@ 1503 1503 "forClient": true, ~/~/ право на отображение у клиента 1504 1504 "forTooltip": false, ~/~/ право на отображение в подсказке 1505 1505 "forReport": false ~/~/ право на отображение в отчетах 1506 - }(%%) 1507 -(% style="color:#000000" %)} 1715 +))) 1508 1508 1717 +((( 1718 + } 1719 + ], 1720 + "vehicleGroups": [ ~/~/ Группы ТС 1721 + { 1722 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1723 + "name": "string" ~/~/ Наименование группы ТС 1724 + } 1725 + ] 1726 + } 1727 +] 1728 +))) 1729 + 1509 1509 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1510 1510 1511 1511 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1690,65 +1690,201 @@ 1690 1690 ~/~/ "ValueOn": "Вкл.", 1691 1691 ~/~/ "ValueOff": "Выкл." 1692 1692 "summaryMaxValue": 0 ~/~/ Макс. значение 1914 + 1915 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1916 + { 1917 + "from": 0, ~/~/ С какого значения 1918 + "color": "string", ~/~/ Каким цветом 1919 + "text": "string" ~/~/ Текст подписи к этому интервалу 1920 + } 1921 + ] 1693 1693 } 1694 1694 ], 1924 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1925 + 1695 1695 "customFields": [ ~/~/ Произвольные поля 1696 - { 1697 - 1698 - "name": "string", 1699 - "value": "string", 1700 - "forClient": true, 1701 - "forTooltip": true, 1702 - "forReport": true 1927 + { 1928 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1929 + "name": "string", ~/~/ Наименование произвольного поля 1930 + "value": "string", ~/~/ Значение произвольного поля 1931 + "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1932 + "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1933 + "forReport": true ~/~/ Отобразить произвольное поле в отчете 1703 1703 } 1704 1704 ] 1705 1705 } 1706 1706 1938 + 1707 1707 (% style="color:#000000" %)Ответ: 1708 1708 1709 -(% lang="en-US" style="text-align:left" %) 1710 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1711 - "vehicleId": "", ~/~/ ID ТС 1712 - "parentId": "", ~/~/ ID клиента 1713 - "name": "", ~/~/ имя ТС 1714 - "imei": "", ~/~/ IMEI 1715 - "deviceTypeId": "", ~/~/ типа устройства 1716 - "modelId": "", ~/~/ ID модели 1717 - "unitId": "", ~/~/ ID подразделения 1718 - "sim1": "", ~/~/ SIM 1 1719 - "sim2": "", ~/~/ SIM2 1720 - "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1721 - "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1722 - "counters": 1723 - { 1724 - "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1725 - "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1726 - "mileage": "", ~/~/ пробег 1727 - "motohours": "", ~/~/ моточасы 1728 - } 1729 - "cmsv6Parameters": ~/~/ параметры CMSv6 1941 +((( 1942 +{ 1943 + "vehicleId": 0, ~/~/ ID ТС 1944 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1945 + "name": "string", ~/~/ Имя объекта 1946 + "imei": "string", ~/~/ IMEI 1947 + "deviceTypeId": 0, ~/~/ ID типа устройства 1948 + "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1949 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1950 + "sim1": "string", ~/~/ SIM1 1951 + "sim2": "string", ~/~/ SIM2 1952 + "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1953 + "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1954 + "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1955 + "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1956 + "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1957 + "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1958 + "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1959 + "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1960 + "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1961 + "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1962 + "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1963 + "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1964 + "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 1965 + "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1966 + "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1967 + "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1968 + "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1969 + "counters": { ~/~/ состояний счётчиков 1970 + "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1971 + "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1972 + "mileage": 0, ~/~/ Пробег 1973 + "motohours": 0 ~/~/ Моточасы 1974 + }, 1975 + "cmsv6Parameters": { ~/~/ Dto для CMSv6 1976 + "id": "string", ~/~/ CMSV6 Идентификатор 1977 + "enabled": true, ~/~/ Признак включения 1978 + "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1979 +))) 1980 + 1981 + 1982 +((( 1983 +~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1984 + "login": "string", ~/~/ CMSV6 имя учетной записи 1985 + "password": "string" ~/~/ CMSV6 — пароль учетной записи 1986 + }, 1987 + "inspectionTasks": [ ~/~/ Задания на ТО 1988 + { 1989 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1990 + "enabled": true, ~/~/ Признак включения 1991 + "name": "string", ~/~/ Имя задания 1992 + "description": "string", ~/~/ Описание задания 1993 + "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1994 + "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1995 + "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1996 + "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1997 + "periodicCondition": 0, ~/~/ Условие периодичности по времени 1998 + "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 1999 + "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 2000 + "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 2001 + } 2002 + ], 2003 + "drivers": [ ~/~/ Список водителей 2004 + { 2005 + "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 2006 + "inputNumber": 0, ~/~/ № входа. 2007 + "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 2008 + "comment": "string", ~/~/ Комментарий. 2009 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 2010 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 2011 + "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 2012 + "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 2013 + } 2014 + ], 2015 + "commandTemplates": [ ~/~/ Список шаблонов команд 2016 + { 2017 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 2018 + "name": "string", ~/~/ Название шаблона команд 2019 + "command": "string", ~/~/ Команда на выполнение 2020 + "retries": 0 ~/~/ Лимит попыток отправки 2021 + } 2022 + ], 2023 + "sensors": [ ~/~/ Список датчиков 2024 + { 2025 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 2026 + "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 2027 + "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 2028 +))) 2029 + 2030 +((( 2031 +~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 2032 +))) 2033 + 2034 +((( 2035 +~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 2036 +))) 2037 + 2038 +((( 2039 +~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 2040 +))) 2041 + 2042 +((( 2043 +~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 2044 +))) 2045 + 2046 +((( 2047 +~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 2048 + "name": "string", ~/~/ Имя датчика 2049 + "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 2050 +))) 2051 + 2052 +((( 2053 +~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 2054 + "inputNumber": 0, ~/~/ Номер входа 2055 + "pseudonym": "string", ~/~/ Псевдоним 2056 + "medianDegree": 0, ~/~/ Степень медианной фильтрации 2057 + "isInverted": true, ~/~/ Признак инверсии 2058 + "disabled": true, ~/~/ Датчик не участвует в обработке 2059 + "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 2060 + "gradesTables": [ ~/~/ Тарировка 1730 1730 { 1731 - "id": ~/~/ идентификатор 1732 - "enabled": true, ~/~/ флаг включения 1733 - "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1734 - "login": "", ~/~/ имя учетной записи 1735 - "password": "", ~/~/ пароль учетной записи 1736 - } 1737 - "inspectionTasks": ~/~/ задания на ТО 2062 + "grades": [ ~/~/ Таблицы тарировки 2063 + { 2064 + "input": 0, ~/~/ Вход 2065 + "output": 0 ~/~/ Выход 2066 + } 2067 + ], 2068 + "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2069 + } 2070 + ], 2071 + "showInTooltip": true, ~/~/ Отображение в подсказке 2072 + "showLastValid": true, ~/~/ Отображать последнее валидное значение 2073 + "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2074 + "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2075 + "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2076 + "expr": "string", ~/~/ Выражение 2077 + "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2078 + "string" 2079 + ], 2080 + "customParams": { ~/~/ Дополнительные настройки 2081 + "additionalProp1": "string", 2082 + "additionalProp2": "string", 2083 + "additionalProp3": "string" 2084 + }, 2085 + "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2086 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1738 1738 { 1739 - "id": "", ~/~/ ID задания 1740 - "enabled": false, ~/~/ Признак включения 1741 - "name": "", ~/~/ Имя задания 1742 - "description": "", ~/~/ Описание задания 1743 - "mileageCondition": "", ~/~/ Условие по пробегу 1744 - "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1745 - "motohoursCondition": "", ~/~/ Условие по моточасам 1746 - "lastMotohours": "", ~/~/ Моточасы 1747 - "periodicCondition": "", ~/~/ Условие периодичности по времени 1748 - "kind": "", ~/~/ Вид периодичности по времени 1749 - "maxQuantity": "", ~/~/ Сколько раз выполнить задание 2088 + "from": 0, ~/~/ С какого значения 2089 + "color": "string", ~/~/ Каким цветом 2090 + "text": "string" ~/~/ Текст подписи к этому интервалу 1750 1750 } 1751 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 2092 + ] 2093 + } 2094 + ], 2095 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2096 + "customFields": [ ~/~/ Список произвольных полей 2097 + { 2098 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2099 + "name": "string", ~/~/ Наименование произвольного поля 2100 + "value": "string", ~/~/ Значение произвольного поля 2101 + "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2102 + "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2103 + "forReport": true ~/~/ Отобразить произвольное поле в отчете 2104 + } 2105 + ], 2106 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2107 +} 2108 +))) 1752 1752 1753 1753 **Валидация:** 1754 1754 - сезонный параметр может быть задан только если задана соответствующая обычная норма; ... ... @@ -2023,10 +2023,12 @@ 2023 2023 { 2024 2024 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2025 2025 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2026 - "mileageBegin": 0, ~/~/ Пробег на начало периода 2027 - "mileageEnd": 0, ~/~/ Пробег на окончание периода 2028 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2029 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2383 + "mileage": 0, ~/~/ Пробег за период, километры 2384 + "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2385 + "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2386 + "motohours": 0, ~/~/ Моточасы за период, секунды 2387 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2388 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2030 2030 } 2031 2031 ] 2032 2032 } ... ... @@ -2075,6 +2075,12 @@ 2075 2075 } 2076 2076 ] 2077 2077 2437 +(% class="box warningmessage" %) 2438 +((( 2439 +Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2440 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2441 +))) 2442 + 2078 2078 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2079 2079 2080 2080 (% class="box infomessage" %) ... ... @@ -2162,7 +2162,7 @@ 2162 2162 ], 2163 2163 "stops": [ ~/~/ События стоянок 2164 2164 { 2165 - "address": "strin g", ~/~/ Адрес события2530 + "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты 2166 2166 "eventId": 0, ~/~/ Идентификатор события 2167 2167 "eventName": "string", ~/~/ Название события 2168 2168 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -2517,6 +2517,32 @@ 2517 2517 2518 2518 Success 2519 2519 2885 + 2886 +== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2887 + 2888 +(% class="box warningmessage" %) 2889 +((( 2890 +**PUT** /api/v3/notifications/prolongation 2891 +))) 2892 + 2893 +Метод позволяет продлить уведомления. 2894 + 2895 +Метод запроса **PUT** 2896 + 2897 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2898 + 2899 +В заголовках запроса: X-Auth: Токен авторизации. 2900 + 2901 +Тело запроса: 2902 + 2903 +[ 2904 + 2905 +0 2906 + 2907 +] 2908 + 2909 +где 0 идентификатор ids. 2910 + 2520 2520 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2521 2521 2522 2522 (% class="box errormessage" %) ... ... @@ -3707,7 +3707,7 @@ 3707 3707 **POST /api/v3/vehicles/import/{agentId}** 3708 3708 ))) 3709 3709 3710 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 4101 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).** 3711 3711 3712 3712 В пути указывается **agentId** - id клиента. 3713 3713 ... ... @@ -3719,7 +3719,7 @@ 3719 3719 3720 3720 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3721 3721 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3722 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1- Замена,2- Слияние,3- Добавление4113 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление 3723 3723 3724 3724 В теле использовать тип **form-data,** тип значения** file** 3725 3725 ... ... @@ -3898,64 +3898,67 @@ 3898 3898 Тело запроса: 3899 3899 3900 3900 { 3901 - "vehicleIds": [vehicleId], 3902 - "from": "2023-11-22T09:29:48.051Z", 3903 - "to": "2023-11-22T09:29:48.051Z" 4292 + "vehicleIds": [vehicleId], ~/~/Массив ID объектов 4293 + "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса 4294 + "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса 3904 3904 } 3905 3905 3906 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3907 -|vehicleIds|Массив ID объектов 3908 -|from|Дата начала запроса 3909 -|to|Дата окончания запроса 3910 - 3911 3911 Ответ: 3912 3912 3913 3913 { 3914 - "items": [ 4300 + "items": [ ~/~/ Список в разрезе ТС 3915 3915 { 3916 - "from": "2023-11-22T09:29:48.052Z", 3917 - "to": "2023-11-22T09:29:48.052Z", 3918 - "vehicleId": 0, 3919 - "vehicleName": "string", 3920 - "vehicleModel": "string", 3921 - "penalty": 0, 3922 - "score": 0, 3923 - "totalViolations": 0, 3924 - "violationsByType": { 3925 - "overspeedingViolations": 0, 3926 - "accelerationViolations": 0, 3927 - "brakingViolations": 0, 3928 - "turningViolations": 0, 3929 - "dangerousDrivingViolations": 0, 3930 - "sensorViolations": 0 4302 + "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода 4303 + "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода 4304 + "vehicleId": 0, ~/~/ ID ТС 4305 + "vehicleName": "string", ~/~/ Название ТС 4306 + "vehicleModel": "string", ~/~/ Модель ТС 4307 + "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС 4308 + "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС 4309 + "totalViolations": 0, ~/~/ Нарушений всего 4310 + "violationsByType": { ~/~/ Информация о нарушениях по типу 4311 + "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости 4312 + "accelerationViolations": 0, ~/~/ Нарушений ускорения 4313 + "brakingViolations": 0, ~/~/ Нарушений торможения 4314 + "turningViolations": 0, ~/~/ Нарушений опасного поворота 4315 + "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения 4316 + "sensorViolations": 0 ~/~/ Нарушений по датчику 3931 3931 }, 3932 - "moveTime": 0, 3933 - "mileage": 0, 3934 - "tripsCount": 0, 3935 - "trips": [ 4318 + 4319 +((( 4320 + 4321 +))) 4322 + 4323 + "moveTime": 0, ~/~/ Продолжительность движения, сек 4324 + "mileage": 0, ~/~/ Пробег, м 4325 + "tripsCount": 0, ~/~/ Кол-во рейсов 4326 + "trips": [ ~/~/ Информация по рейсу 3936 3936 { 3937 - "penalty": 0, 3938 - "score": 0, 3939 - "violationsCount": 0, 3940 - "violationsByType": { 3941 - "overspeedingViolations": 0, 3942 - "accelerationViolations": 0, 3943 - "brakingViolations": 0, 3944 - "turningViolations": 0, 3945 - "dangerousDrivingViolations": 0, 3946 - "sensorViolations": 0 4328 + "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс 4329 + "score": 0, ~/~/ Рассчитанная оценка вождения за рейс 4330 + "violationsCount": 0, ~/~/ Всего нарушений 4331 + "violationsByType": { ~/~/ Информация о нарушениях по типу 4332 + "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости 4333 + "accelerationViolations": 0, ~/~/ Нарушений ускорения 4334 + "brakingViolations": 0, ~/~/ Нарушений торможения 4335 + "turningViolations": 0, ~/~/ Нарушений опасного поворота 4336 + "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения 4337 + "sensorViolations": 0 ~/~/ Нарушений по датчику 3947 3947 }, 3948 - "moveTime": 0, 3949 - "mileage": 0, 3950 - "motohours": 0, 3951 - "maxSpeed": 0, 3952 - "startAddress": "string", 3953 - "endAddress": "string", 3954 - "drivers": [ 4339 + 4340 + "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4341 + "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4342 + "moveTime": 0, ~/~/ Продолжительность движения, сек 4343 + "mileage": 0, ~/~/ Пробег, м 4344 + "motohours": 0, ~/~/ Моточасы, секунды 4345 + "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4346 + "startAddress": "string", ~/~/ Адрес начала рейса 4347 + "endAddress": "string", ~/~/ Адрес конца рейса 4348 + "drivers": [ ~/~/ Список водителей 3955 3955 { 3956 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3957 - "driverName": "string", 3958 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4350 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя 4351 + "driverName": "string", ~/~/ФИО водителя 4352 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки 3959 3959 } 3960 3960 ] 3961 3961 } ... ... @@ -3964,34 +3964,6 @@ 3964 3964 ] 3965 3965 } 3966 3966 3967 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3968 -|from|Дата начала запроса 3969 -|to|Дата окончания 3970 -|vehicleId|ID объекта 3971 -|vehicleName|Имя объекта 3972 -|vehicleModel|Модель объекта 3973 -|penalty|Сумма штрафных баллов 3974 -|score|Оценка 3975 -|totalViolations|Суммарное количество нарушений 3976 -|violationsByType|Список типов нарушений и количество нарушений для каждого типа 3977 -|overspeedingViolations|Превышение скорости 3978 -|accelerationViolations|Ускорение 3979 -|brakingViolations|Торможение 3980 -|turningViolations|Резкий поворот 3981 -|dangerousDrivingViolations|Резкое вождение 3982 -|sensorViolations|Нарушение по датчику 3983 -|moveTime|Время в движении 3984 -|mileage|Пробег 3985 -|tripsCount|Количество рейсов 3986 -|motohours|Моточасы 3987 -|maxSpeed|Максимальная скорость 3988 -|startAddress|Адрес начала рейса 3989 -|endAddress|Адрес окончания рейса 3990 -|drivers|Список водителей, которые были на объекте в течениии рейса 3991 -|driverGuid|Guid водителя 3992 -|driverName|Имя водителя 3993 -|driverRfid|Номер Карты-метки 3994 - 3995 3995 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 3996 3996 3997 3997 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==