Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Михаил Жучков on 2025/10/30 11:26
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -11,11 +11,6 @@ 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 13 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 -))) 19 19 20 20 **Содержание страницы:** 21 21 ))) ... ... @@ -123,41 +123,29 @@ 123 123 Запрос должен содержать данные параметра "**agentId**" 124 124 125 125 (% style="color:#000000" %)Ответ: 126 - 127 -((( 128 128 { 129 - "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID клиента 130 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID родителя 131 - "parentName": "string", ~/~/ Наименование агента 132 - "name": "string", ~/~/ Имя клиента 133 - "fullName": "string", ~/~/ ФИО клиента 134 - "agentInfoType": 0, ~/~/ Тип клиента ((% style="color:#000000" %)0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор(%%)) 135 - "isForeign": true, ~/~/ Флаг "Иностранный контрагент" 136 - "district": "string", ~/~/ Район 137 - "region": "string", ~/~/ Область 138 - "city": "string", ~/~/ Город 139 - "email": "string", ~/~/ Email 140 - "director": "string", ~/~/ Руководитель 141 - "RegionalData": [ ~/~/ Определяет региональные сведения. 142 - { 143 - "Country": 0, ~/~/ Страна 144 - "groups": [ ~/~/ Список групп 145 - { 146 - "groupId": "string", ~/~/ Уникальный идентификатор группы 147 - "fields": [ ~/~/ Список значений полей 148 - { 149 - "name": "string", ~/~/ Имя поля формы 150 - "value": "string" ~/~/ Значение поля формы 151 - } 152 - ] 153 - } 154 - ] 155 - } 156 - ] 157 -} 158 -))) 122 + "agentId": "", (%%) 123 + "parentId": "", 124 + "parentName": "string", 125 + "name": "string", 126 + "fullName": "string", 127 + "agentInfoType": 0, 128 + "isForeign": true/false, 129 + "district": "string", 130 + "region": "string", 131 + "city": "string", 132 + "inn": "string", 133 + "kpp": "string", 134 + "address": "string", 135 + "addressFact": "string", 136 + "email": "string", 137 + "director": "string", 138 + "bankName": "string", 139 + "bankBIK": "string", 140 + "bankRS": "string", 141 + "bankKS": "string" 142 + } 159 159 160 - 161 161 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 162 162 |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 163 163 |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя ... ... @@ -202,7 +202,7 @@ 202 202 (% style="color:#000000" %)Параметр запроса: 203 203 204 204 (% style="color:#000000" %){ 205 - "parentId": " (%%)string(% style="color:#000000" %)" ~/~/ для получение собственного parentId отправьте пустой запрос (пример "parentId": "" )188 + "parentId": "string" 206 206 } 207 207 208 208 (% style="color:#000000" %)Ответ: ... ... @@ -287,6 +287,28 @@ 287 287 "bankKS": "string" ~/~/ корр. счёт 288 288 } 289 289 273 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 274 +|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 275 +|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 276 +|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 277 +|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 278 +|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 279 +|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 280 +|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 281 +|(% style="width:215px" %)district|(% style="width:861px" %)Округ 282 +|(% style="width:215px" %)region|(% style="width:861px" %)Регион 283 +|(% style="width:215px" %)city|(% style="width:861px" %)Город 284 +|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 285 +|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 286 +|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 287 +|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 288 +|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 289 +|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 290 +|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 291 +|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 292 +|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 293 +|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 294 + 290 290 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 291 291 292 292 (% class="box warningmessage" %) ... ... @@ -432,7 +432,7 @@ 432 432 [ 433 433 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 434 434 ], 435 - "language": 1~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский440 + "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 436 436 } 437 437 { 438 438 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -744,11 +744,6 @@ 744 744 (% style="text-align:left" %) 745 745 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 746 746 747 -(% class="wikigeneratedid" id="H" %) 748 -((( 749 - 750 -))) 751 - 752 752 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 753 753 754 754 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -860,7 +860,7 @@ 860 860 { 861 861 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 862 862 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 863 - "deleted": false,863 + "deleted": true, 864 864 "extId": "string", 865 865 "name": "string", 866 866 "picture": "string", ... ... @@ -879,7 +879,7 @@ 879 879 { 880 880 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 881 881 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 882 - "deleted": false,882 + "deleted": true, 883 883 "extId": "string", 884 884 "name": "string", 885 885 "picture": "string", ... ... @@ -913,7 +913,7 @@ 913 913 (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models** 914 914 ))) 915 915 916 -(% style="color:#000000" %)Метод позволяет изменить статус модели, указанного в запросе.916 +(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе. 917 917 918 918 (% style="color:#000000" %)Метод запроса: **PUT** 919 919 ... ... @@ -980,7 +980,7 @@ 980 980 (% lang="en-US" %)**DELETE /api/v3/models/{Id}** 981 981 ))) 982 982 983 -(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалитьмодель, указанного в строке запроса.983 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 984 984 985 985 (% style="color:#000000" %)Метод запроса: **DELETE** 986 986 ... ... @@ -1021,17 +1021,6 @@ 1021 1021 1022 1022 ((( 1023 1023 { 1024 - 1025 -((( 1026 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1027 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1028 -))) 1029 - 1030 -((( 1031 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1032 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1033 -))) 1034 - 1035 1035 "vehicleId": "", ~/~/ ID объекта 1036 1036 "name": "", ~/~/ Имя объекта 1037 1037 "imei": "", ~/~/ IMEI объекта ... ... @@ -1057,12 +1057,6 @@ 1057 1057 "forTooltip": true, ~/~/ Отображать в подсказке 1058 1058 "forReport": true ~/~/ Отображать в отчете 1059 1059 } 1060 - ], 1061 - "vehicleGroups": [ ~/~/ Группы ТС 1062 - { 1063 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1064 - "name": "string" ~/~/ Наименование группы ТС 1065 - } 1066 1066 1067 1067 ], ~/~/ Данные с вкладки нормы 1068 1068 "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) ... ... @@ -1113,7 +1113,7 @@ 1113 1113 "type": 0, ~/~/ Тип датчика 1114 1114 "name": "string", ~/~/ Имя датчика 1115 1115 "inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE 1116 - "p arameterName":"string", ~/~/Имяпараметра(взамен связки Input type + port number)1099 + "inputNumber": 0, ~/~/ Номер входа 1117 1117 "pseudonym": "string", ~/~/ Псевдоним 1118 1118 "medianDegree": 0, ~/~/ Медианная фильтрация 1119 1119 "isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл. ... ... @@ -1132,7 +1132,6 @@ 1132 1132 ], 1133 1133 "showInTooltip": true, ~/~/ Отображать в подсказке 1134 1134 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1135 - "color": "string", ~/~/ Код цвета датчиков 1136 1136 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1137 1137 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1138 1138 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1146,31 +1146,27 @@ 1146 1146 "additionalProp3": "string" 1147 1147 }, 1148 1148 1149 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1150 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1151 - { 1152 - "from": 0, ~/~/ С какого значения 1153 - "color": "string", ~/~/ Каким цветом 1154 - "text": "string" ~/~/ Текст подписи к этому интервалу 1155 - } 1156 - ], 1157 - "disableEmissionsValidation": true, ~/~/ Нужно ли валидировать выбросы значений. Применяется для датчиков с типом "Накопительный" 1158 - "unitOfMeasure": 0 ~/~/ Единица измерения значений датчика. (0 - по умолчанию, 1 - секунды, 2 - часы) 1159 - } 1160 - ], 1131 +~/~/ Характерные для произвольного: 1132 +~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1133 +~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1134 +~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1135 +~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1136 +~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1137 +~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1138 +~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1139 +~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1140 +~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1141 +~/~/ "ValueOn": "Вкл.", 1142 +~/~/ "ValueOff": "Выкл." 1143 + "summaryMaxValue": 0 ~/~/ Макс. значение 1144 + } 1161 1161 "drivers": [ ~/~/ Водители 1162 1162 { 1163 1163 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1164 1164 "name": "string", ~/~/ Наименование 1165 - "description": "string", ~/~/ Описание 1166 - "assignments": [ ~/~/ Информация по назначениям 1167 - { 1168 - "beginTime": "2025-10-21T12:28:41.021Z", ~/~/Момент времени начала назначения. 1169 - "endTime": "2025-10-21T12:28:41.021Z", ~/~/ Момент времени окончания назначения. 1170 - "createTime": "2025-10-21T12:28:41.021Z" ~/~/ Момент времени создания назначения. 1149 + "description": "string", 1150 + "isDefault": true ~/~/ По умолчанию 1171 1171 } 1172 - ] 1173 - } 1174 1174 ], 1175 1175 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1176 1176 { ... ... @@ -1194,21 +1194,11 @@ 1194 1194 "date": "2023-05-22T09:57:39.562Z", 1195 1195 "description": "string", 1196 1196 "additionalInfo": "string" 1197 - 1198 - (((1175 + } 1176 + ] 1199 1199 } 1200 - ], 1201 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1202 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1203 1203 ))) 1204 1204 1205 -((( 1206 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1207 -} 1208 - 1209 -))) 1210 -))) 1211 - 1212 1212 (% style="text-align:left" %) 1213 1213 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1214 1214 ... ... @@ -1301,13 +1301,7 @@ 1301 1301 1302 1302 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1303 1303 1304 -(% style="color:#000000" %){ 1305 - 1306 - 1307 -((( 1308 - "vehicleId": 0, ~/~/ ID ТС 1309 -))) 1310 - 1272 +(% style="color:#000000" %){(%%) 1311 1311 "parentId": "" , ~/~/ ID клиента 1312 1312 "name": "" , ~/~/ имя ТС 1313 1313 "imei": "" , ~/~/ IMEI ... ... @@ -1400,7 +1400,6 @@ 1400 1400 ], 1401 1401 "showInTooltip": true, ~/~/ Отображать в подсказке 1402 1402 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1403 - "color": "string", ~/~/ код цвета датчиков 1404 1404 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1405 1405 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1406 1406 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1450,19 +1450,10 @@ 1450 1450 "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1451 1451 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1452 1452 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1453 - 1454 -((( 1455 - } 1456 - ], 1457 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1458 -))) 1459 - 1460 -((( 1461 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1414 + } 1415 + ] 1462 1462 } 1463 -))) 1464 1464 1465 - 1466 1466 (% style="color:#000000" %)Ответ: 1467 1467 1468 1468 ... ... @@ -1571,7 +1571,6 @@ 1571 1571 ], 1572 1572 "showInTooltip": true, ~/~/ Отображение в подсказке 1573 1573 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1574 - "color": "string", ~/~/ код цвета датчиков 1575 1575 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1576 1576 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1577 1577 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -1608,7 +1608,7 @@ 1608 1608 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1609 1609 } 1610 1610 ], 1611 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 -По датчику Моточасов, 2 -По датчику относительных Моточасов1562 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1612 1612 } 1613 1613 ))) 1614 1614 ))) ... ... @@ -1621,6 +1621,77 @@ 1621 1621 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1622 1622 1623 1623 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 +(% class="box infomessage" %) 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 + 1624 1624 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1625 1625 1626 1626 (% class="box infomessage" %) ... ... @@ -1766,6 +1766,7 @@ 1766 1766 "stage": "", ~/~/ Состояние 1767 1767 (% style="color:#000000" %) } 1768 1768 1791 +== == 1769 1769 1770 1770 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1771 1771 ... ... @@ -1842,19 +1842,9 @@ 1842 1842 1843 1843 "drivers": [ ~/~/ Водители 1844 1844 { 1845 - 1846 -((( 1847 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1848 - "inputNumber": 0, ~/~/ № входа. 1849 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1850 - "comment": "string", ~/~/ Комментарий. 1851 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1852 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1853 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1854 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1855 -))) 1856 - 1857 - } 1868 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1869 + "isDefault": true 1870 + } 1858 1858 ], 1859 1859 "commandTemplates": [ ~/~/ Шаблон команды 1860 1860 { ... ... @@ -1890,11 +1890,6 @@ 1890 1890 ], 1891 1891 "showInTooltip": true, ~/~/ Отображать в подсказке 1892 1892 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1893 - 1894 -((( 1895 - "color": "string",** ~/~/ **Цвет датчика 1896 -))) 1897 - 1898 1898 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1899 1899 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1900 1900 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1941,12 +1941,7 @@ 1941 1941 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1942 1942 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1943 1943 } 1944 - 1945 -((( 1946 - ], 1947 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1948 -))) 1949 - 1952 + ] 1950 1950 } 1951 1951 1952 1952 ... ... @@ -2084,11 +2084,6 @@ 2084 2084 ], 2085 2085 "showInTooltip": true, ~/~/ Отображение в подсказке 2086 2086 "showLastValid": true, ~/~/ Отображать последнее валидное значение 2087 - 2088 -((( 2089 - "color": "string", ~/~/ цвет уведомлений 2090 -))) 2091 - 2092 2092 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2093 2093 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2094 2094 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -2382,7 +2382,7 @@ 2382 2382 Тело запроса: 2383 2383 2384 2384 { 2385 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2383 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2386 2386 "vehicleIds": [0], ~/~/ Список ID объектов 2387 2387 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2388 2388 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2405,14 +2405,12 @@ 2405 2405 "motohours": 0, ~/~/ Моточасы за период, секунды 2406 2406 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2407 2407 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2408 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2409 - 2410 2410 } 2411 2411 ] 2412 2412 } 2413 2413 ] 2414 2414 2415 -== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе т оплива транспортнымсредством**(%%) ==2411 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) == 2416 2416 2417 2417 (% class="box infomessage" %) 2418 2418 ((( ... ... @@ -2429,8 +2429,7 @@ 2429 2429 Тело запроса: 2430 2430 2431 2431 { 2432 - 2433 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2428 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2434 2434 "vehicleIds": [0], ~/~/ Список ID объектов 2435 2435 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2436 2436 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2449,12 +2449,8 @@ 2449 2449 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2450 2450 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2451 2451 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2452 - "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2453 - "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2454 2454 "fuelConsumption": 0, ~/~/ Расход топлива 2455 2455 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2456 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2457 - 2458 2458 } 2459 2459 ] 2460 2460 } ... ... @@ -2463,6 +2463,7 @@ 2463 2463 (% class="box warningmessage" %) 2464 2464 ((( 2465 2465 Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2457 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2466 2466 ))) 2467 2467 2468 2468 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == ... ... @@ -2499,21 +2499,12 @@ 2499 2499 "model": "string", ~/~/ Модель объекта 2500 2500 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2501 2501 { 2502 - "event": 0, ~/~/ Тип события 0 - Other, 1 - Engine, 2 - Stop, 3 - FuelIn, 4 - FuelOut, 5 - Garbage, 6 - Grader, 8 - Otval, 9 - Sand, 10 - MixerLand, 11 - MixerMove, 12 - OpenCircuit, 13 - TechSpeed, 14 - Work, 15 - Braid, 16 - Broom, 17 - ReFuller, 18 - Crane, 19 - Power, 20 - TankFuelIn, 21 - TankFuelOut, 22 - BigStop, 23 - OverSpeed, 24 - Unloading, 25 - Warning, 26 - GarbageWork, 27 - Custom, 28 - CustomWork, 29 - GNSS, 30 - GrainIn, 31 - GrainOut, 32 - WeighingTerminal, 33 - Stopping, 34 - FertilizerWork, 35 - FertilizerRefueling 2503 - 2504 -((( 2494 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2505 2505 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2506 2506 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2507 2507 "valueFuel": 0, ~/~/ Количество 2508 2508 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2509 2509 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2510 -))) 2511 - 2512 -((( 2513 - "latitude": 0, ~/~/ Широта. 2514 - "longitude": 0 ~/~/ Долгота. 2515 -))) 2516 - 2517 2517 } 2518 2518 ] 2519 2519 } ... ... @@ -2587,241 +2587,194 @@ 2587 2587 В заголовках запроса: X-Auth: Токен авторизации 2588 2588 2589 2589 2590 -В массивеуказываемid объектов через запятую2573 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2591 2591 2592 2592 Ответ: 2593 - 2594 -[ 2595 2595 { 2596 - "vehicleId": 55728, ~/~/Идентификатор объекта2597 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",~/~/Guidобъекта2598 - "vehicleNumber": " 0105 КМ",~/~/Номер объекта2599 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",~/~/Время идатапоступления данных2600 - "recordTime": "202 5-06-27T12:37:19Z",~/~/Время идатаформированиеданных2601 - "state": 4,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.2602 - "speed": 31,~/~/Скорость объекта2603 - "course": 116,~/~/Курс движения [0;360]2604 - "latitude": 45.722128,~/~/Широта [-90°;90°].2605 - "longitude": 39.800432,~/~/Долгота [-180°;180°].2606 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/Адрес2607 - "geozones": [ ~/~/ Сведения по геозонам.2577 + "vehicleId": 0, ~/~/Идентификатор объекта. 2578 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2579 + "vehicleNumber": "string",~/~/Номер объекта. 2580 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2581 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2582 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2583 + "speed": 0,~/~/Скорость объекта. 2584 + "course": 0,~/~/Курс движения [0;360] 2585 + "latitude": 0,~/~/Широта [-90°;90°]. 2586 + "longitude": 0,~/~/Долгота [-180°;180°]. 2587 + "address": "string",~/~/Адрес. 2588 + "geozones": [ ~/~/Сведения по геозонам. 2608 2608 { 2609 - "id": 10225647, ~/~/ ID Геозоны 2610 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2611 - }, 2612 - { 2613 - "id": 10282875, ~/~/ ID Геозоны 2614 - "name": "Ё2" ~/~/ Наименование геозоны 2615 - }, 2616 - { 2617 - "id": 10226240, ~/~/ ID Геозоны 2618 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2619 - }, 2620 - { 2621 - "id": 9747869, ~/~/ ID Геозоны 2622 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2623 - }, 2624 - { 2625 - "id": 10221123, ~/~/ ID Геозоны 2626 - "name": "53r" ~/~/ Наименование геозоны 2627 - }, 2628 - { 2629 - "id": 10197638, ~/~/ ID Геозоны 2630 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2590 + "id": 0, 2591 + "name": "string" 2631 2631 } 2632 - ] 2633 - } 2634 2634 2635 2635 2636 -= = 2595 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2637 2637 2638 -= (% style="color:#000000; font-size:1 8.6667px" %)Раздел:**Уведомления**(%%) =2597 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2639 2639 2640 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2641 - 2642 2642 (% class="box infomessage" %) 2643 2643 ((( 2644 -**POST /api/v3/ notifications/find**2601 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2645 2645 ))) 2646 2646 2647 -Метод возвращаетинформациюобуведомлениях переданногоклиента иегоклиентов нижепо иерархии.2604 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2648 2648 2649 -(% style="text-align: left;" %) 2650 -Метод запроса **POST** 2606 +(% style="color:#000000" %)Метод запроса: **POST** 2651 2651 2652 -(% style="text-align: left;" %) 2653 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2608 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2654 2654 2655 -(% style="text-align: left;" %) 2656 2656 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2657 2657 2612 +(% style="text-align:left" %) 2613 +Тело запроса: 2614 + 2615 +(% style="text-align:left" %) 2658 2658 { 2659 - "parentId": "" ~/~/ id клиента2617 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2660 2660 } 2661 2661 2620 +(% style="text-align:left" %) 2662 2662 Ответ: 2663 2663 2664 2664 [ 2665 2665 { 2666 - "id": 0, ~/~/ ID уведомления 2667 - "name": "string", ~/~/ Название уведомления 2668 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 2669 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2670 - "userId": "", ~/~/ Пользователь, создавший уведомление 2671 - "parentId": "", ~/~/ Идентификатор клиента 2672 - "parentName": "string" ~/~/ Имя клиента 2625 + "id": 0, ~/~/ Идентификатор объекта геозоны 2626 + "name": "string", ~/~/ Название объекта геозоны 2627 + "type": 0, ~/~/ Тип объекта геозоны 2628 + "fname": "string", ~/~/ Имя файла 2629 + "parentId": "string", ~/~/ Идентификатор клиента 2630 + "radius": 0, ~/~/ Радиус геообъекта 2631 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2632 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2633 + "description": "string", ~/~/ Описание 2634 + "area": 0, ~/~/ Площадь, м^^2^^ 2635 + "perimetr": 0, ~/~/ Периметр, м 2636 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2673 2673 } 2674 2674 ] 2675 2675 2640 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2676 2676 2677 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2678 - 2679 2679 (% class="box infomessage" %) 2680 2680 ((( 2681 -**POST /api/v3/ notifications**2644 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2682 2682 ))) 2683 2683 2684 -Метод з апроса**POST**2647 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2685 2685 2686 -(% style="text-align: left;" %) 2687 -(% style="color:#000000" %)Пример запроса 2649 +(% style="color:#000000" %)Метод запроса: **POST** 2688 2688 2689 -((( 2651 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2652 + 2653 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2654 + 2655 +(% style="text-align:left" %) 2656 +Тело запроса: 2657 + 2690 2690 { 2691 - "id": 0, ~/~/ ID правила 2692 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2693 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2694 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2695 - "name": "string", ~/~/ Имя правила 2696 - "active": true, ~/~/ Активность правила 2697 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2698 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2699 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2700 - ], 2701 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2702 - 0 2703 - ], 2704 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2705 - 0 2706 - ], 2707 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2708 - 0 2709 - ], 2710 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2711 - "additionalProp1": "string", 2712 - "additionalProp2": "string", 2713 - "additionalProp3": "string" 2714 - }, 2715 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2716 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2717 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2718 - ], 2719 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2720 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2721 - "string" 2722 - ], 2723 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2724 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2725 - { 2726 - "id": 0, ~/~/ Идентификатор участника чата. 2727 - "info": "string" ~/~/ Дополнительные сведения. 2728 - } 2729 - ], 2730 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2731 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2732 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2733 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2734 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2735 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2736 - "timezone": 0, ~/~/ часовой пояс 2737 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2738 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2739 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2740 - { 2741 - "type": 0, ~/~/ 0 - Нет, 1 - Превышение скорости, 2 - Вход в геозону, 3 - выход из геозоны, 4 - Паническая активация, 5 - Дискретный датчик, 6 - Отключение дискретного датчика, 7 - Работа аналогового датчика, 8 - Отсутствуют данные, 9 - Отсутствуют координаты, 10 - Бездействие, 11 - Адрес объекта, 12 - Заканчивается топливо, 13 - Заправка, 14 - Превышение скорости, 15 - Превышение скорости, 16 - Превышение нормы, 17 - Возврат к бездействию, 18 - Адрес объекта, 19 - Отсутствуют данные, 20 - отсутствуют координаты, 21 - Запланировано техническое обслуживание автомобиля, 22 - Требуется техническое обслуживание автомобиля, 23 - Техническое обслуживание автомобиля завершено, 24 - Открыто назначение водителя, 25 - Закрыто назначение водителя, 255 - Срок действия правила истек 2742 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2743 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2744 - "additionalProp1": "string", 2745 - "additionalProp2": "string", 2746 - "additionalProp3": "string" 2747 - } 2748 - } 2749 - ] 2659 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2660 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2661 + "ids": [ ], ~/~/ Массив id объектов 2662 + "byTime": 0, ~/~/ Объединение событий по времени 2663 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2664 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2665 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2750 2750 } 2751 -))) 2752 2752 2668 +Ответ: 2669 +[ 2670 + { 2671 + "geozoneId": 0, ~/~/ ID геообъекта 2672 + "geozoneName": "string", ~/~/ Название геообъекта 2673 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2674 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2675 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2676 + "vehicleId": 0, ~/~/ ID объекта 2677 + "vehicleName": "string" ~/~/ Имя объекта 2678 + } 2679 +] 2680 + 2681 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2682 + 2683 +(% class="box infomessage" %) 2753 2753 ((( 2754 - 2685 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2755 2755 ))) 2756 2756 2688 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2689 + 2690 +(% style="color:#000000" %)Метод запроса: **POST** 2691 + 2692 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2693 + 2694 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2695 + 2696 +(% style="text-align:left" %) 2697 +Тело запроса: 2698 + 2699 +{ 2700 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2701 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2702 + "ids": [ ], ~/~/ Массив id геообъектов 2703 + "byTime": 0, ~/~/ Объединение событий по времени 2704 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2705 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2706 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2707 +} 2708 + 2709 +Ответ: 2710 + 2711 +[ 2712 + { 2713 + "geozoneId": 0, ~/~/ ID геообъекта 2714 + "geozoneName": "string", ~/~/ Название геообъекта 2715 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2716 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2717 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2718 + "vehicleId": 0, ~/~/ ID объекта 2719 + "vehicleName": "string" ~/~/ Имя объекта 2720 + } 2721 +] 2722 + 2723 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2724 + 2725 +== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2726 + 2727 +(% class="box infomessage" %) 2757 2757 ((( 2758 - 2729 +**POST /api/v3/notifications/find** 2759 2759 ))) 2760 2760 2761 - Ответ:2732 +Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 2762 2762 2734 +(% style="text-align: left;" %) 2735 +Метод запроса **POST** 2736 + 2737 +(% style="text-align: left;" %) 2738 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2739 + 2740 +(% style="text-align: left;" %) 2741 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2742 + 2763 2763 { 2764 - "id": 0, ~/~/ ID правила 2765 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2766 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2767 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2768 - "name": "string", ~/~/ Имя правила 2769 - "active": true, ~/~/ Активность правила 2770 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2771 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2772 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2773 - ], 2774 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2775 - 0 2776 - ], 2777 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2778 - 0 2779 - ], 2780 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2781 - 0 2782 - ], 2783 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2784 - "additionalProp1": "string", 2785 - "additionalProp2": "string", 2786 - "additionalProp3": "string" 2787 - }, 2788 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2789 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2790 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2791 - ], 2792 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2793 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2794 - "string" 2795 - ], 2796 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2797 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2798 - { 2799 - "id": 0, ~/~/ Идентификатор участника чата. 2800 - "info": "string" ~/~/ Дополнительные сведения. 2801 - } 2802 - ], 2803 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2804 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2805 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2806 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2807 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2808 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2809 - "timezone": 0, ~/~/ часовой пояс 2810 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2811 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2812 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2813 - { 2814 - "type": 0, ~/~/ 0 - Нет, 1 - Превышение скорости, 2 - Вход в геозону, 3 - выход из геозоны, 4 - Паническая активация, 5 - Дискретный датчик, 6 - Отключение дискретного датчика, 7 - Работа аналогового датчика, 8 - Отсутствуют данные, 9 - Отсутствуют координаты, 10 - Бездействие, 11 - Адрес объекта, 12 - Заканчивается топливо, 13 - Заправка, 14 - Превышение скорости, 15 - Превышение скорости, 16 - Превышение нормы, 17 - Возврат к бездействию, 18 - Адрес объекта, 19 - Отсутствуют данные, 20 - отсутствуют координаты, 21 - Запланировано техническое обслуживание автомобиля, 22 - Требуется техническое обслуживание автомобиля, 23 - Техническое обслуживание автомобиля завершено, 24 - Открыто назначение водителя, 25 - Закрыто назначение водителя, 255 - Срок действия правила истек 2815 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2816 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2817 - "additionalProp1": "string", 2818 - "additionalProp2": "string", 2819 - "additionalProp3": "string" 2820 - } 2821 - } 2822 - ] 2744 + "parentId": "" ~/~/ id клиента 2823 2823 } 2824 2824 2747 +Ответ: 2748 + 2749 +[ 2750 + { 2751 + "id": 0, ~/~/ ID уведомления 2752 + "name": "string", ~/~/ Название уведомления 2753 + "active": true, ~/~/ Состояние true - активен, false - деактивирован 2754 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2755 + "userId": "", ~/~/ Пользователь, создавший уведомление 2756 + "parentId": "", ~/~/ Идентификатор клиента 2757 + "parentName": "string" ~/~/ Имя клиента 2758 + } 2759 +] 2760 + 2825 2825 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2826 2826 2827 2827 (% class="box infomessage" %) ... ... @@ -4039,12 +4039,16 @@ 4039 4039 Тело запроса: 4040 4040 4041 4041 { 4042 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4043 - "Balance": 0 ~/~/ Значение баланса.3978 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3979 + "Balance": 0 4044 4044 } 4045 4045 4046 4046 Ответ: Success 4047 4047 3984 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3985 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3986 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3987 + 4048 4048 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4049 4049 4050 4050 (% class="box warningmessage" %) ... ... @@ -4056,29 +4056,16 @@ 4056 4056 4057 4057 Тело запроса: 4058 4058 4059 -((( 4060 4060 { 4061 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4062 - "a mount": 0~/~/ Сумма пополнения баланса4000 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4001 + "Balance": 0 4063 4063 } 4064 -))) 4065 4065 4066 -((( 4067 - 4068 -))) 4069 - 4070 4070 Ответ: Success 4071 4071 4072 -((( 4073 -{ 4074 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4075 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4076 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4077 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4078 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4079 - "Description": "string" ~/~/ Описание корректировки. 4080 -} 4081 -))) 4006 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4007 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4008 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4082 4082 4083 4083 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4084 4084 ... ... @@ -4091,25 +4091,16 @@ 4091 4091 4092 4092 Тело запроса: 4093 4093 4094 -((( 4095 4095 { 4096 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4097 - "a mount": 0~/~/ Сумма списания с баланса4022 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4023 + "Balance": 0 4098 4098 } 4099 -))) 4100 4100 4101 4101 Ответ: Success 4102 4102 4103 -((( 4104 -{ 4105 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4106 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4107 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4108 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4109 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4110 - "Description": "string" ~/~/ Описание корректировки 4111 -} 4112 -))) 4028 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4029 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4030 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4113 4113 4114 4114 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4115 4115 ... ... @@ -4120,35 +4120,28 @@ 4120 4120 4121 4121 Тело запроса: 4122 4122 4123 -((( 4124 4124 { 4125 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4126 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4127 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4128 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4129 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4130 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4042 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4043 + "CalculationType": 0, 4044 + "PermissibleBalance": 0, 4045 + "DefermentDays": 0, 4046 + "SendUiNotifications": true, 4047 + "SendEmailNotifications": true, 4048 + "IsPrivate": true, 4131 4131 } 4132 -))) 4133 4133 4134 -((( 4135 - 4136 -))) 4137 - 4138 4138 Ответ: Success 4139 4139 4140 -((( 4141 -{ 4142 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4143 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4144 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4145 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4146 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4147 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4148 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4149 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4150 -} 4053 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4054 +|ClientId|Идентификатор клиента 4055 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4056 +|PermissibleBalance|Допустимый баланс 4057 +|DefermentDays|((( 4058 +Отсрочка, количество дней 4151 4151 ))) 4060 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4061 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4062 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4152 4152 4153 4153 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4154 4154 ... ... @@ -4160,68 +4160,35 @@ 4160 4160 Тело запроса: 4161 4161 4162 4162 { 4163 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4164 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4165 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4074 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4075 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4076 + "Features": [ 4166 4166 { 4167 - "Feature": "string", ~/~/ Код услуги.4168 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4169 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4170 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4171 - "Price": 0, ~/~/ Цена за единицу.4172 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4173 - "PeriodValue": 0, ~/~/ Значение периода.4174 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)4078 + "Feature": "string", 4079 + "IsEnabled": true, 4080 + "IsFactual": true, 4081 + "Limit": 0, 4082 + "Price": 0, 4083 + "DebitDate": "2023-10-18T13:26:58.987Z", 4084 + "PeriodValue": 0, 4085 + "PeriodType": 0 4175 4175 } 4176 4176 ] 4177 4177 } 4178 4178 4179 - 4180 4180 Ответ: Success 4181 4181 4182 -((( 4183 -{ 4184 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4185 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4186 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4187 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4188 - "Name": "string", ~/~/ Наименование. 4189 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4190 - "Constraint": { ~/~/ Ограничения по тарифу 4191 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4192 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4193 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4194 - }, 4195 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4196 - { 4197 - "Feature": "string", ~/~/Код услуги. 4198 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4199 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4200 - "Price": 0, ~/~/ Цена за единицу. 4201 - "PeriodValue": 0, ~/~/ Значение периода. 4202 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4203 - } 4204 - ], 4205 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4206 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4207 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4208 - }, 4209 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4210 - { 4211 - "Feature": "string", ~/~/ Код услуги. 4212 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4213 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4214 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4215 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4216 - "Price": 0, ~/~/ Цена за единицу. 4217 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4218 - "PeriodValue": 0, ~/~/ Значение периода. 4219 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4220 - "Quantity": 0 ~/~/ Количество использования услуги. 4221 - } 4222 - ] 4223 -} 4224 -))) 4092 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4093 +|ClientId|Идентификатор клиента 4094 +|PlanId|Идентификатор тарифного плана 4095 +|Feature|Код услуги 4096 +|IsEnabled|Признак, определяющий активирована ли услуга 4097 +|IsFactual|Признак, определяющий расчёт по факту 4098 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4099 +|Price|Цена за единицу. 4100 +|DebitDate|Следующий момент времени списания с баланса за услугу. 4101 +|PeriodValue|Значение периода. 4102 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4225 4225 4226 4226 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4227 4227 ... ... @@ -4326,43 +4326,6 @@ 4326 4326 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4327 4327 |msgCount|Кол-во обработанных сообщений всего 4328 4328 4329 -== **Импортировать историю ТС (Асинхронный запрос)** == 4330 - 4331 -(% class="box successmessage" %) 4332 -((( 4333 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4334 -))) 4335 - 4336 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4337 - 4338 -Метод запроса: **POST** 4339 - 4340 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4341 - 4342 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4343 - 4344 - 4345 -Ответ: 4346 - 4347 -{ 4348 - 4349 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4350 - 4351 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4352 - 4353 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4354 - 4355 - "Message": "string", ~/~/ Информация о выполнении запроса 4356 - 4357 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4358 - 4359 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4360 - 4361 - "Data": "string" ~/~/ Данные 4362 - 4363 -} 4364 - 4365 - 4366 4366 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4367 4367 4368 4368 (% class="box infomessage" %) ... ... @@ -4380,59 +4380,10 @@ 4380 4380 "message": "string" 4381 4381 } 4382 4382 4383 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4384 -**Параметр** 4385 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4386 -**Описание** 4387 -))) 4388 -|((( 4389 -activity 4390 -)))|((( 4391 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4392 -))) 4393 -|((( 4394 -progress 4395 -)))|((( 4396 -Guid ТС 4397 -))) 4224 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4225 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4226 +|progress|Guid ТС 4398 4398 4399 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4400 - 4401 -(% class="box infomessage" %) 4402 -((( 4403 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4404 -))) 4405 - 4406 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4407 - 4408 -Метод запроса: **GET** 4409 - 4410 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4411 - 4412 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4413 - 4414 - 4415 -Ответ: 4416 - 4417 -{ 4418 - 4419 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4420 - 4421 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4422 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4423 - 4424 - "Message": "string", ~/~/ Информация о выполнении запроса 4425 - 4426 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4427 - 4428 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4429 - 4430 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4431 - 4432 - "Data": "string" ~/~/ Данные 4433 - 4434 -} 4435 - 4436 4436 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4437 4437 4438 4438 (% class="box infomessage" %) ... ... @@ -4591,7 +4591,7 @@ 4591 4591 4592 4592 (% class="box infomessage" %) 4593 4593 ((( 4594 - **POST /api/v3/fuelcards/transactions**4386 +POST /api/v3/fuelcards/transactions 4595 4595 ))) 4596 4596 4597 4597 Метод запроса: POST ... ... @@ -4602,59 +4602,34 @@ 4602 4602 Параметры в теле запроса (JSON): 4603 4603 4604 4604 { 4605 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ Начало периода4606 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ Конец периода4397 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4398 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4607 4607 "ids": [ 4608 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторытопливных карт4400 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4609 4609 ], 4610 - "timezone": 0 ~/~/ Часовойпояс4402 + "timezone": 0 ~/~/Таймзона 4611 4611 } 4612 4612 4613 4613 4614 4614 Ответ: 4615 4615 { 4616 - "date": "2024-04-11T10:41:02.265Z", ~/~/ Дата и время транзакции4617 - "driver": "string", ~/~/ Водители, привязанные к ТК4618 - "object": "string", ~/~/ Наименование ТС4619 - "amount": 0, ~/~/ Количество топлива4620 - "amountDut": 0, ~/~/ Количество по ДУТ4621 - "amountDiff": 0, ~/~/ Разница, л4622 - "amountDiffPerc": 0, ~/~/ Разница, %4623 - "summa": 0, ~/~/ Стоимость, руб4624 - "serviceName": "string", ~/~/ Тип топлива4625 - "price": 0, ~/~/ Цена за литр, руб4626 - "cardName": "string", ~/~/ Наименование ТК4627 - "cardNum": "string", ~/~/ Номер ТК4628 - "operator": "string", ~/~/ Оператор ТК4629 - "address": "string" ~/~/ Адрес АЗС4408 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4409 + "driver": "string", ~/~/Водители, привязанные к ТК 4410 + "object": "string", ~/~/Наименование ТС 4411 + "amount": 0, ~/~/Количество топлива 4412 + "amountDut": 0, ~/~/Количество по ДУТ 4413 + "amountDiff": 0, ~/~/Разница, л 4414 + "amountDiffPerc": 0, ~/~/Разница, % 4415 + "summa": 0, ~/~/Стоимость, руб 4416 + "serviceName": "string", ~/~/Тип топлива 4417 + "price": 0, ~/~/Цена за литр, руб 4418 + "cardName": "string", ~/~/Наименование ТК 4419 + "cardNum": "string", ~/~/Номер ТК 4420 + "operator": "string", ~/~/Оператор ТК 4421 + "address": "string" ~/~/Адрес АЗС 4630 4630 } 4631 4631 4632 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4633 4633 4634 -(% class="box infomessage" %) 4635 -((( 4636 -**GET /api/v3/fuelcards** 4637 -))) 4638 - 4639 -Метод запроса: GET 4640 - 4641 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4642 - 4643 -Ответ: 4644 - 4645 -[ 4646 - { 4647 - "Name": "string", ~/~/ Определяет наименование карты. 4648 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4649 - "Number": "string", ~/~/ Определяет № карты. 4650 - "Enabled": true, ~/~/ Определяет признак активности карты. 4651 - "Description": "string", ~/~/ Определяет описание карты. 4652 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4653 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4654 - "deleted": true ~/~/ Признак удаления 4655 - } 4656 -] 4657 - 4658 4658 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4659 4659 4660 4660 ... ... @@ -4665,7 +4665,7 @@ 4665 4665 **GET ** **/api/v3/retranslations/{id}** 4666 4666 ))) 4667 4667 4668 - id -Идентификаторретранслятора4435 +Идентификатор запроса: ID 4669 4669 4670 4670 4671 4671 Пример ответа: ... ... @@ -4697,7 +4697,7 @@ 4697 4697 **DELETE** **/api/v3/retranslations/{id}** 4698 4698 ))) 4699 4699 4700 - id-Идентификатор ретранслятора4467 +Параметр запроса: ID - Идентификатор ретранслятора 4701 4701 4702 4702 4703 4703 == **Создание ретранслятора** == ... ... @@ -4807,8 +4807,8 @@ 4807 4807 4808 4808 { 4809 4809 "id": "", ~/~/ Идентификатор ретранслятора 4810 -"search": "string", ~/~/ Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу4811 -"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (о бязательныйпараметр).4577 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4578 +"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (вышестоящего клиента). 4812 4812 } 4813 4813 4814 4814 Ответ: ... ... @@ -4833,7 +4833,7 @@ 4833 4833 4834 4834 (% class="box infomessage" %) 4835 4835 ((( 4836 - **POST /api/v3/Reports/harvesterUnloading**4603 +POST **/api/v3/Reports/harvesterUnloading** 4837 4837 ))) 4838 4838 4839 4839 Пример запроса: ... ... @@ -4905,743 +4905,7 @@ 4905 4905 ] 4906 4906 4907 4907 4908 -== **Отчет трек-датчики** == 4909 - 4910 -(% class="box infomessage" %) 4911 -((( 4912 -**POST /api/v3/Reports/sensorsWorks** 4913 -))) 4914 - 4915 -**Пример запроса:** 4916 - 4917 -{ 4918 - "vehicleIds": [ ~/~/ Список ID объектов 4919 - 0 4920 - ], 4921 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4922 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4923 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4924 -} 4925 - 4926 -**Пример ответа:** 4927 - 4928 -((( 4929 -{ 4930 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4931 - { 4932 - "vehicleId": 0, ~/~/ Идентификатор ТС 4933 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4934 - { 4935 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4936 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4937 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4938 - "name": "string", ~/~/ Наименование оборудования. 4939 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4940 - "totalMileage": 0, ~/~/ Общий пробег. 4941 - "avgSpeed": 0 ~/~/ Средняя скорость. 4942 - } 4943 - ] 4944 - } 4945 - ] 4946 -} 4947 - 4948 - 4949 -== **Превышение скорости** == 4950 - 4951 -(% class="box infomessage" %) 4952 -((( 4953 -**POST /api/v3/Reports/overSpeedDuration** 4954 -))) 4955 - 4956 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 4957 - 4958 -Пример запроса: 4959 - 4960 -((( 4961 -{ 4962 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 4963 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 4964 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 4965 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4966 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 4967 -} 4968 -))) 4969 - 4970 -((( 4971 - 4972 -))) 4973 - 4974 -((( 4975 -Пример ответа: 4976 -))) 4977 - 4978 -((( 4979 -((( 4980 -[ 4981 - { 4982 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 4983 - "duration": 0, ~/~/ Продолжительность события в секундах 4984 - "maxSpeed": 0, ~/~/ Максимальная скорость 4985 - "speedLimit": 0 ~/~/ Ограничение скорости 4986 - } 4987 -] 4988 -))) 4989 -))) 4990 -))) 4991 - 4992 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4993 - 4994 - 4995 -== **Запрос списка полей** == 4996 - 4997 -(% class="box successmessage" %) 4998 -((( 4999 -**POST /api/v3/agroLands/find** 5000 -))) 5001 - 5002 -Пример запроса: 5003 - 5004 -((( 5005 -((( 5006 -((( 5007 -{ 5008 - "year": 0, ~/~/ Фильтр по году 5009 - "name": "string", ~/~/ Фильтр по названию 5010 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 5011 -} 5012 -))) 5013 -))) 5014 - 5015 - 5016 -))) 5017 - 5018 -Пример ответа: 5019 - 5020 -((( 5021 -[ 5022 - { 5023 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5024 - "year": 0, ~/~/ Год поля 5025 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 5026 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 5027 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5028 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5029 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5030 - "counts": { ~/~/ Счётчики с/х поля 5031 - "fieldOperations": 0, ~/~/ Количество операций на поле 5032 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5033 - "facts": 0 ~/~/ Счётчик факта 5034 - }, 5035 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5036 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5037 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5038 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5039 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5040 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5041 - "planComment": "string", ~/~/ Комментарий к полю 5042 - "productivity": 0, ~/~/ Урожайность. 5043 - "id": 0, ~/~/ Идентификатор объекта геозоны 5044 - "name": "string", ~/~/ Название объекта геозоны 5045 - "type": 0, ~/~/ Тип объекта геозоны 5046 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5047 - "fname": "string", ~/~/ Имя файла 5048 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5049 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 5050 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 5051 - "description": "string", ~/~/ Описание объекта геозоны 5052 - "area": 0, ~/~/ Площадь, м2 5053 - "perimetr": 0, ~/~/ Периметр, м 5054 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 5055 - } 5056 -] 5057 - 5058 - 5059 -== **Создание нового поля ** == 5060 - 5061 -(% class="box successmessage" %) 5062 -((( 5063 -**POST /api/v3/agroLands** 5064 -))) 5065 - 5066 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 5067 -X-agent - ID клиента 5068 - 5069 -Пример запроса: 5070 - 5071 -((( 5072 -{ 5073 - "extId": "string", 5074 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля 5075 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля 5076 - "display": "string", ~/~/ Настройки отображения 5077 - "year": 0, ~/~/ Год поля 5078 - "name": "string", ~/~/ Наименование 5079 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5080 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая 5081 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая 5082 - "planComment": "string", ~/~/ Комментарий к полю 5083 - "cropRotations": [ ~/~/ Данные по севообороту 5084 - { 5085 - "landId": 0, ~/~/ ID поля 5086 - "landName": "string", ~/~/ Название поля 5087 - "year": 0, ~/~/ Год урожая 5088 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5089 - "cultureName": "string", ~/~/ Название культуры 5090 - "productivity": 0, ~/~/ Урожайность 5091 - "area": 0, ~/~/ Площадь поля, Га 5092 - "total": 0, ~/~/ Валовый сбор 5093 - "productivityFact": 0, ~/~/ Фактическая урожайность 5094 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5095 - "totalFact": 0, ~/~/ Фактический валовый сбор 5096 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ 5097 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева 5098 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая 5099 - "isyearplan": true, ~/~/ Годовой план 5100 - "comment": "string" ~/~/ Комментарий 5101 - } 5102 - ] 5103 -} 5104 -))) 5105 - 5106 -((( 5107 - 5108 -))) 5109 - 5110 -Пример ответа: 5111 - 5112 -((( 5113 -((( 5114 -{ 5115 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5116 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5117 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5118 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5119 - "cropRotations": [ ~/~/ Данные по севообороту 5120 - { 5121 - "landId": 0, ~/~/ ID поля 5122 - "landName": "string", ~/~/ Название поля 5123 - "year": 0, ~/~/ Год урожая 5124 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5125 - "cultureName": "string", ~/~/ Название культуры 5126 - "productivity": 0, ~/~/ Урожайность 5127 - "area": 0, ~/~/ Площадь поля, Га. 5128 - "total": 0, ~/~/ Валовый сбор 5129 - "productivityFact": 0, ~/~/ Фактическая урожайность 5130 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5131 - "totalFact": 0, ~/~/ Фактический валовый сбор 5132 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ 5133 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева 5134 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая 5135 - "isyearplan": true, ~/~/ годовой план 5136 - "comment": "string" ~/~/ Комментарий 5137 - } 5138 - ], 5139 - "cropVegetation": [ ~/~/ История вегетации поля 5140 - { 5141 - "values": [ ~/~/ Данные вегетации и состояния посева 5142 - { 5143 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5144 - "ndvi": 0 ~/~/ Индекс вегетации 5145 - } 5146 - ], 5147 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5148 - { 5149 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5150 - "type": "string", ~/~/ Тип 5151 - "pictureid": "string" ~/~/ Идентификатор ресурса 5152 - } 5153 - ], 5154 - "states": [ ~/~/ Ключевые даты развития поля 5155 - { 5156 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5157 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5158 - } 5159 - ] 5160 - } 5161 - ], 5162 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая 5163 - "counts": { 5164 - "fieldOperations": 0, ~/~/ Количество операций на поле 5165 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5166 - "facts": 0 ~/~/ Счётчик факта 5167 - }, 5168 - "planComment": "string", ~/~/ Комментарий к полю 5169 -))) 5170 - 5171 -((( 5172 - "productivity": 0, ~/~/ Урожайность. 5173 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5174 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая 5175 - "year": 0, ~/~/ Год поля 5176 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5177 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5178 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5179 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5180 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто 5181 - "id": 0, ~/~/ Идентификатор объекта геозоны 5182 - "name": "string", ~/~/ Название объекта геозоны 5183 - "type": 0, ~/~/ Тип объекта геозоны 5184 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5185 - "fname": "string", ~/~/ Имя файла 5186 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5187 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны 5188 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны 5189 - "description": "string", ~/~/ Описание объекта геозоны 5190 - "area": 0, ~/~/ Площадь, м2 5191 - "perimetr": 0, ~/~/ Периметр, м 5192 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5193 -} 5194 - 5195 - 5196 -))) 5197 -))) 5198 -))) 5199 - 5200 -== **Получение поля по id** == 5201 - 5202 -(% class="box infomessage" %) 5203 -((( 5204 -**GET /api/v3/agroLands/{id}** 5205 -))) 5206 - 5207 -Пример запроса: 5208 -id ~/~/ Идентификатор поля 5209 - 5210 -Пример ответа: 5211 - 5212 -((( 5213 -{ 5214 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5215 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5216 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5217 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5218 - "cropRotations": [ ~/~/ Данные по севообороту 5219 - { 5220 - "landId": 0, ~/~/ ID поля 5221 - "landName": "string", ~/~/ Название поля 5222 - "year": 0, ~/~/ Год урожая 5223 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5224 - "cultureName": "string", ~/~/ Название культуры 5225 - "productivity": 0, ~/~/ Урожайность 5226 - "area": 0, ~/~/ Площадь поля, Га 5227 - "total": 0, ~/~/ Валовый сбор 5228 - "productivityFact": 0, ~/~/ Фактическая урожайность 5229 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5230 - "totalFact": 0, ~/~/ Фактический валовый сбор 5231 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5232 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5233 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5234 - "isyearplan": true, ~/~/ План года 5235 - "comment": "string" ~/~/ Комментарий 5236 - } 5237 - ], 5238 - "cropVegetation": [ ~/~/ История вегетации поля 5239 - { 5240 - "values": [ ~/~/ Данные вегетации и состояния посева 5241 - { 5242 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5243 - "ndvi": 0 ~/~/ Индекс вегетации 5244 - } 5245 - ], 5246 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5247 - { 5248 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5249 - "type": "string", ~/~/ Тип 5250 - "pictureid": "string" ~/~/ Идентификатор ресурса 5251 - } 5252 - ], 5253 - "states": [ ~/~/ Ключевые даты развития поля 5254 - { 5255 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5256 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5257 - } 5258 - ] 5259 - } 5260 - ], 5261 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5262 - "counts": { 5263 - "fieldOperations": 0, ~/~/ Количество операций на поле 5264 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5265 - "facts": 0 ~/~/ Счётчик факта 5266 - }, 5267 - "planComment": "string", ~/~/ Комментарий к полю 5268 - "productivity": 0, ~/~/ Урожайность. 5269 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5270 -))) 5271 - 5272 -((( 5273 -((( 5274 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5275 - "year": 0, ~/~/ Год поля 5276 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5277 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5278 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5279 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5280 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5281 - "id": 0, ~/~/ Идентификатор объекта геозоны 5282 - "name": "string", ~/~/ Название объекта геозоны 5283 - "type": 0, ~/~/ Тип объекта геозоны 5284 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5285 - "fname": "string", ~/~/ Имя файла 5286 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5287 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5288 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5289 - "description": "string", ~/~/ Описание объекта геозоны 5290 - "area": 0, ~/~/ Площадь, м2 5291 - "perimetr": 0, ~/~/ Периметр, м 5292 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5293 -} 5294 -))) 5295 - 5296 - 5297 -((( 5298 -((( 5299 -((( 5300 -== **Изменение поля** == 5301 - 5302 -(% class="box infomessage" %) 5303 -((( 5304 -**PUT /api/v3/agroLands** 5305 -))) 5306 - 5307 -Пример запроса: 5308 - 5309 -((( 5310 -((( 5311 -{ 5312 - "id": 0, ~/~/ Идентификатор поля 5313 - "extId": "string", ~/~/ ExtId 5314 - "shape": "string", ~/~/ Форма поля 5315 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5316 - "display": "string", ~/~/ Настройки отображения 5317 - "year": 0, ~/~/ Год поля 5318 - "name": "string", ~/~/ Наименование 5319 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5320 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая 5321 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая 5322 - "planComment": "string", ~/~/Комментарий к полю 5323 - "cropRotations": [ ~/~/ Данные по севообороту 5324 - { 5325 - "landId": 0, ~/~/ ID поля 5326 - "landName": "string", ~/~/ Название поля 5327 - "year": 0, ~/~/ Год урожая 5328 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5329 - "cultureName": "string", ~/~/ Название культуры 5330 - "productivity": 0, ~/~/ Урожайность 5331 - "area": 0, ~/~/ Площадь поля, Га. 5332 - "total": 0, ~/~/ Валовый сбор 5333 - "productivityFact": 0, ~/~/ Фактическая урожайность 5334 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5335 - "totalFact": 0, ~/~/ Фактический валовый сбор 5336 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ 5337 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева 5338 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая 5339 - "isyearplan": true, 5340 - "comment": "string" ~/~/ Комментарий 5341 - } 5342 - ], 5343 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику 5344 -} 5345 -))) 5346 -))) 5347 - 5348 -((( 5349 - 5350 -))) 5351 - 5352 -Пример ответа: 5353 - 5354 -((( 5355 -((( 5356 -((( 5357 -{ 5358 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5359 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5360 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5361 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5362 - "cropRotations": [ ~/~/ Данные по севообороту 5363 - { 5364 - "landId": 0, ~/~/ ID поля 5365 - "landName": "string", ~/~/ Название поля 5366 - "year": 0, ~/~/ Год урожая 5367 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5368 - "cultureName": "string", ~/~/ Название культуры 5369 - "productivity": 0, ~/~/ Урожайность 5370 - "area": 0, ~/~/ Площадь поля, Га 5371 - "total": 0, ~/~/ Валовый сбор 5372 - "productivityFact": 0, ~/~/ Фактическая урожайность 5373 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5374 - "totalFact": 0, ~/~/ Фактический валовый сбор 5375 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ 5376 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева 5377 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая 5378 - "isyearplan": true, ~/~/ 5379 - "comment": "string" ~/~/ Комментарий 5380 - } 5381 - ], 5382 - "cropVegetation": [ ~/~/ История вегетации поля 5383 - { 5384 - "values": [ ~/~/ Данные вегетации и состояния посева 5385 - { 5386 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5387 - "ndvi": 0 ~/~/ Индекс вегетации 5388 - } 5389 - ], 5390 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5391 - { 5392 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5393 - "type": "string", ~/~/ Тип 5394 - "pictureid": "string" ~/~/ Идентификатор ресурса 5395 - } 5396 - ], 5397 - "states": [ ~/~/ Ключевые даты развития поля 5398 - { 5399 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5400 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5401 - } 5402 - ] 5403 - } 5404 - ], 5405 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая 5406 - "counts": { 5407 - "fieldOperations": 0, ~/~/ Количество операций на поле 5408 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5409 - "facts": 0 ~/~/ Счётчик факта 5410 - }, 5411 - "planComment": "string", ~/~/ Комментарий к полю 5412 - "productivity": 0, ~/~/ Урожайность. 5413 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5414 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая 5415 - "year": 0, ~/~/ Год поля 5416 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5417 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5418 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5419 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5420 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5421 - "id": 0, ~/~/ Идентификатор объекта геозоны 5422 - "name": "string", ~/~/ Название объекта геозоны 5423 - "type": 0, ~/~/ Тип объекта геозоны 5424 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5425 - "fname": "string", ~/~/ Имя файла 5426 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5427 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны 5428 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны 5429 - "description": "string", ~/~/ Описание объекта геозоны 5430 - "area": 0, ~/~/ Площадь, м2 5431 - "perimetr": 0, ~/~/ Периметр, м 5432 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд 5433 -} 5434 -))) 5435 -))) 5436 -))) 5437 -))) 5438 -))) 5439 - 5440 - 5441 -== **Редактирование года урожая ** == 5442 - 5443 -(% class="box successmessage" %) 5444 -((( 5445 -**POST /api/v3/agroLands/updateOpenCloseYear** 5446 -))) 5447 - 5448 -Пример запроса: 5449 - 5450 -((( 5451 -((( 5452 -{ 5453 - "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5454 - 0 5455 - ], 5456 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5457 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5458 -} 5459 -))) 5460 - 5461 - 5462 -))) 5463 - 5464 -Пример ответа: 5465 - 5466 -((( 5467 -((( 5468 -{ 5469 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5470 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5471 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5472 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5473 - "cropRotations": [ ~/~/ Данные по севообороту 5474 - { 5475 - "landId": 0, ~/~/ ID поля 5476 - "landName": "string", ~/~/ Название поля 5477 - "year": 0, ~/~/ Год урожая 5478 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5479 - "cultureName": "string", ~/~/ Название культуры 5480 - "productivity": 0, ~/~/ Урожайность 5481 - "area": 0, ~/~/ Площадь поля, Га. 5482 - "total": 0, ~/~/ Валовый сбор 5483 - "productivityFact": 0, ~/~/ Фактическая урожайность 5484 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5485 - "totalFact": 0, ~/~/ Фактический валовый сбор 5486 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5487 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5488 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5489 - "isyearplan": true, ~/~/ 5490 - "comment": "string" ~/~/ Комментарий 5491 - } 5492 - ], 5493 - "cropVegetation": [ ~/~/ История вегетации поля 5494 - { 5495 - "values": [ ~/~/ Данные вегетации и состояния посева 5496 - { 5497 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5498 - "ndvi": 0 ~/~/ Индекс вегетации 5499 - } 5500 - ], 5501 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5502 - { 5503 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5504 - "type": "string", ~/~/ Тип 5505 - "pictureid": "string" ~/~/ Идентификатор ресурса 5506 - } 5507 - ], 5508 - "states": [ ~/~/ Ключевые даты развития поля 5509 - { 5510 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5511 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5512 - } 5513 - ] 5514 - } 5515 - ], 5516 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5517 - "counts": { 5518 - "fieldOperations": 0, ~/~/ Количество операций на поле 5519 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5520 - "facts": 0 ~/~/ Счётчик факта 5521 - }, 5522 - "planComment": "string", ~/~/ Комментарий к полю 5523 - "productivity": 0, ~/~/ Урожайность. 5524 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5525 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5526 - "year": 0, ~/~/ Год поля 5527 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5528 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5529 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5530 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5531 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5532 - "id": 0, ~/~/ Идентификатор объекта геозоны 5533 - "name": "string", ~/~/ Название объекта геозоны 5534 - "type": 0, ~/~/ Тип объекта геозоны 5535 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5536 - "fname": "string", ~/~/ Имя файла 5537 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5538 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5539 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5540 - "description": "string", ~/~/ Описание объекта геозоны 5541 - "area": 0, ~/~/ Площадь, м2 5542 - "perimetr": 0, ~/~/ ериметр, м 5543 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5544 -} 5545 - 5546 - 5547 -== **Какие поля посещал объект** == 5548 - 5549 -(% class="box successmessage" %) 5550 -((( 5551 -**POST /api/v3/agroLands/visitingByVehicle** 5552 -))) 5553 - 5554 -Пример запроса: 5555 - 5556 -{ 5557 - "vehicleId": 0, ~/~/ id объекта 5558 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5559 - "byTime": 0, ~/~/ Объединение событий по времени 5560 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5561 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5562 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5563 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5564 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5565 -} 5566 - 5567 -Пример ответа: 5568 - 5569 -[ 5570 - { 5571 - "fieldId": 0, ~/~/ id объекта 5572 - "vehicleName": "string", ~/~/ Наименование объекта 5573 - "fieldName": "string", ~/~/ Наименование поля 5574 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5575 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5576 - "vehicleId": 0, ~/~/ Идентификатор ТС 5577 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5578 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5579 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5580 - "mileage": 0 ~/~/ Пробег 5581 - } 5582 -] 5583 -))) 5584 - 5585 - 5586 -== **Посещение поля объектами ** == 5587 - 5588 -(% class="box successmessage" %) 5589 -((( 5590 -**POST /api/v3/agroLands/visitingByField** 5591 -))) 5592 - 5593 -Пример запроса: 5594 -{ 5595 - "fieldId": 0, ~/~/ ID поля 5596 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5597 - "byTime": 0, ~/~/ Объединение событий по времени 5598 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5599 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5600 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5601 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5602 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5603 -} 5604 - 5605 -Пример ответа: 5606 - 5607 -[ 5608 - { 5609 - "fieldId": 0, ~/~/ ID поля 5610 - "vehicleName": "string", ~/~/ Наименование объекта 5611 - "fieldName": "string", ~/~/ Имя поля 5612 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5613 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5614 - "vehicleId": 0, ~/~/ Идентификатор ТС 5615 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5616 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5617 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5618 - "mileage": 0 ~/~/ Пробег 5619 - } 5620 -] 5621 - 5622 - 5623 -== **Удаление существующего поля** == 5624 - 5625 -(% class="box errormessage" %) 5626 -((( 5627 -**DELETE /api/v3/agroLands/{id}** 5628 -))) 5629 - 5630 -Пример запроса: 5631 -id ~/~/ Идентификатор поля 5632 - 5633 -Пример ответа: 5634 - 5635 -((( 5636 -200 ~/~/ Успех 5637 - 5638 - 5639 -))) 5640 - 5641 5641 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5642 -))) 5643 -))) 5644 -))) 5645 5645 5646 5646 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5647 5647 ... ... @@ -5648,7 +5648,7 @@ 5648 5648 5649 5649 (% class="box infomessage" %) 5650 5650 ((( 5651 - **GET api/v3/Vehicles/recyclebin/all**4682 +GET api/v3/Vehicles/recyclebin/all 5652 5652 ))) 5653 5653 5654 5654 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5683,11 +5683,11 @@ 5683 5683 ] 5684 5684 5685 5685 5686 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==4717 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5687 5687 5688 5688 (% class="box infomessage" %) 5689 5689 ((( 5690 - **POSTapi/v3/Vehicles/recyclebin/erase**4721 +POST/api/v3/Vehicles/recyclebin/erase 5691 5691 ))) 5692 5692 5693 5693 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5729,7 +5729,7 @@ 5729 5729 5730 5730 (% class="box infomessage" %) 5731 5731 ((( 5732 - **POSTapi/v3/Vehicles/recyclebin/restore**4763 +POST/api/v3/Vehicles/recyclebin/restore 5733 5733 ))) 5734 5734 5735 5735 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5781,782 +5781,7 @@ 5781 5781 ] 5782 5782 5783 5783 5784 -= **Раздел: Журнал заданий ** = 5785 5785 5786 - 5787 -== **Создание задания в Журнале заданий** == 5788 - 5789 -(% class="box infomessage" %) 5790 -((( 5791 -**POST /api/v3/vehicletasks** 5792 -))) 5793 - 5794 -Пример запроса: 5795 - 5796 -((( 5797 -{ 5798 - "vehicleId": 0, ~/~/ Идентификатор ТС 5799 - "description": "string", ~/~/ Описание 5800 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5801 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5802 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5803 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5804 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5805 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5806 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5807 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5808 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5809 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5810 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5811 - "cost": { 5812 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5813 - "Name": "string", ~/~/ Наименование 5814 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5815 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5816 - "Norm": 0 ~/~/ Норма внесения 5817 - }, 5818 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5819 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5820 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5821 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5822 - "deleted": true, ~/~/ Признак удаления 5823 - "extId": "string", 5824 - "GeoIds": [ ~/~/ Cвязанные поля 5825 - 0 5826 - ] 5827 -} 5828 -))) 5829 - 5830 - 5831 -Пример ответа: 5832 - 5833 -{ 5834 - "vehicleId": 0, ~/~/ Идентификатор ТС 5835 - "description": "string", ~/~/ Описание 5836 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5837 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5838 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5839 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5840 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5841 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5842 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5843 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5844 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5845 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5846 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5847 - "cost": { 5848 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5849 - "Name": "string", ~/~/ Наименование 5850 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5851 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5852 - "Norm": 0 ~/~/ Норма внесения 5853 - }, 5854 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5855 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5856 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5857 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5858 - "deleted": true, ~/~/ Признак удаления 5859 - "extId": "string", ~/~/ ExtId 5860 - "GeoIds": [ ~/~/ Связанные поля 5861 - 0 5862 - ] 5863 -} 5864 - 5865 - 5866 -== **Редактирование задания в Журнале заданий** == 5867 - 5868 -(% class="box successmessage" %) 5869 -((( 5870 -**PUT /api/v3/vehicletasks** 5871 -))) 5872 - 5873 -Пример запроса: 5874 - 5875 -((( 5876 -{ 5877 - "vehicleId": 0, ~/~/ Идентификатор ТС 5878 - "description": "string", ~/~/ Описание 5879 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5880 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5881 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5882 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5883 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5884 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5885 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5886 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5887 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5888 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5889 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5890 - "cost": { 5891 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5892 - "Name": "string", ~/~/ Наименование 5893 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5894 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5895 - "Norm": 0 ~/~/ Норма внесения 5896 - }, 5897 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5898 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5899 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5900 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5901 - "deleted": true, ~/~/ Признак удаления 5902 - "extId": "string", ~/~/ ExtId 5903 - "GeoIds": [ ~/~/ Связанные поля 5904 - 0 5905 - ] 5906 -} 5907 -))) 5908 - 5909 - 5910 -Пример ответа: 5911 - 5912 -{ 5913 - "vehicleId": 0, ~/~/ Идентификатор ТС 5914 - "description": "string", ~/~/ Описание 5915 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5916 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5917 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5918 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5919 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5920 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5921 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5922 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5923 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5924 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5925 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5926 - "cost": { 5927 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5928 - "Name": "string", ~/~/ Наименование 5929 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5930 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5931 - "Norm": 0 ~/~/ Норма внесения 5932 - }, 5933 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5934 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5935 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5936 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5937 - "deleted": true, ~/~/ Признак удаления 5938 - "extId": "string", ~/~/ ExtId 5939 - "GeoIds": [ ~/~/ Связанные поля 5940 - 0 5941 - ] 5942 -} 5943 - 5944 - 5945 -== **Удаление задания в Журнале заданий** == 5946 - 5947 -(% class="box warningmessage" %) 5948 -((( 5949 -**DELETE /api/v3/vehicletasks** 5950 -))) 5951 - 5952 -Пример запроса: 5953 - 5954 -((( 5955 -[ 5956 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5957 -] 5958 -))) 5959 - 5960 -((( 5961 - 5962 -))) 5963 - 5964 -Пример ответа: 5965 - 5966 -{ 5967 - "vehicleId": 0, ~/~/ Идентификатор ТС 5968 - "description": "string", ~/~/ Описание 5969 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5970 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5971 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5972 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5973 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5974 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5975 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5976 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5977 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5978 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5979 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5980 - "cost": { 5981 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5982 - "Name": "string", ~/~/ Наименование 5983 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5984 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5985 - "Norm": 0 ~/~/ Норма внесения 5986 - }, 5987 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5988 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5989 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5990 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5991 - "deleted": true, ~/~/ Признак удаления 5992 - "extId": "string", ~/~/ ExtId 5993 - "GeoIds": [ ~/~/ Связанные поля 5994 - 0 5995 - ] 5996 -} 5997 - 5998 - 5999 -== **Получение списка Журнала заданий** == 6000 - 6001 -(% class="box infomessage" %) 6002 -((( 6003 -**POST /api/v3/vehicletasks/getbyperiod** 6004 -))) 6005 - 6006 -Пример запроса: 6007 - 6008 -((( 6009 -{ 6010 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 6011 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 6012 - "TimeZone": 0, ~/~/ Часовой пояс. 6013 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 6014 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 6015 - ], 6016 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 6017 - 0 6018 - ], 6019 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 6020 - 0 6021 - ], 6022 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 6023 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 6024 -} 6025 -))) 6026 - 6027 - 6028 -Пример ответа: 6029 - 6030 -((( 6031 -{ 6032 - "total": 0, ~/~/ Общее количество записей 6033 - "pages": 0, ~/~/ Общее количество страниц 6034 - "currentPage": 0, ~/~/ Текущая страница 6035 - "items": [ ~/~/ Записи 6036 - { 6037 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6038 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 6039 - "name": "string", ~/~/ Название задания. 6040 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 6041 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 6042 - "workKind": "string", ~/~/ Вид работ 6043 - "techOp": "string", ~/~/ Тех. операция 6044 - "trailerModel": "string", ~/~/ Модель агрегата 6045 - "width": "string", ~/~/ Ширина, м 6046 - "speed": "string", ~/~/ Тех. скорость 6047 - "fields": "string", ~/~/ Поля 6048 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 6049 - "vehicles": "string", ~/~/ Объект-модель 6050 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 6051 - "drivers": "string", ~/~/ Водители 6052 - "tmc": "string", ~/~/ ТМЦ 6053 - "client": "string", ~/~/ Клиент 6054 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6055 - "dep": "string", ~/~/ Подразделение 6056 - "geoIds": [ ~/~/ Связанные поля 6057 - 0 6058 - ] 6059 - } 6060 - ] 6061 -} 6062 -))) 6063 - 6064 - 6065 -= **Раздел: Роли** = 6066 - 6067 -== **Получение списка клиентских и системных ролей пользователя ** == 6068 - 6069 -(% class="box successmessage" %) 6070 -((( 6071 -**POST /api/v3/groups/find** 6072 -))) 6073 - 6074 -Пример запроса: 6075 - 6076 -((( 6077 -{ 6078 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6079 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6080 -} 6081 -))) 6082 - 6083 -((( 6084 - 6085 -))) 6086 - 6087 -((( 6088 -Пример ответа: 6089 -))) 6090 - 6091 -((( 6092 -((( 6093 -{ 6094 - "groups": [ ~/~/ Системные роли пользователя 6095 - { 6096 - "code": "string", ~/~/ Код роли. 6097 - "name": "string", ~/~/ Имя 6098 - "shortName": "string" ~/~/ Короткое имя 6099 - } 6100 - ], 6101 - "customGroups": [ ~/~/ Системные роли пользователя 6102 - { 6103 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6104 - "name": "string", ~/~/ Наименование 6105 - "shortName": "string", ~/~/ Короткое наименование 6106 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6107 - } 6108 - ] 6109 -} 6110 -))) 6111 -))) 6112 - 6113 -((( 6114 - 6115 -))) 6116 - 6117 -((( 6118 - 6119 -))) 6120 - 6121 -= **Раздел: Локатор ** = 6122 - 6123 - 6124 -== **Получение данных по локатору** == 6125 - 6126 -(% class="box infomessage" %) 6127 -((( 6128 -**GET /api/v3/locators/{locatorId}** 6129 -))) 6130 - 6131 -В запросе указывается locatorid - идентификатор локатора 6132 - 6133 - 6134 -Пример ответа: 6135 - 6136 -((( 6137 -((( 6138 -{ 6139 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6140 - 0 6141 - ], 6142 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6143 - 0 6144 - ], 6145 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6146 - 0 6147 - ], 6148 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6149 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6150 - "agentName": "string", ~/~/ Наименование агента. 6151 - "isEnabled": true, ~/~/ Активность 6152 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6153 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6154 - "name": "string", ~/~/ Наименование. 6155 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6156 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6157 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6158 - "validity": 0, ~/~/ Значение срока действия 6159 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6160 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6161 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6162 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6163 - "url": "string", ~/~/ Ссылка 6164 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6165 - 6166 - "showVehicleName": true, ~/~/ Наименование объекта 6167 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6168 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6169 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6170 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6171 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6172 - 6173 - 1 6174 - 6175 - ] 6176 -} 6177 -))) 6178 -))) 6179 - 6180 - 6181 -((( 6182 -((( 6183 - 6184 -))) 6185 -))) 6186 - 6187 - 6188 -== **Создание локатора** == 6189 - 6190 -(% class="box successmessage" %) 6191 -((( 6192 -**POST /api/v3/locators** 6193 -))) 6194 - 6195 -Пример запроса: 6196 - 6197 -((( 6198 -{ 6199 - "isEnabled": true, ~/~/ Активность 6200 - "name": "string", ~/~/ Наименование локатора 6201 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6202 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6203 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6204 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6205 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6206 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6207 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6208 - 0 6209 - ], 6210 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6211 - 0 6212 - ], 6213 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6214 - 0 6215 - ], 6216 - 6217 - "showVehicleName": true, ~/~/ Наименование объекта 6218 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6219 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6220 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6221 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6222 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6223 - 6224 - 1 6225 - 6226 - ] 6227 -} 6228 -))) 6229 - 6230 - 6231 -Пример ответа: 6232 - 6233 -((( 6234 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6235 -))) 6236 - 6237 - 6238 -== **Выводит список локаторов ** == 6239 - 6240 -(% class="box successmessage" %) 6241 -((( 6242 -**POST /api/v3/locators/find** 6243 -))) 6244 - 6245 -Пример запроса: 6246 - 6247 -((( 6248 -{ 6249 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6250 -} 6251 -))) 6252 - 6253 -((( 6254 - 6255 -))) 6256 - 6257 -((( 6258 - 6259 -))) 6260 - 6261 - 6262 -Пример ответа: 6263 - 6264 -((( 6265 -[ 6266 - { 6267 - "vehiclesCount": 0, ~/~/ Количество объектов. 6268 - "geozonesCount": 0, ~/~/ Количество геозон. 6269 - "fieldsCount": 0, ~/~/ Количество полей. 6270 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6271 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6272 - "agentName": "string", ~/~/ Наименование агента. 6273 - "isEnabled": true, ~/~/ Активность локатора 6274 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6275 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6276 - "name": "string", ~/~/ Наименование локатора 6277 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6278 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6279 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6280 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6281 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6282 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6283 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6284 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6285 - "url": "string", ~/~/ ссылка на локатор 6286 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6287 - "showVehicleName": true, ~/~/ Наименование объекта 6288 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6289 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6290 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6291 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6292 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6293 - 6294 - 0 6295 - ] 6296 - } 6297 -] 6298 -))) 6299 - 6300 - 6301 -== **Изменение локатора** == 6302 - 6303 -(% class="box infomessage" %) 6304 -((( 6305 -**PUT /api/v3/locators** 6306 -))) 6307 - 6308 -Пример запроса: 6309 - 6310 -((( 6311 -{ 6312 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6313 - "isEnabled": true, ~/~/ Активность 6314 - "name": "string", ~/~/ Наименование 6315 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6316 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6317 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6318 - "autoProlongation": true, ~/~/ Автопродление срока действия 6319 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6320 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6321 - 0 6322 - ], 6323 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6324 - 0 6325 - ], 6326 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6327 - 0 6328 - ], 6329 - "showVehicleName": true, ~/~/ Наименование объекта 6330 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6331 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6332 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6333 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6334 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6335 - 6336 - 0 6337 - 6338 - ] 6339 -} 6340 - 6341 - 6342 -))) 6343 - 6344 -Пример ответа: 6345 - 6346 -200 ~/~/ Success 6347 - 6348 - 6349 -== **Удалить локатор** == 6350 - 6351 -(% class="box warningmessage" %) 6352 -((( 6353 -**DELETE /api/v3/locators** 6354 -))) 6355 - 6356 -Пример запроса: 6357 - 6358 -((( 6359 -[ 6360 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6361 -] 6362 -))) 6363 - 6364 - 6365 -= **Раздел: Яндекс Маршруты** = 6366 - 6367 - 6368 -== **Возвращение списка маршрутов** == 6369 - 6370 -(% class="box infomessage" %) 6371 -((( 6372 -**GET /api/v3/TransportRoutes** 6373 -))) 6374 - 6375 -Пример запроса: 6376 -Id ~/~/ Идентификатор поля 6377 - 6378 -Пример ответа: 6379 - 6380 -((( 6381 -[ 6382 - { 6383 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6384 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6385 - "name": "string", ~/~/ Наименование маршрута. 6386 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6387 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6388 - 0 6389 - ] 6390 - } 6391 -] 6392 -))) 6393 - 6394 - 6395 -== **Добавить маршрут** == 6396 - 6397 -(% class="box infomessage" %) 6398 -((( 6399 -**POST /api/v3/TransportRoutes** 6400 -))) 6401 - 6402 -Пример запроса: 6403 -{ 6404 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6405 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6406 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6407 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6408 - 0 6409 - ] 6410 -} 6411 - 6412 - 6413 -Пример ответа: 6414 - 6415 -((( 6416 -{ 6417 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6418 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6419 - "name": "string", ~/~/ Определяет наименование маршрута 6420 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6421 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6422 - 0 6423 - ] 6424 -} 6425 -))) 6426 - 6427 - 6428 -== **Обновление маршрута** == 6429 - 6430 -(% class="box successmessage" %) 6431 -((( 6432 -**PUT /api/v3/TransportRoutes** 6433 -))) 6434 - 6435 -Пример запроса: 6436 - 6437 -((( 6438 -{ 6439 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6440 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6441 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6442 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6443 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6444 - 0 6445 - ] 6446 -} 6447 -))) 6448 - 6449 -Пример ответа: 6450 - 6451 -((( 6452 -{ 6453 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6454 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6455 - "name": "string", ~/~/ Определяет наименование маршрута 6456 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6457 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6458 - 0 6459 - ] 6460 -} 6461 -))) 6462 - 6463 - 6464 -== **Получить связки маршрутов ТС** == 6465 - 6466 -(% class="box infomessage" %) 6467 -((( 6468 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6469 -))) 6470 - 6471 -Пример запроса: 6472 - 6473 -((( 6474 -[ 6475 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6476 -] 6477 -))) 6478 - 6479 -Пример ответа: 6480 - 6481 -((( 6482 -[ 6483 - { 6484 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6485 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6486 - } 6487 -] 6488 -))) 6489 - 6490 - 6491 -== **Удалить маршрут** == 6492 - 6493 -(% class="box warningmessage" %) 6494 -((( 6495 -**DELETE /api/v3/TransportRoutes/{id}** 6496 -))) 6497 - 6498 -Пример запроса: 6499 -Id ~/~/ Идентификатор поля 6500 - 6501 - 6502 -= **Раздел: Управление доступа к машинам** = 6503 - 6504 - 6505 -== Получение списка транспортных средств видимых пользователю == 6506 - 6507 -(% class="box infomessage" %) 6508 -((( 6509 -**GET /api/v3/UserVisibleVehicles/{userId}** 6510 -))) 6511 - 6512 -Пример ответа: 6513 - 6514 -((( 6515 -{ 6516 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6517 - 0 6518 - ] 6519 -} 6520 -))) 6521 - 6522 - 6523 -== Задает видимость транспортных средств пользователю == 6524 - 6525 -(% class="box infomessage" %) 6526 -((( 6527 -**POST /api/v3/UserVisibleVehicles** 6528 -))) 6529 - 6530 -Пример запроса: 6531 - 6532 -((( 6533 -((( 6534 -{ 6535 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6536 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6537 - 0 6538 - ] 6539 -} 6540 -))) 6541 - 6542 -((( 6543 - 6544 -))) 6545 - 6546 -((( 6547 -Пример ответа : 6548 -))) 6549 - 6550 -((( 6551 - 6552 -))) 6553 - 6554 -((( 6555 -200 ~/~/ Success 6556 -))) 6557 -))) 6558 - 6559 - 6560 6560 (% class="box" lang="en-US" style="text-align: center;" %) 6561 6561 ((( 6562 6562 (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **