Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
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. SupportZhuchkov1 +XWiki.Gadmin - Content
-
... ... @@ -1,17 +1,5 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -(% class="box warningmessage" %) 4 -((( 5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 -просим вас соблюдать несколько простых правил при использовании API-команд:## 7 -))) 8 - 9 -* Формировать не более 3 отчётов одновременно. 10 -* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 - 12 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 - 14 - 15 15 **Содержание страницы:** 16 16 ))) 17 17 ... ... @@ -26,7 +26,7 @@ 26 26 27 27 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 28 28 29 -(% style="color:#000000" %)− (%%)При **редактировании** любойзаписи (пользователь, объект и т.д)необходимо передавать все параметры записив теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 30 30 31 31 32 32 (% style="color:#000000; font-size:16px" %)**Рекомендации** ... ... @@ -35,11 +35,7 @@ 35 35 36 36 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 37 37 38 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 39 -((( 40 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 41 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 42 -))) 26 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 43 43 44 44 (% class="box successmessage" %) 45 45 ((( ... ... @@ -992,7 +992,7 @@ 992 992 993 993 Ответ: В случае успеха **Success 200** 994 994 995 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =979 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 996 996 997 997 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 998 998 ... ... @@ -1194,15 +1194,13 @@ 1194 1194 Команда для отправки на тс. 1195 1195 1196 1196 { 1197 -"id": "", ~/~/идентификатор о бъекта (онже идентификаторТС: vehicleId)1198 -"command": "", ~/~/ Текст отправляемойкоманды1199 -"retries": "", ~/~/ Количество попыток отправки на терминал1200 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов).1181 +"id": "", ~/~/идентификатор произвольного поля 1182 +"command": "", ~/~/ Текст команды 1183 +"retries": "", ~/~/ Количество попыток 1184 +"idTemplate": "" ~/~/ ID шаблона команды 1201 1201 } 1202 1202 1203 -В ответ получаем cmdid 1204 1204 1205 - 1206 1206 == **Получить ответ на отправленную на ТС команду** == 1207 1207 1208 1208 (% class="box infomessage" %) ... ... @@ -1210,13 +1210,13 @@ 1210 1210 (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1211 1211 ))) 1212 1212 1213 -Идентификатор команды: cmd Id1195 +Идентификатор команды: cmdid 1214 1214 1215 1215 Запрос от терминала на ответ команды 1216 1216 1217 1217 Пример ответ от терминала: 1218 1218 1219 -ID= "" ~/~/ идентификатор о бъекта1201 +ID= "" ~/~/ идентификатор произвольного поля 1220 1220 Soft="" ~/~/ версия софта 1221 1221 GPS=4 ~/~/ тип трекера 1222 1222 Time=11:05:43 28.06.24 ~/~/ время запроса ... ... @@ -1386,31 +1386,17 @@ 1386 1386 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1387 1387 ~/~/ "ValueOn": "Вкл.", 1388 1388 ~/~/ "ValueOff": "Выкл." 1389 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1390 - 1391 -((( 1392 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1393 - { 1394 - "from": 0, ~/~/ С какого значения 1395 - "color": "string", ~/~/ Каким цветом 1396 - "text": "string" ~/~/ Текст подписи к этому интервалу 1397 - } 1398 - ] 1371 + "summaryMaxValue": 0 ~/~/ Макс. значение 1399 1399 } 1400 1400 ], 1401 -))) 1402 - 1403 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1404 - 1405 - 1406 1406 "customFields": [ ~/~/ Произвольные поля 1407 1407 { 1408 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1409 - "name": "string", ~/~/ Наименование произвольного поля1410 - "value": "string", ~/~/ Значение произвольного поля1411 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1412 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1413 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1376 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1377 + "name": "string", 1378 + "value": "string", 1379 + "forClient": true, 1380 + "forTooltip": true, 1381 + "forReport": true 1414 1414 } 1415 1415 ] 1416 1416 } ... ... @@ -1417,236 +1417,55 @@ 1417 1417 1418 1418 (% style="color:#000000" %)Ответ: 1419 1419 1420 - 1421 -((( 1422 -((( 1423 -((( 1424 -{ 1425 - "vehicleId": 0, ~/~/ ID ТС 1426 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1427 - "name": "string", ~/~/ Имя объекта 1428 - "imei": "string", ~/~/ IMEI 1429 - "deviceTypeId": 0, ~/~/ ID типа устройства 1430 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1431 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1432 - "sim1": "string", ~/~/ SIM1 1433 - "sim2": "string", ~/~/ SIM2 1434 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1435 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1436 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1437 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1438 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1439 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1440 - "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1441 - "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1442 - "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1443 - "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1444 - "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1445 - "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1446 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1447 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1448 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1449 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1450 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1451 - "counters": { ~/~/ Dto для состояний счётчиков 1452 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1453 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1454 - "mileage": 0, ~/~/ Пробег 1455 - "motohours": 0 ~/~/ Моточасы 1456 - }, 1457 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1458 - "id": "string", ~/~/ CMSV6 Идентификатор 1459 - "enabled": true, ~/~/ Признак включения 1460 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1461 - "login": "string", ~/~/ CMSV6 имя учетной записи 1462 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1463 - }, 1464 - "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1465 - { 1466 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1467 - "enabled": true, ~/~/ Признак включения 1468 - "name": "string", ~/~/ Имя задания 1469 - "description": "string", ~/~/ Описание задания 1470 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1471 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1472 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1473 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1474 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1475 - "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1476 - "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1477 - "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 - однократно) 1478 1478 } 1479 - ], 1480 - "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1481 - { 1482 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1483 - "inputNumber": 0, ~/~/ № входа. 1484 - "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1485 - "comment": "string", ~/~/ Комментарий 1486 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1487 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1488 - "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1489 - "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1490 - } 1491 - ], 1492 - "commandTemplates": [ ~/~/ Список шаблонов команд 1493 - { 1494 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1495 - "name": "string", ~/~/ Название шаблона команд 1496 - "command": "string", ~/~/ Команда на выполнение 1497 - "retries": 0 ~/~/ Лимит попыток отправки 1498 - } 1499 - ], 1500 - "sensors": [ ~/~/ Список датчиков 1501 - { 1502 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1503 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1504 - "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 1505 - "name": "string", ~/~/ Имя датчика 1506 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1507 - "inputNumber": 0, ~/~/ Номер входа 1508 - "pseudonym": "string", ~/~/ Псевдоним 1509 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1510 - "isInverted": true, ~/~/ Признак инверсии 1511 - "disabled": true, ~/~/ Датчик не участвует в обработке 1512 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1513 - "gradesTables": [ ~/~/ Тарировка 1514 - { 1515 - "grades": [ ~/~/ Таблицы тарировки 1516 - { 1517 - "input": 0, ~/~/ Вход 1518 - "output": 0 ~/~/ Выход 1519 - } 1520 - ], 1521 - "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1522 - } 1523 - ], 1524 - "showInTooltip": true, ~/~/ Отображение в подсказке 1525 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 1526 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1527 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1528 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1529 - "expr": "string", ~/~/ Выражение 1530 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1531 - "string" 1532 - ], 1533 - "customParams": { 1534 - "additionalProp1": "string", 1535 - "additionalProp2": "string", 1536 - "additionalProp3": "string" 1537 - }, 1538 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1539 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1540 - { 1541 - "from": 0, ~/~/ С какого значения 1542 - "color": "string", ~/~/ Каким цветом 1543 -))) 1426 +(% style="color:#000000" %)} 1544 1544 1545 -((( 1546 - "text": "string" ~/~/ Текст подписи к этому интервалу 1547 - } 1548 - ] 1549 - } 1550 - ], 1551 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1552 - "customFields": [ ~/~/ Список произвольных полей 1553 - { 1554 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1555 - "name": "string", ~/~/ Наименование произвольного поля 1556 - "value": "string", ~/~/ Значение произвольного поля 1557 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1558 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1559 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1560 - } 1561 - ], 1562 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1563 -} 1564 -))) 1565 -))) 1566 -))) 1567 - 1568 - 1569 1569 **Валидация:** 1570 1570 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1571 1571 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1572 1572 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1573 1573 1433 +== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) == 1574 1574 1575 -== **Импортировать историю ТС (Асинхронный запрос)** == 1576 - 1577 -(% class="box successmessage" %) 1578 -((( 1579 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1580 -))) 1581 - 1582 -Метод запроса: **POST** 1583 - 1584 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1585 - 1586 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1587 - 1588 - 1589 -Ответ: 1590 - 1591 -{ 1592 - 1593 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1594 - 1595 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1596 - 1597 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1598 - 1599 - "Message": "string", ~/~/ Информация о выполнении запроса 1600 - 1601 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1602 - 1603 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1604 - 1605 - "Data": "string" ~/~/ Данные 1606 - 1607 -} 1608 - 1609 - 1610 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 1611 - 1612 1612 (% class="box infomessage" %) 1613 1613 ((( 1614 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1615 -))) 1616 - 1617 -Метод запроса: **GET** 1618 - 1619 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1620 - 1621 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1622 - 1623 - 1624 -Ответ: 1625 - 1626 -{ 1627 - 1628 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1629 - 1630 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 1631 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1632 - 1633 - "Message": "string", ~/~/ Информация о выполнении запроса 1634 - 1635 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1636 - 1637 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1638 - 1639 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1640 - 1641 - "Data": "string" ~/~/ Данные 1642 - 1643 -} 1644 - 1645 - 1646 -== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1647 - 1648 -(% class="box infomessage" %) 1649 -((( 1650 1650 (% lang="en-US" %)**POST /api/v3/vehicles/find** 1651 1651 ))) 1652 1652 ... ... @@ -1684,12 +1684,9 @@ 1684 1684 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1685 1685 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1686 1686 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1687 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1688 - "unitName": "string", ~/~/ Название подразделения (опционально) 1689 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1690 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1691 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1692 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1474 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1475 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1476 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1693 1693 } 1694 1694 1695 1695 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1696,15 +1696,8 @@ 1696 1696 1697 1697 (% style="color:#000000" %)Ответ: 1698 1698 1699 -(% style="color:#000000" %)[ 1700 -{ 1701 - 1702 -((( 1703 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1704 -))) 1705 - 1706 -((( 1707 -(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1483 +(% style="color:#000000" %){ 1484 + "vehicleId": "" ~/~/ идентификатор объекта 1708 1708 "name": "" ~/~/ наименование объекта 1709 1709 "imei": "" ~/~/ IMEI объекта 1710 1710 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1729,21 +1729,9 @@ 1729 1729 "forClient": true, ~/~/ право на отображение у клиента 1730 1730 "forTooltip": false, ~/~/ право на отображение в подсказке 1731 1731 "forReport": false ~/~/ право на отображение в отчетах 1732 -))) 1509 + }(%%) 1510 +(% style="color:#000000" %)} 1733 1733 1734 -((( 1735 - } 1736 - ], 1737 - "vehicleGroups": [ ~/~/ Группы ТС 1738 - { 1739 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1740 - "name": "string" ~/~/ Наименование группы ТС 1741 - } 1742 - ] 1743 - } 1744 -] 1745 -))) 1746 - 1747 1747 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1748 1748 1749 1749 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1928,201 +1928,65 @@ 1928 1928 ~/~/ "ValueOn": "Вкл.", 1929 1929 ~/~/ "ValueOff": "Выкл." 1930 1930 "summaryMaxValue": 0 ~/~/ Макс. значение 1931 - 1932 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1933 - { 1934 - "from": 0, ~/~/ С какого значения 1935 - "color": "string", ~/~/ Каким цветом 1936 - "text": "string" ~/~/ Текст подписи к этому интервалу 1937 - } 1938 - ] 1939 1939 } 1940 1940 ], 1941 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1942 - 1943 1943 "customFields": [ ~/~/ Произвольные поля 1944 - { 1945 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1946 - "name": "string", ~/~/ Наименование произвольного поля1947 - "value": "string", ~/~/ Значение произвольного поля1948 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1949 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1950 - "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 1951 1951 } 1952 1952 ] 1953 1953 } 1954 1954 1955 - 1956 1956 (% style="color:#000000" %)Ответ: 1957 1957 1958 -((( 1959 -{ 1960 - "vehicleId": 0, ~/~/ ID ТС 1961 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1962 - "name": "string", ~/~/ Имя объекта 1963 - "imei": "string", ~/~/ IMEI 1964 - "deviceTypeId": 0, ~/~/ ID типа устройства 1965 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1966 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1967 - "sim1": "string", ~/~/ SIM1 1968 - "sim2": "string", ~/~/ SIM2 1969 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1970 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1971 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1972 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1973 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1974 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1975 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1976 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1977 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1978 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1979 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1980 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1981 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 1982 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1983 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1984 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1985 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1986 - "counters": { ~/~/ состояний счётчиков 1987 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1988 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1989 - "mileage": 0, ~/~/ Пробег 1990 - "motohours": 0 ~/~/ Моточасы 1991 - }, 1992 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1993 - "id": "string", ~/~/ CMSV6 Идентификатор 1994 - "enabled": true, ~/~/ Признак включения 1995 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1996 -))) 1997 - 1998 - 1999 -((( 2000 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 2001 - "login": "string", ~/~/ CMSV6 имя учетной записи 2002 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 2003 - }, 2004 - "inspectionTasks": [ ~/~/ Задания на ТО 2005 - { 2006 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 2007 - "enabled": true, ~/~/ Признак включения 2008 - "name": "string", ~/~/ Имя задания 2009 - "description": "string", ~/~/ Описание задания 2010 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 2011 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 2012 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 2013 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 2014 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 2015 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 2016 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 2017 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 2018 - } 2019 - ], 2020 - "drivers": [ ~/~/ Список водителей 2021 - { 2022 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 2023 - "inputNumber": 0, ~/~/ № входа. 2024 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 2025 - "comment": "string", ~/~/ Комментарий. 2026 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 2027 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 2028 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 2029 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 2030 - } 2031 - ], 2032 - "commandTemplates": [ ~/~/ Список шаблонов команд 2033 - { 2034 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 2035 - "name": "string", ~/~/ Название шаблона команд 2036 - "command": "string", ~/~/ Команда на выполнение 2037 - "retries": 0 ~/~/ Лимит попыток отправки 2038 - } 2039 - ], 2040 - "sensors": [ ~/~/ Список датчиков 2041 - { 2042 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 2043 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 2044 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 2045 -))) 2046 - 2047 -((( 2048 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 2049 -))) 2050 - 2051 -((( 2052 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 2053 -))) 2054 - 2055 -((( 2056 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 2057 -))) 2058 - 2059 -((( 2060 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 2061 -))) 2062 - 2063 -((( 2064 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 2065 - "name": "string", ~/~/ Имя датчика 2066 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 2067 -))) 2068 - 2069 -((( 2070 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 2071 - "inputNumber": 0, ~/~/ Номер входа 2072 - "pseudonym": "string", ~/~/ Псевдоним 2073 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 2074 - "isInverted": true, ~/~/ Признак инверсии 2075 - "disabled": true, ~/~/ Датчик не участвует в обработке 2076 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 2077 - "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 2078 2078 { 2079 - "grades": [ ~/~/ Таблицы тарировки 2080 - { 2081 - "input": 0, ~/~/ Вход 2082 - "output": 0 ~/~/ Выход 2083 - } 2084 - ], 2085 - "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2086 - } 2087 - ], 2088 - "showInTooltip": true, ~/~/ Отображение в подсказке 2089 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 2090 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2091 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2092 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2093 - "expr": "string", ~/~/ Выражение 2094 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2095 - "string" 2096 - ], 2097 - "customParams": { ~/~/ Дополнительные настройки 2098 - "additionalProp1": "string", 2099 - "additionalProp2": "string", 2100 - "additionalProp3": "string" 2101 - }, 2102 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2103 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1734 + "id": ~/~/ идентификатор 1735 + "enabled": true, ~/~/ флаг включения 1736 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1737 + "login": "", ~/~/ имя учетной записи 1738 + "password": "", ~/~/ пароль учетной записи 1739 + } 1740 + "inspectionTasks": ~/~/ задания на ТО 2104 2104 { 2105 - "from": 0, ~/~/ С какого значения 2106 - "color": "string", ~/~/ Каким цветом 2107 - "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": "", ~/~/ Сколько раз выполнить задание 2108 2108 } 2109 - ] 2110 - } 2111 - ], 2112 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2113 - "customFields": [ ~/~/ Список произвольных полей 2114 - { 2115 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2116 - "name": "string", ~/~/ Наименование произвольного поля 2117 - "value": "string", ~/~/ Значение произвольного поля 2118 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2119 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2120 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 2121 - } 2122 - ], 2123 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2124 -} 2125 -))) 1754 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 2126 2126 2127 2127 **Валидация:** 2128 2128 - сезонный параметр может быть задан только если задана соответствующая обычная норма; ... ... @@ -2397,12 +2397,10 @@ 2397 2397 { 2398 2398 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2399 2399 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2400 - "mileage": 0, ~/~/ Пробег за период, километры 2401 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2402 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2403 - "motohours": 0, ~/~/ Моточасы за период, секунды 2404 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2405 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2029 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2030 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2031 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2032 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2406 2406 } 2407 2407 ] 2408 2408 } ... ... @@ -2451,12 +2451,6 @@ 2451 2451 } 2452 2452 ] 2453 2453 2454 -(% class="box warningmessage" %) 2455 -((( 2456 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2457 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2458 -))) 2459 - 2460 2460 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2461 2461 2462 2462 (% class="box infomessage" %) ... ... @@ -2544,7 +2544,7 @@ 2544 2544 ], 2545 2545 "stops": [ ~/~/ События стоянок 2546 2546 { 2547 - "address": " [Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес событияУлица, Дом, Город, Регион, Страна, Координаты2168 + "address": "string", ~/~/ Адрес события 2548 2548 "eventId": 0, ~/~/ Идентификатор события 2549 2549 "eventName": "string", ~/~/ Название события 2550 2550 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -2913,9 +2913,9 @@ 2913 2913 2914 2914 URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2915 2915 2916 -В заголовках запроса: X-Auth: Токен авторизации .2537 +В заголовках запроса: X-Auth: Токен авторизации 2917 2917 2918 -Тело запроса :2539 +Тело запроса 2919 2919 2920 2920 [ 2921 2921 ... ... @@ -2923,7 +2923,7 @@ 2923 2923 2924 2924 ] 2925 2925 2926 -где 0 идентификатор ids .2547 +где 0 идентификатор ids 2927 2927 2928 2928 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2929 2929 ... ... @@ -4306,67 +4306,64 @@ 4306 4306 Тело запроса: 4307 4307 4308 4308 { 4309 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4310 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4311 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса3930 + "vehicleIds": [vehicleId], 3931 + "from": "2023-11-22T09:29:48.051Z", 3932 + "to": "2023-11-22T09:29:48.051Z" 4312 4312 } 4313 4313 3935 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3936 +|vehicleIds|Массив ID объектов 3937 +|from|Дата начала запроса 3938 +|to|Дата окончания запроса 3939 + 4314 4314 Ответ: 4315 4315 4316 4316 { 4317 - "items": [ ~/~/ Список в разрезе ТС3943 + "items": [ 4318 4318 { 4319 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4320 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4321 - "vehicleId": 0, ~/~/ ID ТС4322 - "vehicleName": "string", ~/~/ Название ТС4323 - "vehicleModel": "string", ~/~/ Модель ТС4324 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4325 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4326 - "totalViolations": 0, ~/~/ Нарушений всего4327 - "violationsByType": { ~/~/ Информация о нарушениях по типу4328 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4329 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4330 - "brakingViolations": 0, ~/~/ Нарушений торможения4331 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4332 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4333 - "sensorViolations": 0 ~/~/ Нарушений по датчику3945 + "from": "2023-11-22T09:29:48.052Z", 3946 + "to": "2023-11-22T09:29:48.052Z", 3947 + "vehicleId": 0, 3948 + "vehicleName": "string", 3949 + "vehicleModel": "string", 3950 + "penalty": 0, 3951 + "score": 0, 3952 + "totalViolations": 0, 3953 + "violationsByType": { 3954 + "overspeedingViolations": 0, 3955 + "accelerationViolations": 0, 3956 + "brakingViolations": 0, 3957 + "turningViolations": 0, 3958 + "dangerousDrivingViolations": 0, 3959 + "sensorViolations": 0 4334 4334 }, 4335 - 4336 -((( 4337 - 4338 -))) 4339 - 4340 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4341 - "mileage": 0, ~/~/ Пробег, м 4342 - "tripsCount": 0, ~/~/ Кол-во рейсов 4343 - "trips": [ ~/~/ Информация по рейсу 3961 + "moveTime": 0, 3962 + "mileage": 0, 3963 + "tripsCount": 0, 3964 + "trips": [ 4344 4344 { 4345 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4346 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4347 - "violationsCount": 0, ~/~/ Всего нарушений4348 - "violationsByType": { ~/~/ Информация о нарушениях по типу4349 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4350 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4351 - "brakingViolations": 0, ~/~/ Нарушений торможения4352 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4353 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4354 - "sensorViolations": 0 ~/~/ Нарушений по датчику3966 + "penalty": 0, 3967 + "score": 0, 3968 + "violationsCount": 0, 3969 + "violationsByType": { 3970 + "overspeedingViolations": 0, 3971 + "accelerationViolations": 0, 3972 + "brakingViolations": 0, 3973 + "turningViolations": 0, 3974 + "dangerousDrivingViolations": 0, 3975 + "sensorViolations": 0 4355 4355 }, 4356 - 4357 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4358 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4359 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4360 - "mileage": 0, ~/~/ Пробег, м 4361 - "motohours": 0, ~/~/ Моточасы, секунды 4362 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4363 - "startAddress": "string", ~/~/ Адрес начала рейса 4364 - "endAddress": "string", ~/~/ Адрес конца рейса 4365 - "drivers": [ ~/~/ Список водителей 3977 + "moveTime": 0, 3978 + "mileage": 0, 3979 + "motohours": 0, 3980 + "maxSpeed": 0, 3981 + "startAddress": "string", 3982 + "endAddress": "string", 3983 + "drivers": [ 4366 4366 { 4367 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4368 - "driverName": "string", ~/~/ФИО водителя4369 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки3985 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3986 + "driverName": "string", 3987 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4370 4370 } 4371 4371 ] 4372 4372 } ... ... @@ -4375,6 +4375,34 @@ 4375 4375 ] 4376 4376 } 4377 4377 3996 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3997 +|from|Дата начала запроса 3998 +|to|Дата окончания 3999 +|vehicleId|ID объекта 4000 +|vehicleName|Имя объекта 4001 +|vehicleModel|Модель объекта 4002 +|penalty|Сумма штрафных баллов 4003 +|score|Оценка 4004 +|totalViolations|Суммарное количество нарушений 4005 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 4006 +|overspeedingViolations|Превышение скорости 4007 +|accelerationViolations|Ускорение 4008 +|brakingViolations|Торможение 4009 +|turningViolations|Резкий поворот 4010 +|dangerousDrivingViolations|Резкое вождение 4011 +|sensorViolations|Нарушение по датчику 4012 +|moveTime|Время в движении 4013 +|mileage|Пробег 4014 +|tripsCount|Количество рейсов 4015 +|motohours|Моточасы 4016 +|maxSpeed|Максимальная скорость 4017 +|startAddress|Адрес начала рейса 4018 +|endAddress|Адрес окончания рейса 4019 +|drivers|Список водителей, которые были на объекте в течениии рейса 4020 +|driverGuid|Guid водителя 4021 +|driverName|Имя водителя 4022 +|driverRfid|Номер Карты-метки 4023 + 4378 4378 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4379 4379 4380 4380 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == ... ... @@ -4438,22 +4438,22 @@ 4438 4438 Пример ответа: 4439 4439 4440 4440 { 4441 -"description": "", ~/~/ Поле описания ретранслятора4442 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)4443 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4444 -"isEnabled": true, ~/~/ Признак включенияретранслятора, Включен, true - включен, false - отключен4445 -"address": "string", ~/~/ Адрес и портпринимающего сервера4446 -"objects": [ ~/~/ 4087 +"description": "", ~/~/ Определяет описание 4088 +"subscriberId": "", ~/~/ Подписчик 4089 +"protocolType": 0, ~/~/ Тип протокола 4090 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4091 +"address": "string", ~/~/ Адрес события 4092 +"objects": [ ~/~/Объекты для ретрансляции 4447 4447 { 4448 4448 "id": "", ~/~/ Идентификатор объекта ретрансляции 4449 4449 "name": "", ~/~/ Наименование объекта ретрансляции 4450 -"imei": "", ~/~/ IMEI объекта ретрансляции4451 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4096 +"imei": "", ~/~/ IMEI объекта 4097 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4452 4452 } 4453 4453 ], 4454 -"id": "", ~/~/ Идентификаторретранслятора4455 -"parentId": "", ~/~/ Идентификаторродителя(вышестоящего клиента)4456 -"deleted": "" ~/~/ Признак удаления ретранслятора:true - включен, false - отключен4100 +"id": "", ~/~/ идентификатор пользователя 4101 +"parentId": "", ~/~/Guid родителя 4102 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4457 4457 } 4458 4458 4459 4459 ... ... @@ -4464,7 +4464,7 @@ 4464 4464 **DELETE** **/api/v3/retranslations/{id}** 4465 4465 ))) 4466 4466 4467 -Параметр запроса: ID - Идентификатор ретранслятора4113 +Параметр запроса: ID 4468 4468 4469 4469 4470 4470 == **Создание ретранслятора** == ... ... @@ -4477,16 +4477,16 @@ 4477 4477 Запрос: 4478 4478 4479 4479 { 4480 -"description": "", ~/~/ Поле описания ретранслятора4481 -"subscriberId": "", ~/~/ Идентификатор подписчика4482 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4483 -"address": "", ~/~/ Адрес и портпринимающегосервера4484 -"isEnabled": "", ~/~/ Признакретранслятора, true - включен, false - отключен4126 +"description": "", ~/~/ Описание 4127 +"subscriberId": "", ~/~/ Подписчик 4128 +"protocolType": 0, ~/~/ Тип протокола 4129 +"address": "", ~/~/ Адрес ретрансляции 4130 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4485 4485 "objects": [ ~/~/Объекты для ретрансляции 4486 4486 { 4487 -"id": "", ~/~/ Идентификаторретранслятора4488 -"imei": "", ~/~/ ретрансляции4489 -"isEnabled": "" ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4133 +"id": "", ~/~/ идентификатор пользователя 4134 +"imei": "", ~/~/IMEI объекта 4135 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4490 4490 } 4491 4491 ] 4492 4492 } ... ... @@ -4495,22 +4495,22 @@ 4495 4495 Ответ: 4496 4496 4497 4497 { 4498 -"description": "", ~/~/ Поле описания ретранслятора4499 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4500 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4501 -"isEnabled": true, ~/~/Признакретранслятора:true - включен, false - отключен4502 -"address": " string", ~/~/ Адреси портпринимающего сервера4503 -"objects": [ 4144 +"description": "string", ~/~/ Определяет описание 4145 +"subscriberId": "", ~/~/ идентификатор запроса 4146 +"protocolType": 0, ~/~/ Тип протокола 4147 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4148 +"address": "", ~/~/ Адрес события 4149 +"objects": [ ~/~/Объекты для ретрансляции 4504 4504 { 4505 -"id": "", ~/~/ Идентификатор объектаретрансляции4506 -"name": "string", ~/~/ На именование объекта ретрансляции4507 -"imei": "", ретрансляции4508 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4151 +"id": "", ~/~/ идентификатор пользователя 4152 +"name": "string", ~/~/ Название уведомления 4153 +"imei": "string", ~/~/IMEI объекта 4154 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4509 4509 } 4510 - ], 4511 -"id": "", ~/~/ Идентификаторретранслятора4512 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4513 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4156 + ], 4157 +"id": "", ~/~/ идентификатор пользователя 4158 +"parentId": "", ~/~/ Guid идентификатор родителя 4159 +"deleted": true ~/~/ Признак удаления 4514 4514 } 4515 4515 4516 4516 ... ... @@ -4524,18 +4524,18 @@ 4524 4524 Пример запроса: 4525 4525 4526 4526 { 4527 -"id": "", ~/~/ Идентификаторретранслятора4528 -"description": "string", ~/~/ Поле описания ретранслятора4529 -"subscriberId": "", ~/~/ Идентификатор подписчика4530 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4531 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4532 -"address": "string", ~/~/ Адрес и портпринимающего сервера4533 -"objects": ~/~/ 4173 +"id": "", ~/~/ идентификатор пользователя 4174 +"description": "string", ~/~/ Определяет описание 4175 +"subscriberId": "", ~/~/ идентификатор запроса 4176 +"protocolType": 0, ~/~/ Тип протокола 4177 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4178 +"address": "string", ~/~/ Адрес события 4179 +"objects": ~/~/Объекты для ретрансляции 4534 4534 [ 4535 4535 { 4536 -"id": "", ~/~/ Идентификатор объектаретрансляции4537 -"imei": "", ~/~/ ретрансляции4538 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4182 +"id": "", ~/~/ идентификатор пользователя 4183 +"imei": "", ~/~/IMEI объекта 4184 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4539 4539 } 4540 4540 ] 4541 4541 } ... ... @@ -4544,22 +4544,22 @@ 4544 4544 Пример ответа: 4545 4545 4546 4546 { 4547 -"description": "", ~/~/ Поле описания ретранслятора4548 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4549 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4550 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4551 -"address": "string", ~/~/ Адрес и портпринимающего сервера4552 -"objects": [ ~/~/ 4193 +"description": "", ~/~/ Определяет описание 4194 +"subscriberId": "", ~/~/ идентификатор запроса 4195 +"protocolType": 0, ~/~/ Тип протокола 4196 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4197 +"address": "string", ~/~/ Адрес события 4198 +"objects": [ ~/~/Объекты для ретрансляции 4553 4553 { 4554 -"id": "", ~/~/ Идентификатор объектаретрансляции4555 -"name": "string", ~/~/ На именование объекта ретрансляции4556 -"imei": "", ~/~/ ретрансляции4557 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4200 +"id": "", ~/~/ идентификатор пользователя 4201 +"name": "string", ~/~/ Название уведомления 4202 +"imei": "", ~/~/IMEI объекта 4203 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4558 4558 } 4559 4559 ], 4560 -"id": "", ~/~/ Идентификаторретранслятора4561 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4562 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4206 +"id": "", ~/~/ идентификатор пользователя 4207 +"parentId": "", ~/~/ Guid идентификатор родителя 4208 +"deleted": true ~/~/ Признак удаления 4563 4563 } 4564 4564 4565 4565 ... ... @@ -4573,9 +4573,9 @@ 4573 4573 Пример запроса: 4574 4574 4575 4575 { 4576 -"id": "", ~/~/ Идентификаторретранслятора4222 +"id": "", ~/~/ идентификатор пользователя 4577 4577 "search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4578 -"parentId": "" ~/~/ Идентификатор родительскогоагента, для которого надо получить данные(вышестоящего клиента).4224 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4579 4579 } 4580 4580 4581 4581 Ответ: ... ... @@ -4582,14 +4582,14 @@ 4582 4582 4583 4583 [ 4584 4584 { 4585 -"description": "", ~/~/ Поле описания ретранслятора4586 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4587 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4588 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4589 -"address": "string", ~/~/ Адрес и портпринимающего сервера4590 -"id": "", ~/~/ Идентификаторретранслятора4591 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4592 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4231 +"description": "", ~/~/ Определяет описание 4232 +"subscriberId": "", ~/~/ идентификатор запроса 4233 +"protocolType": 0, ~/~/ Тип протокола 4234 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4235 +"address": "string", ~/~/ Адрес события 4236 +"id": "", ~/~/ идентификатор пользователя 4237 +"parentId": "", ~/~/ Guid идентификатор родителя 4238 +"deleted": true ~/~/ Признак удаления 4593 4593 } 4594 4594 ] 4595 4595