Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/07/25 10:10
on 2024/07/25 10:10
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,94 @@ 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 + 1244 +== **Отправить команду на терминал** == 1245 + 1246 +(% class="box successmessage" %) 1247 +((( 1248 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1249 +))) 1250 + 1251 +Команда для отправки на тс. 1252 + 1253 +{ 1254 +"id": "", ~/~/идентификатор произвольного поля 1255 +"command": "", ~/~/ Текст команды 1256 +"retries": "", ~/~/ Количество попыток 1257 +"idTemplate": "" ~/~/ ID шаблона команды 1258 +} 1259 + 1260 + 1166 1166 == **Получить ответ на отправленную на ТС команду** == 1167 1167 1168 1168 (% class="box infomessage" %) ... ... @@ -1346,17 +1346,31 @@ 1346 1346 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1347 1347 ~/~/ "ValueOn": "Вкл.", 1348 1348 ~/~/ "ValueOff": "Выкл." 1349 - "summaryMaxValue": 0 ~/~/ Макс. значение 1444 + "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1445 + 1446 +((( 1447 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1448 + { 1449 + "from": 0, ~/~/ С какого значения 1450 + "color": "string", ~/~/ Каким цветом 1451 + "text": "string" ~/~/ Текст подписи к этому интервалу 1452 + } 1453 + ] 1350 1350 } 1351 1351 ], 1456 +))) 1457 + 1458 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1459 + 1460 + 1352 1352 "customFields": [ ~/~/ Произвольные поля 1353 1353 { 1354 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1355 - "name": "string", 1356 - "value": "string", 1357 - "forClient": true, 1358 - "forTooltip": true, 1359 - "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 ~/~/ Отобразить произвольное поле в отчете 1360 1360 } 1361 1361 ] 1362 1362 } ... ... @@ -1363,52 +1363,161 @@ 1363 1363 1364 1364 (% style="color:#000000" %)Ответ: 1365 1365 1366 -(% style="color:#000000" %){(%%) 1367 - "vehicleId": "", ~/~/ID ТС 1368 - "parentId": "", ~/~/Guid владельца ТС 1369 - "name": "", ~/~/Имя объекта 1370 - "imei": "", ~/~/IMEI 1371 - "deviceTypeId": "", ~/~/ID типа устройства 1372 - "modelId": "", ~/~/ID модели 1373 - "unitId": "", ~/~/ID подразделения 1374 - "sim1": "", ~/~/SIM1 1375 - "sim2": "", ~/~/SIM2 1376 - "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1377 - "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1378 - "counters": { ~/~/Счётчики 1379 - "mileageEnabled": true, 1380 - "motohoursEnabled": true, 1381 - "mileage": "", 1382 - "motohours": 345.0 1383 - }, 1384 - "cmsv6Parameters": { ~/~/Параметры CmsV6 1385 - "id": null, 1386 - "enabled": true, ~/~/флаг включения 1387 - "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1388 - "login": "", ~/~/ имя учетной записи 1389 - "password": "" ~/~/ пароль учетной записи 1390 - }, 1391 - "inspectionTasks": { ~/~/ задания на ТО 1392 - "id": "", ~/~/ ID задачи 1393 - "enabled": false, ~/~/ Признак включения 1394 - "name": "", ~/~/ Имя задания 1395 - "description": "", ~/~/ Описание задания 1396 - "mileageCondition": "", ~/~/ Условие по пробегу 1397 - "lastMileage": "", ~/~/ Пробег (в метрах) 1398 - "motohoursCondition": "", ~/~/ Условие по моточасам 1399 - "lastMotohours": "", ~/~/ Моточасы 1400 - "periodicCondition": "", ~/~/ Условие периодичности по времени 1401 - "kind": "", ~/~/ Вид периодичности по времени 1402 - "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 ~/~/ Условие по количеству записей для деактивации 1403 1403 } 1404 -(% 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 +))) 1405 1405 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 + 1406 1406 **Валидация:** 1407 1407 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1408 1408 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1409 1409 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1410 1410 1411 -== (% style="color:#000000; font-size:16px" %)**Получение па раметровобъектов**(%%) ==1629 +== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1412 1412 1413 1413 (% class="box infomessage" %) 1414 1414 ((( ... ... @@ -1449,9 +1449,12 @@ 1449 1449 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1450 1450 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1451 1451 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1452 - "parentId": null, ~/~/ ID клиента (Guid, опционально) 1453 - "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1454 - "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" ~/~/ Идентификатор агента, для которого надо получить данные 1455 1455 } 1456 1456 1457 1457 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1458,8 +1458,15 @@ 1458 1458 1459 1459 (% style="color:#000000" %)Ответ: 1460 1460 1461 -(% style="color:#000000" %){ 1462 - "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": "" ~/~/ идентификатор объекта 1463 1463 "name": "" ~/~/ наименование объекта 1464 1464 "imei": "" ~/~/ IMEI объекта 1465 1465 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1484,9 +1484,21 @@ 1484 1484 "forClient": true, ~/~/ право на отображение у клиента 1485 1485 "forTooltip": false, ~/~/ право на отображение в подсказке 1486 1486 "forReport": false ~/~/ право на отображение в отчетах 1487 - }(%%) 1488 -(% style="color:#000000" %)} 1715 +))) 1489 1489 1717 +((( 1718 + } 1719 + ], 1720 + "vehicleGroups": [ ~/~/ Группы ТС 1721 + { 1722 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1723 + "name": "string" ~/~/ Наименование группы ТС 1724 + } 1725 + ] 1726 + } 1727 +] 1728 +))) 1729 + 1490 1490 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1491 1491 1492 1492 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1531,23 +1531,8 @@ 1531 1531 "stage": "", ~/~/ Состояние 1532 1532 (% style="color:#000000" %) } 1533 1533 1534 -== **Отправитькомандуна терминал**==1774 +== == 1535 1535 1536 -(% class="box successmessage" %) 1537 -((( 1538 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1539 -))) 1540 - 1541 -Команда для отправки на тс. 1542 - 1543 -{ 1544 -"id": "", ~/~/идентификатор произвольного поля 1545 -"command": "", ~/~/ Текст команды 1546 -"retries": "", ~/~/ Количество попыток 1547 -"idTemplate": "" ~/~/ ID шаблона команды 1548 -} 1549 - 1550 - 1551 1551 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1552 1552 1553 1553 (% class="box warningmessage" %) ... ... @@ -1686,65 +1686,201 @@ 1686 1686 ~/~/ "ValueOn": "Вкл.", 1687 1687 ~/~/ "ValueOff": "Выкл." 1688 1688 "summaryMaxValue": 0 ~/~/ Макс. значение 1914 + 1915 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1916 + { 1917 + "from": 0, ~/~/ С какого значения 1918 + "color": "string", ~/~/ Каким цветом 1919 + "text": "string" ~/~/ Текст подписи к этому интервалу 1920 + } 1921 + ] 1689 1689 } 1690 1690 ], 1924 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1925 + 1691 1691 "customFields": [ ~/~/ Произвольные поля 1692 - { 1693 - 1694 - "name": "string", 1695 - "value": "string", 1696 - "forClient": true, 1697 - "forTooltip": true, 1698 - "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 ~/~/ Отобразить произвольное поле в отчете 1699 1699 } 1700 1700 ] 1701 1701 } 1702 1702 1938 + 1703 1703 (% style="color:#000000" %)Ответ: 1704 1704 1705 -(% lang="en-US" style="text-align:left" %) 1706 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1707 - "vehicleId": "", ~/~/ ID ТС 1708 - "parentId": "", ~/~/ ID клиента 1709 - "name": "", ~/~/ имя ТС 1710 - "imei": "", ~/~/ IMEI 1711 - "deviceTypeId": "", ~/~/ типа устройства 1712 - "modelId": "", ~/~/ ID модели 1713 - "unitId": "", ~/~/ ID подразделения 1714 - "sim1": "", ~/~/ SIM 1 1715 - "sim2": "", ~/~/ SIM2 1716 - "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1717 - "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1718 - "counters": 1719 - { 1720 - "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1721 - "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1722 - "mileage": "", ~/~/ пробег 1723 - "motohours": "", ~/~/ моточасы 1724 - } 1725 - "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": [ ~/~/ Тарировка 1726 1726 { 1727 - "id": ~/~/ идентификатор 1728 - "enabled": true, ~/~/ флаг включения 1729 - "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1730 - "login": "", ~/~/ имя учетной записи 1731 - "password": "", ~/~/ пароль учетной записи 1732 - } 1733 - "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": [ ~/~/ Интервалы значений для подсветки в мониторинге 1734 1734 { 1735 - "id": "", ~/~/ ID задания 1736 - "enabled": false, ~/~/ Признак включения 1737 - "name": "", ~/~/ Имя задания 1738 - "description": "", ~/~/ Описание задания 1739 - "mileageCondition": "", ~/~/ Условие по пробегу 1740 - "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1741 - "motohoursCondition": "", ~/~/ Условие по моточасам 1742 - "lastMotohours": "", ~/~/ Моточасы 1743 - "periodicCondition": "", ~/~/ Условие периодичности по времени 1744 - "kind": "", ~/~/ Вид периодичности по времени 1745 - "maxQuantity": "", ~/~/ Сколько раз выполнить задание 2088 + "from": 0, ~/~/ С какого значения 2089 + "color": "string", ~/~/ Каким цветом 2090 + "text": "string" ~/~/ Текст подписи к этому интервалу 1746 1746 } 1747 -(% 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 +))) 1748 1748 1749 1749 **Валидация:** 1750 1750 - сезонный параметр может быть задан только если задана соответствующая обычная норма; ... ... @@ -2019,10 +2019,12 @@ 2019 2019 { 2020 2020 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2021 2021 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2022 - "mileageBegin": 0, ~/~/ Пробег на начало периода 2023 - "mileageEnd": 0, ~/~/ Пробег на окончание периода 2024 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2025 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2383 + "mileage": 0, ~/~/ Пробег за период, километры 2384 + "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2385 + "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2386 + "motohours": 0, ~/~/ Моточасы за период, секунды 2387 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2388 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2026 2026 } 2027 2027 ] 2028 2028 } ... ... @@ -2071,6 +2071,12 @@ 2071 2071 } 2072 2072 ] 2073 2073 2437 +(% class="box warningmessage" %) 2438 +((( 2439 +Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2440 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2441 +))) 2442 + 2074 2074 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2075 2075 2076 2076 (% class="box infomessage" %) ... ... @@ -2158,7 +2158,7 @@ 2158 2158 ], 2159 2159 "stops": [ ~/~/ События стоянок 2160 2160 { 2161 - "address": "strin g", ~/~/ Адрес события2530 + "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты 2162 2162 "eventId": 0, ~/~/ Идентификатор события 2163 2163 "eventName": "string", ~/~/ Название события 2164 2164 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -2513,6 +2513,32 @@ 2513 2513 2514 2514 Success 2515 2515 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 + 2516 2516 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2517 2517 2518 2518 (% class="box errormessage" %) ... ... @@ -3703,7 +3703,7 @@ 3703 3703 **POST /api/v3/vehicles/import/{agentId}** 3704 3704 ))) 3705 3705 3706 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 4101 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).** 3707 3707 3708 3708 В пути указывается **agentId** - id клиента. 3709 3709 ... ... @@ -3715,7 +3715,7 @@ 3715 3715 3716 3716 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3717 3717 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3718 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1- Замена,2- Слияние,3- Добавление4113 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление 3719 3719 3720 3720 В теле использовать тип **form-data,** тип значения** file** 3721 3721 ... ... @@ -3894,64 +3894,67 @@ 3894 3894 Тело запроса: 3895 3895 3896 3896 { 3897 - "vehicleIds": [vehicleId], 3898 - "from": "2023-11-22T09:29:48.051Z", 3899 - "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" ~/~/ Дата окончания запроса 3900 3900 } 3901 3901 3902 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3903 -|vehicleIds|Массив ID объектов 3904 -|from|Дата начала запроса 3905 -|to|Дата окончания запроса 3906 - 3907 3907 Ответ: 3908 3908 3909 3909 { 3910 - "items": [ 4300 + "items": [ ~/~/ Список в разрезе ТС 3911 3911 { 3912 - "from": "2023-11-22T09:29:48.052Z", 3913 - "to": "2023-11-22T09:29:48.052Z", 3914 - "vehicleId": 0, 3915 - "vehicleName": "string", 3916 - "vehicleModel": "string", 3917 - "penalty": 0, 3918 - "score": 0, 3919 - "totalViolations": 0, 3920 - "violationsByType": { 3921 - "overspeedingViolations": 0, 3922 - "accelerationViolations": 0, 3923 - "brakingViolations": 0, 3924 - "turningViolations": 0, 3925 - "dangerousDrivingViolations": 0, 3926 - "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 ~/~/ Нарушений по датчику 3927 3927 }, 3928 - "moveTime": 0, 3929 - "mileage": 0, 3930 - "tripsCount": 0, 3931 - "trips": [ 4318 + 4319 +((( 4320 + 4321 +))) 4322 + 4323 + "moveTime": 0, ~/~/ Продолжительность движения, сек 4324 + "mileage": 0, ~/~/ Пробег, м 4325 + "tripsCount": 0, ~/~/ Кол-во рейсов 4326 + "trips": [ ~/~/ Информация по рейсу 3932 3932 { 3933 - "penalty": 0, 3934 - "score": 0, 3935 - "violationsCount": 0, 3936 - "violationsByType": { 3937 - "overspeedingViolations": 0, 3938 - "accelerationViolations": 0, 3939 - "brakingViolations": 0, 3940 - "turningViolations": 0, 3941 - "dangerousDrivingViolations": 0, 3942 - "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 ~/~/ Нарушений по датчику 3943 3943 }, 3944 - "moveTime": 0, 3945 - "mileage": 0, 3946 - "motohours": 0, 3947 - "maxSpeed": 0, 3948 - "startAddress": "string", 3949 - "endAddress": "string", 3950 - "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": [ ~/~/ Список водителей 3951 3951 { 3952 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3953 - "driverName": "string", 3954 - "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 радиометки 3955 3955 } 3956 3956 ] 3957 3957 } ... ... @@ -3960,34 +3960,6 @@ 3960 3960 ] 3961 3961 } 3962 3962 3963 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3964 -|from|Дата начала запроса 3965 -|to|Дата окончания 3966 -|vehicleId|ID объекта 3967 -|vehicleName|Имя объекта 3968 -|vehicleModel|Модель объекта 3969 -|penalty|Сумма штрафных баллов 3970 -|score|Оценка 3971 -|totalViolations|Суммарное количество нарушений 3972 -|violationsByType|Список типов нарушений и количество нарушений для каждого типа 3973 -|overspeedingViolations|Превышение скорости 3974 -|accelerationViolations|Ускорение 3975 -|brakingViolations|Торможение 3976 -|turningViolations|Резкий поворот 3977 -|dangerousDrivingViolations|Резкое вождение 3978 -|sensorViolations|Нарушение по датчику 3979 -|moveTime|Время в движении 3980 -|mileage|Пробег 3981 -|tripsCount|Количество рейсов 3982 -|motohours|Моточасы 3983 -|maxSpeed|Максимальная скорость 3984 -|startAddress|Адрес начала рейса 3985 -|endAddress|Адрес окончания рейса 3986 -|drivers|Список водителей, которые были на объекте в течениии рейса 3987 -|driverGuid|Guid водителя 3988 -|driverName|Имя водителя 3989 -|driverRfid|Номер Карты-метки 3990 - 3991 3991 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 3992 3992 3993 3993 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==