Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/14 11:58
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Gadmin1 +XWiki.SupportZhuchkov - Content
-
... ... @@ -14,7 +14,7 @@ 14 14 15 15 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 16 16 17 -(% style="color:#000000" %)− (%%)При **редактировании** любойзаписи (пользователь, объект и т.д)необходимо передавать все параметры записив теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 18 18 19 19 20 20 (% style="color:#000000; font-size:16px" %)**Рекомендации** ... ... @@ -23,11 +23,7 @@ 23 23 24 24 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 25 25 26 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 27 -((( 28 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 29 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 30 -))) 26 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 31 31 32 32 (% class="box successmessage" %) 33 33 ((( ... ... @@ -1372,31 +1372,17 @@ 1372 1372 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1373 1373 ~/~/ "ValueOn": "Вкл.", 1374 1374 ~/~/ "ValueOff": "Выкл." 1375 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1376 - 1377 -((( 1378 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1379 - { 1380 - "from": 0, ~/~/ С какого значения 1381 - "color": "string", ~/~/ Каким цветом 1382 - "text": "string" ~/~/ Текст подписи к этому интервалу 1383 - } 1384 - ] 1371 + "summaryMaxValue": 0 ~/~/ Макс. значение 1385 1385 } 1386 1386 ], 1387 -))) 1388 - 1389 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1390 - 1391 - 1392 1392 "customFields": [ ~/~/ Произвольные поля 1393 1393 { 1394 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1395 - "name": "string", ~/~/ Наименование произвольного поля1396 - "value": "string", ~/~/ Значение произвольного поля1397 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1398 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1399 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1376 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1377 + "name": "string", 1378 + "value": "string", 1379 + "forClient": true, 1380 + "forTooltip": true, 1381 + "forReport": true 1400 1400 } 1401 1401 ] 1402 1402 } ... ... @@ -1403,155 +1403,46 @@ 1403 1403 1404 1404 (% style="color:#000000" %)Ответ: 1405 1405 1406 - 1407 -((( 1408 -((( 1409 -((( 1410 -{ 1411 - "vehicleId": 0, ~/~/ ID ТС 1412 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1413 - "name": "string", ~/~/ Имя объекта 1414 - "imei": "string", ~/~/ IMEI 1415 - "deviceTypeId": 0, ~/~/ ID типа устройства 1416 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1417 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1418 - "sim1": "string", ~/~/ SIM1 1419 - "sim2": "string", ~/~/ SIM2 1420 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1421 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1422 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1423 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1424 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1425 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1426 - "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1427 - "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1428 - "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1429 - "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1430 - "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1431 - "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1432 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1433 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1434 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1435 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1436 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1437 - "counters": { ~/~/ Dto для состояний счётчиков 1438 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1439 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1440 - "mileage": 0, ~/~/ Пробег 1441 - "motohours": 0 ~/~/ Моточасы 1442 - }, 1443 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1444 - "id": "string", ~/~/ CMSV6 Идентификатор 1445 - "enabled": true, ~/~/ Признак включения 1446 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1447 - "login": "string", ~/~/ CMSV6 имя учетной записи 1448 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1449 - }, 1450 - "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1451 - { 1452 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1453 - "enabled": true, ~/~/ Признак включения 1454 - "name": "string", ~/~/ Имя задания 1455 - "description": "string", ~/~/ Описание задания 1456 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1457 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1458 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1459 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1460 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1461 - "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1462 - "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1463 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 1388 +(% style="color:#000000" %){(%%) 1389 + "vehicleId": "", ~/~/ID ТС 1390 + "parentId": "", ~/~/Guid владельца ТС 1391 + "name": "", ~/~/Имя объекта 1392 + "imei": "", ~/~/IMEI 1393 + "deviceTypeId": "", ~/~/ID типа устройства 1394 + "modelId": "", ~/~/ID модели 1395 + "unitId": "", ~/~/ID подразделения 1396 + "sim1": "", ~/~/SIM1 1397 + "sim2": "", ~/~/SIM2 1398 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1399 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1400 + "counters": { ~/~/Счётчики 1401 + "mileageEnabled": true, 1402 + "motohoursEnabled": true, 1403 + "mileage": "", 1404 + "motohours": 345.0 1405 + }, 1406 + "cmsv6Parameters": { ~/~/Параметры CmsV6 1407 + "id": null, 1408 + "enabled": true, ~/~/флаг включения 1409 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1410 + "login": "", ~/~/ имя учетной записи 1411 + "password": "" ~/~/ пароль учетной записи 1412 + }, 1413 + "inspectionTasks": { ~/~/ задания на ТО 1414 + "id": "", ~/~/ ID задачи 1415 + "enabled": false, ~/~/ Признак включения 1416 + "name": "", ~/~/ Имя задания 1417 + "description": "", ~/~/ Описание задания 1418 + "mileageCondition": "", ~/~/ Условие по пробегу 1419 + "lastMileage": "", ~/~/ Пробег (в метрах) 1420 + "motohoursCondition": "", ~/~/ Условие по моточасам 1421 + "lastMotohours": "", ~/~/ Моточасы 1422 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1423 + "kind": "", ~/~/ Вид периодичности по времени 1424 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1464 1464 } 1465 - ], 1466 - "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1467 - { 1468 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1469 - "inputNumber": 0, ~/~/ № входа. 1470 - "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1471 - "comment": "string", ~/~/ Комментарий 1472 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1473 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1474 - "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1475 - "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1476 - } 1477 - ], 1478 - "commandTemplates": [ ~/~/ Список шаблонов команд 1479 - { 1480 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1481 - "name": "string", ~/~/ Название шаблона команд 1482 - "command": "string", ~/~/ Команда на выполнение 1483 - "retries": 0 ~/~/ Лимит попыток отправки 1484 - } 1485 - ], 1486 - "sensors": [ ~/~/ Список датчиков 1487 - { 1488 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1489 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1490 - "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 1491 - "name": "string", ~/~/ Имя датчика 1492 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1493 - "inputNumber": 0, ~/~/ Номер входа 1494 - "pseudonym": "string", ~/~/ Псевдоним 1495 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1496 - "isInverted": true, ~/~/ Признак инверсии 1497 - "disabled": true, ~/~/ Датчик не участвует в обработке 1498 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1499 - "gradesTables": [ ~/~/ Тарировка 1500 - { 1501 - "grades": [ ~/~/ Таблицы тарировки 1502 - { 1503 - "input": 0, ~/~/ Вход 1504 - "output": 0 ~/~/ Выход 1505 - } 1506 - ], 1507 - "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1508 - } 1509 - ], 1510 - "showInTooltip": true, ~/~/ Отображение в подсказке 1511 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 1512 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1513 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1514 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1515 - "expr": "string", ~/~/ Выражение 1516 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1517 - "string" 1518 - ], 1519 - "customParams": { 1520 - "additionalProp1": "string", 1521 - "additionalProp2": "string", 1522 - "additionalProp3": "string" 1523 - }, 1524 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1525 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1526 - { 1527 - "from": 0, ~/~/ С какого значения 1528 - "color": "string", ~/~/ Каким цветом 1529 -))) 1426 +(% style="color:#000000" %)} 1530 1530 1531 -((( 1532 - "text": "string" ~/~/ Текст подписи к этому интервалу 1533 - } 1534 - ] 1535 - } 1536 - ], 1537 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1538 - "customFields": [ ~/~/ Список произвольных полей 1539 - { 1540 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1541 - "name": "string", ~/~/ Наименование произвольного поля 1542 - "value": "string", ~/~/ Значение произвольного поля 1543 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1544 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1545 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1546 - } 1547 - ], 1548 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1549 -} 1550 -))) 1551 -))) 1552 -))) 1553 - 1554 - 1555 1555 **Валидация:** 1556 1556 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1557 1557 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; ... ... @@ -1598,12 +1598,9 @@ 1598 1598 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1599 1599 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1600 1600 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1601 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1602 - "unitName": "string", ~/~/ Название подразделения (опционально) 1603 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1604 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1605 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1606 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1474 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1475 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1476 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1607 1607 } 1608 1608 1609 1609 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1610,15 +1610,8 @@ 1610 1610 1611 1611 (% style="color:#000000" %)Ответ: 1612 1612 1613 -(% style="color:#000000" %)[ 1614 -{ 1615 - 1616 -((( 1617 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1618 -))) 1619 - 1620 -((( 1621 -(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1483 +(% style="color:#000000" %){ 1484 + "vehicleId": "" ~/~/ идентификатор объекта 1622 1622 "name": "" ~/~/ наименование объекта 1623 1623 "imei": "" ~/~/ IMEI объекта 1624 1624 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1643,21 +1643,9 @@ 1643 1643 "forClient": true, ~/~/ право на отображение у клиента 1644 1644 "forTooltip": false, ~/~/ право на отображение в подсказке 1645 1645 "forReport": false ~/~/ право на отображение в отчетах 1646 -))) 1509 + }(%%) 1510 +(% style="color:#000000" %)} 1647 1647 1648 -((( 1649 - } 1650 - ], 1651 - "vehicleGroups": [ ~/~/ Группы ТС 1652 - { 1653 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1654 - "name": "string" ~/~/ Наименование группы ТС 1655 - } 1656 - ] 1657 - } 1658 -] 1659 -))) 1660 - 1661 1661 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1662 1662 1663 1663 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1842,201 +1842,65 @@ 1842 1842 ~/~/ "ValueOn": "Вкл.", 1843 1843 ~/~/ "ValueOff": "Выкл." 1844 1844 "summaryMaxValue": 0 ~/~/ Макс. значение 1845 - 1846 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1847 - { 1848 - "from": 0, ~/~/ С какого значения 1849 - "color": "string", ~/~/ Каким цветом 1850 - "text": "string" ~/~/ Текст подписи к этому интервалу 1851 - } 1852 - ] 1853 1853 } 1854 1854 ], 1855 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1856 - 1857 1857 "customFields": [ ~/~/ Произвольные поля 1858 - { 1859 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1860 - "name": "string", ~/~/ Наименование произвольного поля1861 - "value": "string", ~/~/ Значение произвольного поля1862 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1863 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1864 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1699 + { 1700 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1701 + "name": "string", 1702 + "value": "string", 1703 + "forClient": true, 1704 + "forTooltip": true, 1705 + "forReport": true 1865 1865 } 1866 1866 ] 1867 1867 } 1868 1868 1869 - 1870 1870 (% style="color:#000000" %)Ответ: 1871 1871 1872 -((( 1873 -{ 1874 - "vehicleId": 0, ~/~/ ID ТС 1875 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1876 - "name": "string", ~/~/ Имя объекта 1877 - "imei": "string", ~/~/ IMEI 1878 - "deviceTypeId": 0, ~/~/ ID типа устройства 1879 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1880 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1881 - "sim1": "string", ~/~/ SIM1 1882 - "sim2": "string", ~/~/ SIM2 1883 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1884 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1885 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1886 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1887 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1888 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1889 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1890 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1891 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1892 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1893 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1894 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1895 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 1896 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1897 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1898 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1899 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1900 - "counters": { ~/~/ состояний счётчиков 1901 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1902 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1903 - "mileage": 0, ~/~/ Пробег 1904 - "motohours": 0 ~/~/ Моточасы 1905 - }, 1906 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1907 - "id": "string", ~/~/ CMSV6 Идентификатор 1908 - "enabled": true, ~/~/ Признак включения 1909 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1910 -))) 1911 - 1912 - 1913 -((( 1914 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1915 - "login": "string", ~/~/ CMSV6 имя учетной записи 1916 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1917 - }, 1918 - "inspectionTasks": [ ~/~/ Задания на ТО 1919 - { 1920 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1921 - "enabled": true, ~/~/ Признак включения 1922 - "name": "string", ~/~/ Имя задания 1923 - "description": "string", ~/~/ Описание задания 1924 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1925 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1926 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1927 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1928 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1929 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 1930 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 1931 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 1932 - } 1933 - ], 1934 - "drivers": [ ~/~/ Список водителей 1935 - { 1936 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1937 - "inputNumber": 0, ~/~/ № входа. 1938 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 1939 - "comment": "string", ~/~/ Комментарий. 1940 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1941 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1942 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 1943 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 1944 - } 1945 - ], 1946 - "commandTemplates": [ ~/~/ Список шаблонов команд 1947 - { 1948 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1949 - "name": "string", ~/~/ Название шаблона команд 1950 - "command": "string", ~/~/ Команда на выполнение 1951 - "retries": 0 ~/~/ Лимит попыток отправки 1952 - } 1953 - ], 1954 - "sensors": [ ~/~/ Список датчиков 1955 - { 1956 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1957 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1958 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 1959 -))) 1960 - 1961 -((( 1962 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 1963 -))) 1964 - 1965 -((( 1966 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 1967 -))) 1968 - 1969 -((( 1970 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 1971 -))) 1972 - 1973 -((( 1974 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 1975 -))) 1976 - 1977 -((( 1978 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 1979 - "name": "string", ~/~/ Имя датчика 1980 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 1981 -))) 1982 - 1983 -((( 1984 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1985 - "inputNumber": 0, ~/~/ Номер входа 1986 - "pseudonym": "string", ~/~/ Псевдоним 1987 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1988 - "isInverted": true, ~/~/ Признак инверсии 1989 - "disabled": true, ~/~/ Датчик не участвует в обработке 1990 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1991 - "gradesTables": [ ~/~/ Тарировка 1712 +(% lang="en-US" style="text-align:left" %) 1713 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1714 + "vehicleId": "", ~/~/ ID ТС 1715 + "parentId": "", ~/~/ ID клиента 1716 + "name": "", ~/~/ имя ТС 1717 + "imei": "", ~/~/ IMEI 1718 + "deviceTypeId": "", ~/~/ типа устройства 1719 + "modelId": "", ~/~/ ID модели 1720 + "unitId": "", ~/~/ ID подразделения 1721 + "sim1": "", ~/~/ SIM 1 1722 + "sim2": "", ~/~/ SIM2 1723 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1724 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1725 + "counters": 1726 + { 1727 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1728 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1729 + "mileage": "", ~/~/ пробег 1730 + "motohours": "", ~/~/ моточасы 1731 + } 1732 + "cmsv6Parameters": ~/~/ параметры CMSv6 1992 1992 { 1993 - "grades": [ ~/~/ Таблицы тарировки 1994 - { 1995 - "input": 0, ~/~/ Вход 1996 - "output": 0 ~/~/ Выход 1997 - } 1998 - ], 1999 - "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2000 - } 2001 - ], 2002 - "showInTooltip": true, ~/~/ Отображение в подсказке 2003 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 2004 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2005 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2006 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2007 - "expr": "string", ~/~/ Выражение 2008 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2009 - "string" 2010 - ], 2011 - "customParams": { ~/~/ Дополнительные настройки 2012 - "additionalProp1": "string", 2013 - "additionalProp2": "string", 2014 - "additionalProp3": "string" 2015 - }, 2016 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2017 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1734 + "id": ~/~/ идентификатор 1735 + "enabled": true, ~/~/ флаг включения 1736 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1737 + "login": "", ~/~/ имя учетной записи 1738 + "password": "", ~/~/ пароль учетной записи 1739 + } 1740 + "inspectionTasks": ~/~/ задания на ТО 2018 2018 { 2019 - "from": 0, ~/~/ С какого значения 2020 - "color": "string", ~/~/ Каким цветом 2021 - "text": "string" ~/~/ Текст подписи к этому интервалу 1742 + "id": "", ~/~/ ID задания 1743 + "enabled": false, ~/~/ Признак включения 1744 + "name": "", ~/~/ Имя задания 1745 + "description": "", ~/~/ Описание задания 1746 + "mileageCondition": "", ~/~/ Условие по пробегу 1747 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1748 + "motohoursCondition": "", ~/~/ Условие по моточасам 1749 + "lastMotohours": "", ~/~/ Моточасы 1750 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1751 + "kind": "", ~/~/ Вид периодичности по времени 1752 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 2022 2022 } 2023 - ] 2024 - } 2025 - ], 2026 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2027 - "customFields": [ ~/~/ Список произвольных полей 2028 - { 2029 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2030 - "name": "string", ~/~/ Наименование произвольного поля 2031 - "value": "string", ~/~/ Значение произвольного поля 2032 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2033 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2034 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 2035 - } 2036 - ], 2037 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2038 -} 2039 -))) 1754 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 2040 2040 2041 2041 **Валидация:** 2042 2042 - сезонный параметр может быть задан только если задана соответствующая обычная норма; ... ... @@ -2365,12 +2365,6 @@ 2365 2365 } 2366 2366 ] 2367 2367 2368 -(% class="box warningmessage" %) 2369 -((( 2370 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2371 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2372 -))) 2373 - 2374 2374 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2375 2375 2376 2376 (% class="box infomessage" %) ... ... @@ -2458,7 +2458,7 @@ 2458 2458 ], 2459 2459 "stops": [ ~/~/ События стоянок 2460 2460 { 2461 - "address": " [Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес событияУлица, Дом, Город, Регион, Страна, Координаты2170 + "address": "string", ~/~/ Адрес события 2462 2462 "eventId": 0, ~/~/ Идентификатор события 2463 2463 "eventName": "string", ~/~/ Название события 2464 2464 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -4220,67 +4220,64 @@ 4220 4220 Тело запроса: 4221 4221 4222 4222 { 4223 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4224 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4225 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса3932 + "vehicleIds": [vehicleId], 3933 + "from": "2023-11-22T09:29:48.051Z", 3934 + "to": "2023-11-22T09:29:48.051Z" 4226 4226 } 4227 4227 3937 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3938 +|vehicleIds|Массив ID объектов 3939 +|from|Дата начала запроса 3940 +|to|Дата окончания запроса 3941 + 4228 4228 Ответ: 4229 4229 4230 4230 { 4231 - "items": [ ~/~/ Список в разрезе ТС3945 + "items": [ 4232 4232 { 4233 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4234 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4235 - "vehicleId": 0, ~/~/ ID ТС4236 - "vehicleName": "string", ~/~/ Название ТС4237 - "vehicleModel": "string", ~/~/ Модель ТС4238 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4239 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4240 - "totalViolations": 0, ~/~/ Нарушений всего4241 - "violationsByType": { ~/~/ Информация о нарушениях по типу4242 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4243 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4244 - "brakingViolations": 0, ~/~/ Нарушений торможения4245 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4246 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4247 - "sensorViolations": 0 ~/~/ Нарушений по датчику3947 + "from": "2023-11-22T09:29:48.052Z", 3948 + "to": "2023-11-22T09:29:48.052Z", 3949 + "vehicleId": 0, 3950 + "vehicleName": "string", 3951 + "vehicleModel": "string", 3952 + "penalty": 0, 3953 + "score": 0, 3954 + "totalViolations": 0, 3955 + "violationsByType": { 3956 + "overspeedingViolations": 0, 3957 + "accelerationViolations": 0, 3958 + "brakingViolations": 0, 3959 + "turningViolations": 0, 3960 + "dangerousDrivingViolations": 0, 3961 + "sensorViolations": 0 4248 4248 }, 4249 - 4250 -((( 4251 - 4252 -))) 4253 - 4254 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4255 - "mileage": 0, ~/~/ Пробег, м 4256 - "tripsCount": 0, ~/~/ Кол-во рейсов 4257 - "trips": [ ~/~/ Информация по рейсу 3963 + "moveTime": 0, 3964 + "mileage": 0, 3965 + "tripsCount": 0, 3966 + "trips": [ 4258 4258 { 4259 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4260 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4261 - "violationsCount": 0, ~/~/ Всего нарушений4262 - "violationsByType": { ~/~/ Информация о нарушениях по типу4263 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4264 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4265 - "brakingViolations": 0, ~/~/ Нарушений торможения4266 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4267 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4268 - "sensorViolations": 0 ~/~/ Нарушений по датчику3968 + "penalty": 0, 3969 + "score": 0, 3970 + "violationsCount": 0, 3971 + "violationsByType": { 3972 + "overspeedingViolations": 0, 3973 + "accelerationViolations": 0, 3974 + "brakingViolations": 0, 3975 + "turningViolations": 0, 3976 + "dangerousDrivingViolations": 0, 3977 + "sensorViolations": 0 4269 4269 }, 4270 - 4271 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4272 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4273 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4274 - "mileage": 0, ~/~/ Пробег, м 4275 - "motohours": 0, ~/~/ Моточасы, секунды 4276 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4277 - "startAddress": "string", ~/~/ Адрес начала рейса 4278 - "endAddress": "string", ~/~/ Адрес конца рейса 4279 - "drivers": [ ~/~/ Список водителей 3979 + "moveTime": 0, 3980 + "mileage": 0, 3981 + "motohours": 0, 3982 + "maxSpeed": 0, 3983 + "startAddress": "string", 3984 + "endAddress": "string", 3985 + "drivers": [ 4280 4280 { 4281 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4282 - "driverName": "string", ~/~/ФИО водителя4283 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки3987 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3988 + "driverName": "string", 3989 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4284 4284 } 4285 4285 ] 4286 4286 } ... ... @@ -4289,6 +4289,34 @@ 4289 4289 ] 4290 4290 } 4291 4291 3998 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3999 +|from|Дата начала запроса 4000 +|to|Дата окончания 4001 +|vehicleId|ID объекта 4002 +|vehicleName|Имя объекта 4003 +|vehicleModel|Модель объекта 4004 +|penalty|Сумма штрафных баллов 4005 +|score|Оценка 4006 +|totalViolations|Суммарное количество нарушений 4007 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 4008 +|overspeedingViolations|Превышение скорости 4009 +|accelerationViolations|Ускорение 4010 +|brakingViolations|Торможение 4011 +|turningViolations|Резкий поворот 4012 +|dangerousDrivingViolations|Резкое вождение 4013 +|sensorViolations|Нарушение по датчику 4014 +|moveTime|Время в движении 4015 +|mileage|Пробег (км) 4016 +|tripsCount|Количество рейсов 4017 +|motohours|Моточасы 4018 +|maxSpeed|Максимальная скорость 4019 +|startAddress|Адрес начала рейса 4020 +|endAddress|Адрес окончания рейса 4021 +|drivers|Список водителей, которые были на объекте в течениии рейса 4022 +|driverGuid|Guid водителя 4023 +|driverName|Имя водителя 4024 +|driverRfid|Номер Карты-метки 4025 + 4292 4292 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4293 4293 4294 4294 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==