Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/09/16 11:13
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Gadmin1 +XWiki.SupportZhuchkov - Content
-
... ... @@ -1,22 +1,5 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -(% class="box warningmessage" %) 4 -((( 5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 -просим вас соблюдать несколько простых правил при использовании API-команд:## 7 -))) 8 - 9 -* Формировать не более 3 отчётов одновременно. 10 -* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 - 12 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 - 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 -))) 19 - 20 20 **Содержание страницы:** 21 21 ))) 22 22 ... ... @@ -31,20 +31,11 @@ 31 31 32 32 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 33 33 34 -(% style="color:#000000" %)− (%%)При **редактировании** любойзаписи (пользователь, объект и т.д)необходимо передавать все параметры записив теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 35 35 36 - 37 -(% style="color:#000000; font-size:16px" %)**Рекомендации** 38 - 39 -- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 40 - 41 41 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 42 42 43 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 44 -((( 45 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 46 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 47 -))) 21 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 48 48 49 49 (% class="box successmessage" %) 50 50 ((( ... ... @@ -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 -))) 101 + "agentId": "", (%%) 102 + "parentId": "", 103 + "parentName": "string", 104 + "name": "string", 105 + "fullName": "string", 106 + "agentInfoType": 0, 107 + "isForeign": true/false, 108 + "district": "string", 109 + "region": "string", 110 + "city": "string", 111 + "inn": "string", 112 + "kpp": "string", 113 + "address": "string", 114 + "addressFact": "string", 115 + "email": "string", 116 + "director": "string", 117 + "bankName": "string", 118 + "bankBIK": "string", 119 + "bankRS": "string", 120 + "bankKS": "string" 121 + } 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" %)Идентификатор клиента-родителя ... ... @@ -287,6 +287,28 @@ 287 287 "bankKS": "string" ~/~/ корр. счёт 288 288 } 289 289 252 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 253 +|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 254 +|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 255 +|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 256 +|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 257 +|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 258 +|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 259 +|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 260 +|(% style="width:215px" %)district|(% style="width:861px" %)Округ 261 +|(% style="width:215px" %)region|(% style="width:861px" %)Регион 262 +|(% style="width:215px" %)city|(% style="width:861px" %)Город 263 +|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 264 +|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 265 +|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 266 +|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 267 +|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 268 +|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 269 +|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 270 +|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 271 +|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 272 +|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 273 + 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 - Азербайджанский419 + "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,842 + "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,861 + "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" %)Метод позволяет изменить статус модели, указанного в запросе.895 +(% 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" %)Метод позволяет удалить модели. Метод позволяет удалитьмодель, указанного в строке запроса.962 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 984 984 985 985 (% style="color:#000000" %)Метод запроса: **DELETE** 986 986 ... ... @@ -992,7 +992,7 @@ 992 992 993 993 Ответ: В случае успеха **Success 200** 994 994 995 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =974 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 996 996 997 997 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 998 998 ... ... @@ -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 объекта ... ... @@ -1126,7 +1126,6 @@ 1126 1126 ], 1127 1127 "showInTooltip": true, ~/~/ Отображать в подсказке 1128 1128 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1129 - "color": "string", ~/~/ Код цвета датчиков 1130 1130 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1131 1131 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1132 1132 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1184,21 +1184,11 @@ 1184 1184 "date": "2023-05-22T09:57:39.562Z", 1185 1185 "description": "string", 1186 1186 "additionalInfo": "string" 1187 - 1188 - (((1154 + } 1155 + ] 1189 1189 } 1190 - ], 1191 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1192 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1193 1193 ))) 1194 1194 1195 -((( 1196 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1197 -} 1198 - 1199 -))) 1200 -))) 1201 - 1202 1202 (% style="text-align:left" %) 1203 1203 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1204 1204 ... ... @@ -1216,15 +1216,13 @@ 1216 1216 Команда для отправки на тс. 1217 1217 1218 1218 { 1219 -"id": "", ~/~/идентификатор о бъекта (онже идентификаторТС: vehicleId)1220 -"command": "", ~/~/ Текст отправляемойкоманды1221 -"retries": "", ~/~/ Количество попыток отправки на терминал1222 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов).1176 +"id": "", ~/~/идентификатор произвольного поля 1177 +"command": "", ~/~/ Текст команды 1178 +"retries": "", ~/~/ Количество попыток 1179 +"idTemplate": "" ~/~/ ID шаблона команды 1223 1223 } 1224 1224 1225 -В ответ получаем cmdid 1226 1226 1227 - 1228 1228 == **Получить ответ на отправленную на ТС команду** == 1229 1229 1230 1230 (% class="box infomessage" %) ... ... @@ -1232,13 +1232,13 @@ 1232 1232 (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1233 1233 ))) 1234 1234 1235 -Идентификатор команды: cmd Id1190 +Идентификатор команды: cmdid 1236 1236 1237 1237 Запрос от терминала на ответ команды 1238 1238 1239 1239 Пример ответ от терминала: 1240 1240 1241 -ID= "" ~/~/ идентификатор о бъекта1196 +ID= "" ~/~/ идентификатор произвольного поля 1242 1242 Soft="" ~/~/ версия софта 1243 1243 GPS=4 ~/~/ тип трекера 1244 1244 Time=11:05:43 28.06.24 ~/~/ время запроса ... ... @@ -1291,13 +1291,7 @@ 1291 1291 1292 1292 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1293 1293 1294 -(% style="color:#000000" %){ 1295 - 1296 - 1297 -((( 1298 - "vehicleId": 0, ~/~/ ID ТС 1299 -))) 1300 - 1249 +(% style="color:#000000" %){(%%) 1301 1301 "parentId": "" , ~/~/ ID клиента 1302 1302 "name": "" , ~/~/ имя ТС 1303 1303 "imei": "" , ~/~/ IMEI ... ... @@ -1390,7 +1390,6 @@ 1390 1390 ], 1391 1391 "showInTooltip": true, ~/~/ Отображать в подсказке 1392 1392 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1393 - "color": "string", ~/~/ код цвета датчиков 1394 1394 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1395 1395 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1396 1396 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1415,204 +1415,70 @@ 1415 1415 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1416 1416 ~/~/ "ValueOn": "Вкл.", 1417 1417 ~/~/ "ValueOff": "Выкл." 1418 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1419 - 1420 -((( 1421 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1422 - { 1423 - "from": 0, ~/~/ С какого значения 1424 - "color": "string", ~/~/ Каким цветом 1425 - "text": "string" ~/~/ Текст подписи к этому интервалу 1426 - } 1427 - ] 1366 + "summaryMaxValue": 0 ~/~/ Макс. значение 1428 1428 } 1429 1429 ], 1430 -))) 1431 - 1432 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1433 - 1434 - 1435 1435 "customFields": [ ~/~/ Произвольные поля 1436 1436 { 1437 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1438 - "name": "string", ~/~/ Наименование произвольного поля 1439 - "value": "string", ~/~/ Значение произвольного поля 1440 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1441 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1442 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1443 - 1444 -((( 1445 - } 1446 - ], 1447 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1448 -))) 1449 - 1450 -((( 1451 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1371 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1372 + "name": "string", 1373 + "value": "string", 1374 + "forClient": true, 1375 + "forTooltip": true, 1376 + "forReport": true 1377 + } 1378 + ] 1452 1452 } 1453 -))) 1454 1454 1455 - 1456 1456 (% style="color:#000000" %)Ответ: 1457 1457 1458 - 1459 -((( 1460 -((( 1461 -((( 1462 -{ 1463 - "vehicleId": 0, ~/~/ ID ТС 1464 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1465 - "name": "string", ~/~/ Имя объекта 1466 - "imei": "string", ~/~/ IMEI 1467 - "deviceTypeId": 0, ~/~/ ID типа устройства 1468 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1469 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1470 - "sim1": "string", ~/~/ SIM1 1471 - "sim2": "string", ~/~/ SIM2 1472 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1473 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1474 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1475 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1476 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1477 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1478 - "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1479 - "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1480 - "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1481 - "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1482 - "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1483 - "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1484 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1485 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1486 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1487 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1488 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1489 - "counters": { ~/~/ Dto для состояний счётчиков 1490 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1491 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1492 - "mileage": 0, ~/~/ Пробег 1493 - "motohours": 0 ~/~/ Моточасы 1494 - }, 1495 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1496 - "id": "string", ~/~/ CMSV6 Идентификатор 1497 - "enabled": true, ~/~/ Признак включения 1498 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1499 - "login": "string", ~/~/ CMSV6 имя учетной записи 1500 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1501 - }, 1502 - "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1503 - { 1504 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1505 - "enabled": true, ~/~/ Признак включения 1506 - "name": "string", ~/~/ Имя задания 1507 - "description": "string", ~/~/ Описание задания 1508 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1509 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1510 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1511 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1512 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1513 - "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1514 - "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1515 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 1383 +(% style="color:#000000" %){(%%) 1384 + "vehicleId": "", ~/~/ID ТС 1385 + "parentId": "", ~/~/Guid владельца ТС 1386 + "name": "", ~/~/Имя объекта 1387 + "imei": "", ~/~/IMEI 1388 + "deviceTypeId": "", ~/~/ID типа устройства 1389 + "modelId": "", ~/~/ID модели 1390 + "unitId": "", ~/~/ID подразделения 1391 + "sim1": "", ~/~/SIM1 1392 + "sim2": "", ~/~/SIM2 1393 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1394 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1395 + "counters": { ~/~/Счётчики 1396 + "mileageEnabled": true, 1397 + "motohoursEnabled": true, 1398 + "mileage": "", 1399 + "motohours": 345.0 1400 + }, 1401 + "cmsv6Parameters": { ~/~/Параметры CmsV6 1402 + "id": null, 1403 + "enabled": true, ~/~/флаг включения 1404 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1405 + "login": "", ~/~/ имя учетной записи 1406 + "password": "" ~/~/ пароль учетной записи 1407 + }, 1408 + "inspectionTasks": { ~/~/ задания на ТО 1409 + "id": "", ~/~/ ID задачи 1410 + "enabled": false, ~/~/ Признак включения 1411 + "name": "", ~/~/ Имя задания 1412 + "description": "", ~/~/ Описание задания 1413 + "mileageCondition": "", ~/~/ Условие по пробегу 1414 + "lastMileage": "", ~/~/ Пробег (в метрах) 1415 + "motohoursCondition": "", ~/~/ Условие по моточасам 1416 + "lastMotohours": "", ~/~/ Моточасы 1417 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1418 + "kind": "", ~/~/ Вид периодичности по времени 1419 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1516 1516 } 1517 - ], 1518 - "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1519 - { 1520 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1521 - "inputNumber": 0, ~/~/ № входа. 1522 - "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1523 - "comment": "string", ~/~/ Комментарий 1524 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1525 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1526 - "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1527 - "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1528 - } 1529 - ], 1530 - "commandTemplates": [ ~/~/ Список шаблонов команд 1531 - { 1532 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1533 - "name": "string", ~/~/ Название шаблона команд 1534 - "command": "string", ~/~/ Команда на выполнение 1535 - "retries": 0 ~/~/ Лимит попыток отправки 1536 - } 1537 - ], 1538 - "sensors": [ ~/~/ Список датчиков 1539 - { 1540 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1541 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1542 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 1543 - "name": "string", ~/~/ Имя датчика 1544 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1545 - "inputNumber": 0, ~/~/ Номер входа 1546 - "pseudonym": "string", ~/~/ Псевдоним 1547 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1548 - "isInverted": true, ~/~/ Признак инверсии 1549 - "disabled": true, ~/~/ Датчик не участвует в обработке 1550 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1551 - "gradesTables": [ ~/~/ Тарировка 1552 - { 1553 - "grades": [ ~/~/ Таблицы тарировки 1554 - { 1555 - "input": 0, ~/~/ Вход 1556 - "output": 0 ~/~/ Выход 1557 - } 1558 - ], 1559 - "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1560 - } 1561 - ], 1562 - "showInTooltip": true, ~/~/ Отображение в подсказке 1563 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 1564 - "color": "string", ~/~/ код цвета датчиков 1565 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1566 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1567 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1568 - "expr": "string", ~/~/ Выражение 1569 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1570 - "string" 1571 - ], 1572 - "customParams": { 1573 - "additionalProp1": "string", 1574 - "additionalProp2": "string", 1575 - "additionalProp3": "string" 1576 - }, 1577 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1578 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1579 - { 1580 - "from": 0, ~/~/ С какого значения 1581 - "color": "string", ~/~/ Каким цветом 1582 -))) 1421 +(% style="color:#000000" %)} 1583 1583 1584 -((( 1585 - "text": "string" ~/~/ Текст подписи к этому интервалу 1586 - } 1587 - ] 1588 - } 1589 - ], 1590 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1591 - "customFields": [ ~/~/ Список произвольных полей 1592 - { 1593 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1594 - "name": "string", ~/~/ Наименование произвольного поля 1595 - "value": "string", ~/~/ Значение произвольного поля 1596 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1597 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1598 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1599 - } 1600 - ], 1601 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1602 -} 1603 -))) 1604 -))) 1605 -))) 1606 - 1607 - 1608 1608 **Валидация:** 1609 1609 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1610 1610 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1611 1611 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1612 1612 1428 +== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) == 1613 1613 1614 -== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1615 - 1616 1616 (% class="box infomessage" %) 1617 1617 ((( 1618 1618 (% lang="en-US" %)**POST /api/v3/vehicles/find** ... ... @@ -1652,12 +1652,9 @@ 1652 1652 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1653 1653 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1654 1654 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1655 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1656 - "unitName": "string", ~/~/ Название подразделения (опционально) 1657 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1658 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1659 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1660 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1469 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1470 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1471 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1661 1661 } 1662 1662 1663 1663 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1664,15 +1664,8 @@ 1664 1664 1665 1665 (% style="color:#000000" %)Ответ: 1666 1666 1667 -(% style="color:#000000" %)[ 1668 -{ 1669 - 1670 -((( 1671 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1672 -))) 1673 - 1674 -((( 1675 -(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1478 +(% style="color:#000000" %){ 1479 + "vehicleId": "" ~/~/ идентификатор объекта 1676 1676 "name": "" ~/~/ наименование объекта 1677 1677 "imei": "" ~/~/ IMEI объекта 1678 1678 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1697,21 +1697,9 @@ 1697 1697 "forClient": true, ~/~/ право на отображение у клиента 1698 1698 "forTooltip": false, ~/~/ право на отображение в подсказке 1699 1699 "forReport": false ~/~/ право на отображение в отчетах 1700 -))) 1504 + }(%%) 1505 +(% style="color:#000000" %)} 1701 1701 1702 -((( 1703 - } 1704 - ], 1705 - "vehicleGroups": [ ~/~/ Группы ТС 1706 - { 1707 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1708 - "name": "string" ~/~/ Наименование группы ТС 1709 - } 1710 - ] 1711 - } 1712 -] 1713 -))) 1714 - 1715 1715 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1716 1716 1717 1717 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1756,6 +1756,7 @@ 1756 1756 "stage": "", ~/~/ Состояние 1757 1757 (% style="color:#000000" %) } 1758 1758 1551 +== == 1759 1759 1760 1760 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1761 1761 ... ... @@ -1832,19 +1832,9 @@ 1832 1832 1833 1833 "drivers": [ ~/~/ Водители 1834 1834 { 1835 - 1836 -((( 1837 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1838 - "inputNumber": 0, ~/~/ № входа. 1839 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1840 - "comment": "string", ~/~/ Комментарий. 1841 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1842 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1843 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1844 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1845 -))) 1846 - 1847 - } 1628 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1629 + "isDefault": true 1630 + } 1848 1848 ], 1849 1849 "commandTemplates": [ ~/~/ Шаблон команды 1850 1850 { ... ... @@ -1880,11 +1880,6 @@ 1880 1880 ], 1881 1881 "showInTooltip": true, ~/~/ Отображать в подсказке 1882 1882 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1883 - 1884 -((( 1885 - "color": "string",** ~/~/ **Цвет датчика 1886 -))) 1887 - 1888 1888 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1889 1889 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1890 1890 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1910,211 +1910,65 @@ 1910 1910 ~/~/ "ValueOn": "Вкл.", 1911 1911 ~/~/ "ValueOff": "Выкл." 1912 1912 "summaryMaxValue": 0 ~/~/ Макс. значение 1913 - 1914 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1915 - { 1916 - "from": 0, ~/~/ С какого значения 1917 - "color": "string", ~/~/ Каким цветом 1918 - "text": "string" ~/~/ Текст подписи к этому интервалу 1919 - } 1920 - ] 1921 1921 } 1922 1922 ], 1923 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1924 - 1925 1925 "customFields": [ ~/~/ Произвольные поля 1926 - { 1927 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1928 - "name": "string", ~/~/ Наименование произвольного поля1929 - "value": "string", ~/~/ Значение произвольного поля1930 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1931 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1932 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1694 + { 1695 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1696 + "name": "string", 1697 + "value": "string", 1698 + "forClient": true, 1699 + "forTooltip": true, 1700 + "forReport": true 1933 1933 } 1934 - 1935 -((( 1936 - ], 1937 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1938 -))) 1939 - 1702 + ] 1940 1940 } 1941 1941 1942 - 1943 1943 (% style="color:#000000" %)Ответ: 1944 1944 1945 -((( 1946 -{ 1947 - "vehicleId": 0, ~/~/ ID ТС 1948 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1949 - "name": "string", ~/~/ Имя объекта 1950 - "imei": "string", ~/~/ IMEI 1951 - "deviceTypeId": 0, ~/~/ ID типа устройства 1952 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1953 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1954 - "sim1": "string", ~/~/ SIM1 1955 - "sim2": "string", ~/~/ SIM2 1956 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1957 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1958 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1959 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1960 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1961 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1962 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1963 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1964 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1965 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1966 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1967 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1968 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 1969 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1970 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1971 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1972 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1973 - "counters": { ~/~/ состояний счётчиков 1974 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1975 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1976 - "mileage": 0, ~/~/ Пробег 1977 - "motohours": 0 ~/~/ Моточасы 1978 - }, 1979 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1980 - "id": "string", ~/~/ CMSV6 Идентификатор 1981 - "enabled": true, ~/~/ Признак включения 1982 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1983 -))) 1984 - 1985 - 1986 -((( 1987 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1988 - "login": "string", ~/~/ CMSV6 имя учетной записи 1989 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1990 - }, 1991 - "inspectionTasks": [ ~/~/ Задания на ТО 1992 - { 1993 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1994 - "enabled": true, ~/~/ Признак включения 1995 - "name": "string", ~/~/ Имя задания 1996 - "description": "string", ~/~/ Описание задания 1997 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1998 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1999 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 2000 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 2001 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 2002 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 2003 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 2004 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 2005 - } 2006 - ], 2007 - "drivers": [ ~/~/ Список водителей 2008 - { 2009 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 2010 - "inputNumber": 0, ~/~/ № входа. 2011 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 2012 - "comment": "string", ~/~/ Комментарий. 2013 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 2014 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 2015 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 2016 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 2017 - } 2018 - ], 2019 - "commandTemplates": [ ~/~/ Список шаблонов команд 2020 - { 2021 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 2022 - "name": "string", ~/~/ Название шаблона команд 2023 - "command": "string", ~/~/ Команда на выполнение 2024 - "retries": 0 ~/~/ Лимит попыток отправки 2025 - } 2026 - ], 2027 - "sensors": [ ~/~/ Список датчиков 2028 - { 2029 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 2030 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 2031 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 2032 -))) 2033 - 2034 -((( 2035 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 2036 -))) 2037 - 2038 -((( 2039 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 2040 -))) 2041 - 2042 -((( 2043 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 2044 -))) 2045 - 2046 -((( 2047 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 2048 -))) 2049 - 2050 -((( 2051 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 2052 - "name": "string", ~/~/ Имя датчика 2053 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 2054 -))) 2055 - 2056 -((( 2057 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 2058 - "inputNumber": 0, ~/~/ Номер входа 2059 - "pseudonym": "string", ~/~/ Псевдоним 2060 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 2061 - "isInverted": true, ~/~/ Признак инверсии 2062 - "disabled": true, ~/~/ Датчик не участвует в обработке 2063 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 2064 - "gradesTables": [ ~/~/ Тарировка 1707 +(% lang="en-US" style="text-align:left" %) 1708 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1709 + "vehicleId": "", ~/~/ ID ТС 1710 + "parentId": "", ~/~/ ID клиента 1711 + "name": "", ~/~/ имя ТС 1712 + "imei": "", ~/~/ IMEI 1713 + "deviceTypeId": "", ~/~/ типа устройства 1714 + "modelId": "", ~/~/ ID модели 1715 + "unitId": "", ~/~/ ID подразделения 1716 + "sim1": "", ~/~/ SIM 1 1717 + "sim2": "", ~/~/ SIM2 1718 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1719 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1720 + "counters": 1721 + { 1722 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1723 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1724 + "mileage": "", ~/~/ пробег 1725 + "motohours": "", ~/~/ моточасы 1726 + } 1727 + "cmsv6Parameters": ~/~/ параметры CMSv6 2065 2065 { 2066 - "grades": [ ~/~/ Таблицы тарировки 2067 - { 2068 - "input": 0, ~/~/ Вход 2069 - "output": 0 ~/~/ Выход 2070 - } 2071 - ], 2072 - "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2073 - } 2074 - ], 2075 - "showInTooltip": true, ~/~/ Отображение в подсказке 2076 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 2077 - 2078 -((( 2079 - "color": "string", ~/~/ цвет уведомлений 2080 -))) 2081 - 2082 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2083 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2084 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2085 - "expr": "string", ~/~/ Выражение 2086 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2087 - "string" 2088 - ], 2089 - "customParams": { ~/~/ Дополнительные настройки 2090 - "additionalProp1": "string", 2091 - "additionalProp2": "string", 2092 - "additionalProp3": "string" 2093 - }, 2094 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2095 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1729 + "id": ~/~/ идентификатор 1730 + "enabled": true, ~/~/ флаг включения 1731 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1732 + "login": "", ~/~/ имя учетной записи 1733 + "password": "", ~/~/ пароль учетной записи 1734 + } 1735 + "inspectionTasks": ~/~/ задания на ТО 2096 2096 { 2097 - "from": 0, ~/~/ С какого значения 2098 - "color": "string", ~/~/ Каким цветом 2099 - "text": "string" ~/~/ Текст подписи к этому интервалу 1737 + "id": "", ~/~/ ID задания 1738 + "enabled": false, ~/~/ Признак включения 1739 + "name": "", ~/~/ Имя задания 1740 + "description": "", ~/~/ Описание задания 1741 + "mileageCondition": "", ~/~/ Условие по пробегу 1742 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1743 + "motohoursCondition": "", ~/~/ Условие по моточасам 1744 + "lastMotohours": "", ~/~/ Моточасы 1745 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1746 + "kind": "", ~/~/ Вид периодичности по времени 1747 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 2100 2100 } 2101 - ] 2102 - } 2103 - ], 2104 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2105 - "customFields": [ ~/~/ Список произвольных полей 2106 - { 2107 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2108 - "name": "string", ~/~/ Наименование произвольного поля 2109 - "value": "string", ~/~/ Значение произвольного поля 2110 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2111 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2112 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 2113 - } 2114 - ], 2115 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2116 -} 2117 -))) 1749 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 2118 2118 2119 2119 **Валидация:** 2120 2120 - сезонный параметр может быть задан только если задана соответствующая обычная норма; ... ... @@ -2372,7 +2372,7 @@ 2372 2372 Тело запроса: 2373 2373 2374 2374 { 2375 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2007 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2376 2376 "vehicleIds": [0], ~/~/ Список ID объектов 2377 2377 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2378 2378 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2389,14 +2389,10 @@ 2389 2389 { 2390 2390 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2391 2391 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2392 - "mileage": 0, ~/~/ Пробег за период, километры 2393 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2394 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2395 - "motohours": 0, ~/~/ Моточасы за период, секунды 2396 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2397 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2398 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2399 - 2024 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2025 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2026 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2027 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2400 2400 } 2401 2401 ] 2402 2402 } ... ... @@ -2419,6 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2050 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2422 2422 "vehicleIds": [0], ~/~/ Список ID объектов 2423 2423 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2424 2424 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2437,23 +2437,13 @@ 2437 2437 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2438 2438 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2439 2439 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2440 - "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2441 - "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2442 2442 "fuelConsumption": 0, ~/~/ Расход топлива 2443 2443 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2444 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2445 - 2446 2446 } 2447 2447 ] 2448 2448 } 2449 2449 ] 2450 2450 2451 -(% class="box warningmessage" %) 2452 -((( 2453 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2454 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2455 -))) 2456 - 2457 2457 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2458 2458 2459 2459 (% class="box infomessage" %) ... ... @@ -2488,21 +2488,12 @@ 2488 2488 "model": "string", ~/~/ Модель объекта 2489 2489 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2490 2490 { 2491 - "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 2492 - 2493 -((( 2110 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2494 2494 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2495 2495 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2496 2496 "valueFuel": 0, ~/~/ Количество 2497 2497 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2498 2498 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2499 -))) 2500 - 2501 -((( 2502 - "latitude": 0, ~/~/ Широта. 2503 - "longitude": 0 ~/~/ Долгота. 2504 -))) 2505 - 2506 2506 } 2507 2507 ] 2508 2508 } ... ... @@ -2550,7 +2550,7 @@ 2550 2550 ], 2551 2551 "stops": [ ~/~/ События стоянок 2552 2552 { 2553 - "address": " [Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес событияУлица, Дом, Город, Регион, Страна, Координаты2163 + "address": "string", ~/~/ Адрес события 2554 2554 "eventId": 0, ~/~/ Идентификатор события 2555 2555 "eventName": "string", ~/~/ Название события 2556 2556 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -2576,241 +2576,194 @@ 2576 2576 В заголовках запроса: X-Auth: Токен авторизации 2577 2577 2578 2578 2579 -В массивеуказываемid объектов через запятую2189 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2580 2580 2581 2581 Ответ: 2582 - 2583 -[ 2584 2584 { 2585 - "vehicleId": 55728, ~/~/2586 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",Guidобъекта2587 - "vehicleNumber": " 0105 КМ",2588 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",датапоступления данных2589 - "recordTime": "202 5-06-27T12:37:19Z",датаформированиеданных2590 - "state": 4,2591 - "speed": 31,2592 - "course": 116,2593 - "latitude": 45.722128,2594 - "longitude": 39.800432,2595 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/2596 - "geozones": [ ~/~/ 2193 + "vehicleId": 0, ~/~/Идентификатор объекта. 2194 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2195 + "vehicleNumber": "string",~/~/Номер объекта. 2196 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2197 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2198 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2199 + "speed": 0,~/~/Скорость объекта. 2200 + "course": 0,~/~/Курс движения [0;360] 2201 + "latitude": 0,~/~/Широта [-90°;90°]. 2202 + "longitude": 0,~/~/Долгота [-180°;180°]. 2203 + "address": "string",~/~/Адрес. 2204 + "geozones": [ ~/~/Сведения по геозонам. 2597 2597 { 2598 - "id": 10225647, ~/~/ ID Геозоны 2599 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2600 - }, 2601 - { 2602 - "id": 10282875, ~/~/ ID Геозоны 2603 - "name": "Ё2" ~/~/ Наименование геозоны 2604 - }, 2605 - { 2606 - "id": 10226240, ~/~/ ID Геозоны 2607 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2608 - }, 2609 - { 2610 - "id": 9747869, ~/~/ ID Геозоны 2611 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2612 - }, 2613 - { 2614 - "id": 10221123, ~/~/ ID Геозоны 2615 - "name": "53r" ~/~/ Наименование геозоны 2616 - }, 2617 - { 2618 - "id": 10197638, ~/~/ ID Геозоны 2619 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2206 + "id": 0, 2207 + "name": "string" 2620 2620 } 2621 - ] 2622 - } 2623 2623 2624 2624 2625 -= = 2211 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2626 2626 2627 -= (% style="color:#000000; font-size:1 8.6667px" %)Раздел:**Уведомления**(%%) =2213 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2628 2628 2629 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2630 - 2631 2631 (% class="box infomessage" %) 2632 2632 ((( 2633 -**POST /api/v3/ notifications/find**2217 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2634 2634 ))) 2635 2635 2636 -Метод возвращаетинформациюобуведомлениях переданногоклиента иегоклиентов нижепо иерархии.2220 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2637 2637 2638 -(% style="text-align: left;" %) 2639 -Метод запроса **POST** 2222 +(% style="color:#000000" %)Метод запроса: **POST** 2640 2640 2641 -(% style="text-align: left;" %) 2642 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2224 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2643 2643 2644 -(% style="text-align: left;" %) 2645 2645 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2646 2646 2228 +(% style="text-align:left" %) 2229 +Тело запроса: 2230 + 2231 +(% style="text-align:left" %) 2647 2647 { 2648 - "parentId": "" ~/~/ id клиента2233 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2649 2649 } 2650 2650 2236 +(% style="text-align:left" %) 2651 2651 Ответ: 2652 2652 2653 2653 [ 2654 2654 { 2655 - "id": 0, ~/~/ ID уведомления 2656 - "name": "string", ~/~/ Название уведомления 2657 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 2658 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2659 - "userId": "", ~/~/ Пользователь, создавший уведомление 2660 - "parentId": "", ~/~/ Идентификатор клиента 2661 - "parentName": "string" ~/~/ Имя клиента 2241 + "id": 0, ~/~/ Идентификатор объекта геозоны 2242 + "name": "string", ~/~/ Название объекта геозоны 2243 + "type": 0, ~/~/ Тип объекта геозоны 2244 + "fname": "string", ~/~/ Имя файла 2245 + "parentId": "string", ~/~/ Идентификатор клиента 2246 + "radius": 0, ~/~/ Радиус геообъекта 2247 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2248 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2249 + "description": "string", ~/~/ Описание 2250 + "area": 0, ~/~/ Площадь, м^^2^^ 2251 + "perimetr": 0, ~/~/ Периметр, м 2252 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2662 2662 } 2663 2663 ] 2664 2664 2256 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2665 2665 2666 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2667 - 2668 2668 (% class="box infomessage" %) 2669 2669 ((( 2670 -**POST /api/v3/ notifications**2260 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2671 2671 ))) 2672 2672 2673 -Метод з апроса**POST**2263 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2674 2674 2675 -(% style="text-align: left;" %) 2676 -(% style="color:#000000" %)Пример запроса 2265 +(% style="color:#000000" %)Метод запроса: **POST** 2677 2677 2678 -((( 2267 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2268 + 2269 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2270 + 2271 +(% style="text-align:left" %) 2272 +Тело запроса: 2273 + 2679 2679 { 2680 - "id": 0, ~/~/ ID правила 2681 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2682 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2683 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2684 - "name": "string", ~/~/ Имя правила 2685 - "active": true, ~/~/ Активность правила 2686 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2687 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2688 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2689 - ], 2690 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2691 - 0 2692 - ], 2693 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2694 - 0 2695 - ], 2696 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2697 - 0 2698 - ], 2699 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2700 - "additionalProp1": "string", 2701 - "additionalProp2": "string", 2702 - "additionalProp3": "string" 2703 - }, 2704 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2705 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2706 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2707 - ], 2708 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2709 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2710 - "string" 2711 - ], 2712 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2713 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2714 - { 2715 - "id": 0, ~/~/ Идентификатор участника чата. 2716 - "info": "string" ~/~/ Дополнительные сведения. 2717 - } 2718 - ], 2719 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2720 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2721 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2722 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2723 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2724 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2725 - "timezone": 0, ~/~/ часовой пояс 2726 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2727 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2728 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2729 - { 2730 - "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 - Срок действия правила истек 2731 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2732 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2733 - "additionalProp1": "string", 2734 - "additionalProp2": "string", 2735 - "additionalProp3": "string" 2736 - } 2737 - } 2738 - ] 2275 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2276 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2277 + "ids": [ ], ~/~/ Массив id объектов 2278 + "byTime": 0, ~/~/ Объединение событий по времени 2279 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2280 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2281 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2739 2739 } 2740 -))) 2741 2741 2284 +Ответ: 2285 +[ 2286 + { 2287 + "geozoneId": 0, ~/~/ ID геообъекта 2288 + "geozoneName": "string", ~/~/ Название геообъекта 2289 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2290 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2291 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2292 + "vehicleId": 0, ~/~/ ID объекта 2293 + "vehicleName": "string" ~/~/ Имя объекта 2294 + } 2295 +] 2296 + 2297 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2298 + 2299 +(% class="box infomessage" %) 2742 2742 ((( 2743 - 2301 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2744 2744 ))) 2745 2745 2304 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2305 + 2306 +(% style="color:#000000" %)Метод запроса: **POST** 2307 + 2308 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2309 + 2310 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2311 + 2312 +(% style="text-align:left" %) 2313 +Тело запроса: 2314 + 2315 +{ 2316 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2317 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2318 + "ids": [ ], ~/~/ Массив id геообъектов 2319 + "byTime": 0, ~/~/ Объединение событий по времени 2320 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2321 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2322 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2323 +} 2324 + 2325 +Ответ: 2326 + 2327 +[ 2328 + { 2329 + "geozoneId": 0, ~/~/ ID геообъекта 2330 + "geozoneName": "string", ~/~/ Название геообъекта 2331 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2332 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2333 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2334 + "vehicleId": 0, ~/~/ ID объекта 2335 + "vehicleName": "string" ~/~/ Имя объекта 2336 + } 2337 +] 2338 + 2339 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2340 + 2341 +== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2342 + 2343 +(% class="box infomessage" %) 2746 2746 ((( 2747 - 2345 +**POST /api/v3/notifications/find** 2748 2748 ))) 2749 2749 2750 - Ответ:2348 +Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 2751 2751 2350 +(% style="text-align: left;" %) 2351 +Метод запроса **POST** 2352 + 2353 +(% style="text-align: left;" %) 2354 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2355 + 2356 +(% style="text-align: left;" %) 2357 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2358 + 2752 2752 { 2753 - "id": 0, ~/~/ ID правила 2754 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2755 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2756 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2757 - "name": "string", ~/~/ Имя правила 2758 - "active": true, ~/~/ Активность правила 2759 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2760 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2761 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2762 - ], 2763 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2764 - 0 2765 - ], 2766 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2767 - 0 2768 - ], 2769 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2770 - 0 2771 - ], 2772 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2773 - "additionalProp1": "string", 2774 - "additionalProp2": "string", 2775 - "additionalProp3": "string" 2776 - }, 2777 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2778 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2779 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2780 - ], 2781 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2782 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2783 - "string" 2784 - ], 2785 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2786 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2787 - { 2788 - "id": 0, ~/~/ Идентификатор участника чата. 2789 - "info": "string" ~/~/ Дополнительные сведения. 2790 - } 2791 - ], 2792 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2793 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2794 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2795 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2796 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2797 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2798 - "timezone": 0, ~/~/ часовой пояс 2799 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2800 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2801 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2802 - { 2803 - "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 - Срок действия правила истек 2804 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2805 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2806 - "additionalProp1": "string", 2807 - "additionalProp2": "string", 2808 - "additionalProp3": "string" 2809 - } 2810 - } 2811 - ] 2360 + "parentId": "" ~/~/ id клиента 2812 2812 } 2813 2813 2363 +Ответ: 2364 + 2365 +[ 2366 + { 2367 + "id": 0, ~/~/ ID уведомления 2368 + "name": "string", ~/~/ Название уведомления 2369 + "active": true, ~/~/ Состояние true - активен, false - деактивирован 2370 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2371 + "userId": "", ~/~/ Пользователь, создавший уведомление 2372 + "parentId": "", ~/~/ Идентификатор клиента 2373 + "parentName": "string" ~/~/ Имя клиента 2374 + } 2375 +] 2376 + 2814 2814 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2815 2815 2816 2816 (% class="box infomessage" %) ... ... @@ -2952,32 +2952,6 @@ 2952 2952 2953 2953 Success 2954 2954 2955 - 2956 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2957 - 2958 -(% class="box warningmessage" %) 2959 -((( 2960 -**PUT** /api/v3/notifications/prolongation 2961 -))) 2962 - 2963 -Метод позволяет продлить уведомления. 2964 - 2965 -Метод запроса **PUT** 2966 - 2967 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2968 - 2969 -В заголовках запроса: X-Auth: Токен авторизации. 2970 - 2971 -Тело запроса: 2972 - 2973 -[ 2974 - 2975 -0 2976 - 2977 -] 2978 - 2979 -где 0 идентификатор ids. 2980 - 2981 2981 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2982 2982 2983 2983 (% class="box errormessage" %) ... ... @@ -4028,12 +4028,16 @@ 4028 4028 Тело запроса: 4029 4029 4030 4030 { 4031 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4032 - "Balance": 0 ~/~/ Значение баланса.3568 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3569 + "Balance": 0 4033 4033 } 4034 4034 4035 4035 Ответ: Success 4036 4036 3574 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3575 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3576 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3577 + 4037 4037 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4038 4038 4039 4039 (% class="box warningmessage" %) ... ... @@ -4045,29 +4045,16 @@ 4045 4045 4046 4046 Тело запроса: 4047 4047 4048 -((( 4049 4049 { 4050 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4051 - "a mount": 0~/~/ Сумма пополнения баланса3590 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3591 + "Balance": 0 4052 4052 } 4053 -))) 4054 4054 4055 -((( 4056 - 4057 -))) 4058 - 4059 4059 Ответ: Success 4060 4060 4061 -((( 4062 -{ 4063 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4064 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4065 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4066 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4067 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4068 - "Description": "string" ~/~/ Описание корректировки. 4069 -} 4070 -))) 3596 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3597 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3598 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4071 4071 4072 4072 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4073 4073 ... ... @@ -4080,25 +4080,16 @@ 4080 4080 4081 4081 Тело запроса: 4082 4082 4083 -((( 4084 4084 { 4085 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4086 - "a mount": 0~/~/ Сумма списания с баланса3612 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3613 + "Balance": 0 4087 4087 } 4088 -))) 4089 4089 4090 4090 Ответ: Success 4091 4091 4092 -((( 4093 -{ 4094 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4095 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4096 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4097 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4098 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4099 - "Description": "string" ~/~/ Описание корректировки 4100 -} 4101 -))) 3618 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3619 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3620 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4102 4102 4103 4103 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4104 4104 ... ... @@ -4109,35 +4109,28 @@ 4109 4109 4110 4110 Тело запроса: 4111 4111 4112 -((( 4113 4113 { 4114 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4115 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4116 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4117 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4118 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4119 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 3632 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3633 + "CalculationType": 0, 3634 + "PermissibleBalance": 0, 3635 + "DefermentDays": 0, 3636 + "SendUiNotifications": true, 3637 + "SendEmailNotifications": true, 3638 + "IsPrivate": true, 4120 4120 } 4121 -))) 4122 4122 4123 -((( 4124 - 4125 -))) 4126 - 4127 4127 Ответ: Success 4128 4128 4129 -((( 4130 -{ 4131 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4132 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4133 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4134 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4135 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4136 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4137 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4138 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4139 -} 3643 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3644 +|ClientId|Идентификатор клиента 3645 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 3646 +|PermissibleBalance|Допустимый баланс 3647 +|DefermentDays|((( 3648 +Отсрочка, количество дней 4140 4140 ))) 3650 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 3651 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 3652 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4141 4141 4142 4142 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4143 4143 ... ... @@ -4149,68 +4149,35 @@ 4149 4149 Тело запроса: 4150 4150 4151 4151 { 4152 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4153 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4154 - "Features": [ ~/~/ Набор услуг по тарифу клиента.3664 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3665 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3666 + "Features": [ 4155 4155 { 4156 - "Feature": "string", ~/~/ Код услуги.4157 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4158 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4159 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4160 - "Price": 0, ~/~/ Цена за единицу.4161 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4162 - "PeriodValue": 0, ~/~/ Значение периода.4163 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)3668 + "Feature": "string", 3669 + "IsEnabled": true, 3670 + "IsFactual": true, 3671 + "Limit": 0, 3672 + "Price": 0, 3673 + "DebitDate": "2023-10-18T13:26:58.987Z", 3674 + "PeriodValue": 0, 3675 + "PeriodType": 0 4164 4164 } 4165 4165 ] 4166 4166 } 4167 4167 4168 - 4169 4169 Ответ: Success 4170 4170 4171 -((( 4172 -{ 4173 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4174 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4175 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4176 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4177 - "Name": "string", ~/~/ Наименование. 4178 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4179 - "Constraint": { ~/~/ Ограничения по тарифу 4180 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4181 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4182 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4183 - }, 4184 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4185 - { 4186 - "Feature": "string", ~/~/Код услуги. 4187 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4188 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4189 - "Price": 0, ~/~/ Цена за единицу. 4190 - "PeriodValue": 0, ~/~/ Значение периода. 4191 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4192 - } 4193 - ], 4194 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4195 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4196 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4197 - }, 4198 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4199 - { 4200 - "Feature": "string", ~/~/ Код услуги. 4201 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4202 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4203 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4204 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4205 - "Price": 0, ~/~/ Цена за единицу. 4206 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4207 - "PeriodValue": 0, ~/~/ Значение периода. 4208 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4209 - "Quantity": 0 ~/~/ Количество использования услуги. 4210 - } 4211 - ] 4212 -} 4213 -))) 3682 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3683 +|ClientId|Идентификатор клиента 3684 +|PlanId|Идентификатор тарифного плана 3685 +|Feature|Код услуги 3686 +|IsEnabled|Признак, определяющий активирована ли услуга 3687 +|IsFactual|Признак, определяющий расчёт по факту 3688 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 3689 +|Price|Цена за единицу. 3690 +|DebitDate|Следующий момент времени списания с баланса за услугу. 3691 +|PeriodValue|Значение периода. 3692 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4214 4214 4215 4215 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4216 4216 ... ... @@ -4315,43 +4315,6 @@ 4315 4315 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4316 4316 |msgCount|Кол-во обработанных сообщений всего 4317 4317 4318 -== **Импортировать историю ТС (Асинхронный запрос)** == 4319 - 4320 -(% class="box successmessage" %) 4321 -((( 4322 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4323 -))) 4324 - 4325 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4326 - 4327 -Метод запроса: **POST** 4328 - 4329 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4330 - 4331 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4332 - 4333 - 4334 -Ответ: 4335 - 4336 -{ 4337 - 4338 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4339 - 4340 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4341 - 4342 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4343 - 4344 - "Message": "string", ~/~/ Информация о выполнении запроса 4345 - 4346 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4347 - 4348 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4349 - 4350 - "Data": "string" ~/~/ Данные 4351 - 4352 -} 4353 - 4354 - 4355 4355 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4356 4356 4357 4357 (% class="box infomessage" %) ... ... @@ -4369,59 +4369,10 @@ 4369 4369 "message": "string" 4370 4370 } 4371 4371 4372 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4373 -**Параметр** 4374 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4375 -**Описание** 4376 -))) 4377 -|((( 4378 -activity 4379 -)))|((( 4380 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4381 -))) 4382 -|((( 4383 -progress 4384 -)))|((( 4385 -Guid ТС 4386 -))) 3814 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3815 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 3816 +|progress|Guid ТС 4387 4387 4388 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4389 - 4390 -(% class="box infomessage" %) 4391 -((( 4392 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4393 -))) 4394 - 4395 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4396 - 4397 -Метод запроса: **GET** 4398 - 4399 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4400 - 4401 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4402 - 4403 - 4404 -Ответ: 4405 - 4406 -{ 4407 - 4408 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4409 - 4410 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4411 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4412 - 4413 - "Message": "string", ~/~/ Информация о выполнении запроса 4414 - 4415 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4416 - 4417 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4418 - 4419 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4420 - 4421 - "Data": "string" ~/~/ Данные 4422 - 4423 -} 4424 - 4425 4425 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4426 4426 4427 4427 (% class="box infomessage" %) ... ... @@ -4503,67 +4503,64 @@ 4503 4503 Тело запроса: 4504 4504 4505 4505 { 4506 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4507 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4508 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса3899 + "vehicleIds": [vehicleId], 3900 + "from": "2023-11-22T09:29:48.051Z", 3901 + "to": "2023-11-22T09:29:48.051Z" 4509 4509 } 4510 4510 3904 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3905 +|vehicleIds|Массив ID объектов 3906 +|from|Дата начала запроса 3907 +|to|Дата окончания запроса 3908 + 4511 4511 Ответ: 4512 4512 4513 4513 { 4514 - "items": [ ~/~/ Список в разрезе ТС3912 + "items": [ 4515 4515 { 4516 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4517 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4518 - "vehicleId": 0, ~/~/ ID ТС4519 - "vehicleName": "string", ~/~/ Название ТС4520 - "vehicleModel": "string", ~/~/ Модель ТС4521 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4522 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4523 - "totalViolations": 0, ~/~/ Нарушений всего4524 - "violationsByType": { ~/~/ Информация о нарушениях по типу4525 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4526 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4527 - "brakingViolations": 0, ~/~/ Нарушений торможения4528 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4529 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4530 - "sensorViolations": 0 ~/~/ Нарушений по датчику3914 + "from": "2023-11-22T09:29:48.052Z", 3915 + "to": "2023-11-22T09:29:48.052Z", 3916 + "vehicleId": 0, 3917 + "vehicleName": "string", 3918 + "vehicleModel": "string", 3919 + "penalty": 0, 3920 + "score": 0, 3921 + "totalViolations": 0, 3922 + "violationsByType": { 3923 + "overspeedingViolations": 0, 3924 + "accelerationViolations": 0, 3925 + "brakingViolations": 0, 3926 + "turningViolations": 0, 3927 + "dangerousDrivingViolations": 0, 3928 + "sensorViolations": 0 4531 4531 }, 4532 - 4533 -((( 4534 - 4535 -))) 4536 - 4537 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4538 - "mileage": 0, ~/~/ Пробег, м 4539 - "tripsCount": 0, ~/~/ Кол-во рейсов 4540 - "trips": [ ~/~/ Информация по рейсу 3930 + "moveTime": 0, 3931 + "mileage": 0, 3932 + "tripsCount": 0, 3933 + "trips": [ 4541 4541 { 4542 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4543 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4544 - "violationsCount": 0, ~/~/ Всего нарушений4545 - "violationsByType": { ~/~/ Информация о нарушениях по типу4546 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4547 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4548 - "brakingViolations": 0, ~/~/ Нарушений торможения4549 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4550 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4551 - "sensorViolations": 0 ~/~/ Нарушений по датчику3935 + "penalty": 0, 3936 + "score": 0, 3937 + "violationsCount": 0, 3938 + "violationsByType": { 3939 + "overspeedingViolations": 0, 3940 + "accelerationViolations": 0, 3941 + "brakingViolations": 0, 3942 + "turningViolations": 0, 3943 + "dangerousDrivingViolations": 0, 3944 + "sensorViolations": 0 4552 4552 }, 4553 - 4554 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4555 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4556 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4557 - "mileage": 0, ~/~/ Пробег, м 4558 - "motohours": 0, ~/~/ Моточасы, секунды 4559 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4560 - "startAddress": "string", ~/~/ Адрес начала рейса 4561 - "endAddress": "string", ~/~/ Адрес конца рейса 4562 - "drivers": [ ~/~/ Список водителей 3946 + "moveTime": 0, 3947 + "mileage": 0, 3948 + "motohours": 0, 3949 + "maxSpeed": 0, 3950 + "startAddress": "string", 3951 + "endAddress": "string", 3952 + "drivers": [ 4563 4563 { 4564 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4565 - "driverName": "string", ~/~/ФИО водителя4566 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки3954 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3955 + "driverName": "string", 3956 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4567 4567 } 4568 4568 ] 4569 4569 } ... ... @@ -4572,6 +4572,34 @@ 4572 4572 ] 4573 4573 } 4574 4574 3965 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3966 +|from|Дата начала запроса 3967 +|to|Дата окончания 3968 +|vehicleId|ID объекта 3969 +|vehicleName|Имя объекта 3970 +|vehicleModel|Модель объекта 3971 +|penalty|Сумма штрафных баллов 3972 +|score|Оценка 3973 +|totalViolations|Суммарное количество нарушений 3974 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 3975 +|overspeedingViolations|Превышение скорости 3976 +|accelerationViolations|Ускорение 3977 +|brakingViolations|Торможение 3978 +|turningViolations|Резкий поворот 3979 +|dangerousDrivingViolations|Резкое вождение 3980 +|sensorViolations|Нарушение по датчику 3981 +|moveTime|Время в движении 3982 +|mileage|Пробег 3983 +|tripsCount|Количество рейсов 3984 +|motohours|Моточасы 3985 +|maxSpeed|Максимальная скорость 3986 +|startAddress|Адрес начала рейса 3987 +|endAddress|Адрес окончания рейса 3988 +|drivers|Список водителей, которые были на объекте в течениии рейса 3989 +|driverGuid|Guid водителя 3990 +|driverName|Имя водителя 3991 +|driverRfid|Номер Карты-метки 3992 + 4575 4575 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4576 4576 4577 4577 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == ... ... @@ -4580,7 +4580,7 @@ 4580 4580 4581 4581 (% class="box infomessage" %) 4582 4582 ((( 4583 - **POST /api/v3/fuelcards/transactions**4001 +POST /api/v3/fuelcards/transactions 4584 4584 ))) 4585 4585 4586 4586 Метод запроса: POST ... ... @@ -4591,59 +4591,34 @@ 4591 4591 Параметры в теле запроса (JSON): 4592 4592 4593 4593 { 4594 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ 4595 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ 4012 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4013 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4596 4596 "ids": [ 4597 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы4015 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4598 4598 ], 4599 - "timezone": 0 ~/~/ Часовойпояс4017 + "timezone": 0 ~/~/Таймзона 4600 4600 } 4601 4601 4602 4602 4603 4603 Ответ: 4604 4604 { 4605 - "date": "2024-04-11T10:41:02.265Z", ~/~/ 4606 - "driver": "string", ~/~/ 4607 - "object": "string", ~/~/ 4608 - "amount": 0, ~/~/ 4609 - "amountDut": 0, ~/~/ 4610 - "amountDiff": 0, ~/~/ 4611 - "amountDiffPerc": 0, ~/~/ 4612 - "summa": 0, ~/~/ 4613 - "serviceName": "string", ~/~/ 4614 - "price": 0, ~/~/ 4615 - "cardName": "string", ~/~/ 4616 - "cardNum": "string", ~/~/ 4617 - "operator": "string", ~/~/ 4618 - "address": "string" ~/~/ 4023 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4024 + "driver": "string", ~/~/Водители, привязанные к ТК 4025 + "object": "string", ~/~/Наименование ТС 4026 + "amount": 0, ~/~/Количество топлива 4027 + "amountDut": 0, ~/~/Количество по ДУТ 4028 + "amountDiff": 0, ~/~/Разница, л 4029 + "amountDiffPerc": 0, ~/~/Разница, % 4030 + "summa": 0, ~/~/Стоимость, руб 4031 + "serviceName": "string", ~/~/Тип топлива 4032 + "price": 0, ~/~/Цена за литр, руб 4033 + "cardName": "string", ~/~/Наименование ТК 4034 + "cardNum": "string", ~/~/Номер ТК 4035 + "operator": "string", ~/~/Оператор ТК 4036 + "address": "string" ~/~/Адрес АЗС 4619 4619 } 4620 4620 4621 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4622 4622 4623 -(% class="box infomessage" %) 4624 -((( 4625 -**GET /api/v3/fuelcards** 4626 -))) 4627 - 4628 -Метод запроса: GET 4629 - 4630 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4631 - 4632 -Ответ: 4633 - 4634 -[ 4635 - { 4636 - "Name": "string", ~/~/ Определяет наименование карты. 4637 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4638 - "Number": "string", ~/~/ Определяет № карты. 4639 - "Enabled": true, ~/~/ Определяет признак активности карты. 4640 - "Description": "string", ~/~/ Определяет описание карты. 4641 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4642 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4643 - "deleted": true ~/~/ Признак удаления 4644 - } 4645 -] 4646 - 4647 4647 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4648 4648 4649 4649 ... ... @@ -4654,28 +4654,28 @@ 4654 4654 **GET ** **/api/v3/retranslations/{id}** 4655 4655 ))) 4656 4656 4657 - id -Идентификаторретранслятора4050 +Идентификатор запроса: ID 4658 4658 4659 4659 4660 4660 Пример ответа: 4661 4661 4662 4662 { 4663 -"description": "", ~/~/ Поле описания ретранслятора4664 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)4665 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4666 -"isEnabled": true, ~/~/ Признак включенияретранслятора, Включен, true - включен, false - отключен4667 -"address": "string", ~/~/ Адрес и портпринимающего сервера4668 -"objects": [ ~/~/ 4056 +"description": "", ~/~/ Определяет описание 4057 +"subscriberId": "", ~/~/ Подписчик 4058 +"protocolType": 0, ~/~/ Тип протокола 4059 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4060 +"address": "string", ~/~/ Адрес события 4061 +"objects": [ ~/~/Объекты для ретрансляции 4669 4669 { 4670 4670 "id": "", ~/~/ Идентификатор объекта ретрансляции 4671 4671 "name": "", ~/~/ Наименование объекта ретрансляции 4672 -"imei": "", ~/~/ IMEI объекта ретрансляции4673 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4065 +"imei": "", ~/~/ IMEI объекта 4066 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4674 4674 } 4675 4675 ], 4676 -"id": "", ~/~/ Идентификаторретранслятора4677 -"parentId": "", ~/~/ Идентификаторродителя(вышестоящего клиента)4678 -"deleted": "" ~/~/ Признак удаления ретранслятора:true - включен, false - отключен4069 +"id": "", ~/~/ идентификатор пользователя 4070 +"parentId": "", ~/~/Guid родителя 4071 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4679 4679 } 4680 4680 4681 4681 ... ... @@ -4686,7 +4686,7 @@ 4686 4686 **DELETE** **/api/v3/retranslations/{id}** 4687 4687 ))) 4688 4688 4689 - id - Идентификаторретранслятора4082 +Параметр запроса: ID 4690 4690 4691 4691 4692 4692 == **Создание ретранслятора** == ... ... @@ -4699,16 +4699,16 @@ 4699 4699 Запрос: 4700 4700 4701 4701 { 4702 -"description": "", ~/~/ Поле описания ретранслятора4703 -"subscriberId": "", ~/~/ Идентификатор подписчика4704 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4705 -"address": "", ~/~/ Адрес и портпринимающегосервера4706 -"isEnabled": "", ~/~/ Признакретранслятора, true - включен, false - отключен4095 +"description": "", ~/~/ Описание 4096 +"subscriberId": "", ~/~/ Подписчик 4097 +"protocolType": 0, ~/~/ Тип протокола 4098 +"address": "", ~/~/ Адрес ретрансляции 4099 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4707 4707 "objects": [ ~/~/Объекты для ретрансляции 4708 4708 { 4709 -"id": "", ~/~/ Идентификаторретранслятора4710 -"imei": "", ~/~/ ретрансляции4711 -"isEnabled": "" ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4102 +"id": "", ~/~/ идентификатор пользователя 4103 +"imei": "", ~/~/IMEI объекта 4104 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4712 4712 } 4713 4713 ] 4714 4714 } ... ... @@ -4717,22 +4717,22 @@ 4717 4717 Ответ: 4718 4718 4719 4719 { 4720 -"description": "", ~/~/ Поле описания ретранслятора4721 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4722 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4723 -"isEnabled": true, ~/~/Признакретранслятора:true - включен, false - отключен4724 -"address": " string", ~/~/ Адреси портпринимающего сервера4725 -"objects": [ 4113 +"description": "string", ~/~/ Определяет описание 4114 +"subscriberId": "", ~/~/ идентификатор запроса 4115 +"protocolType": 0, ~/~/ Тип протокола 4116 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4117 +"address": "", ~/~/ Адрес события 4118 +"objects": [ ~/~/Объекты для ретрансляции 4726 4726 { 4727 -"id": "", ~/~/ Идентификатор объектаретрансляции4728 -"name": "string", ~/~/ На именование объекта ретрансляции4729 -"imei": "", ретрансляции4730 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4120 +"id": "", ~/~/ идентификатор пользователя 4121 +"name": "string", ~/~/ Название уведомления 4122 +"imei": "string", ~/~/IMEI объекта 4123 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4731 4731 } 4732 - ], 4733 -"id": "", ~/~/ Идентификаторретранслятора4734 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4735 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4125 + ], 4126 +"id": "", ~/~/ идентификатор пользователя 4127 +"parentId": "", ~/~/ Guid идентификатор родителя 4128 +"deleted": true ~/~/ Признак удаления 4736 4736 } 4737 4737 4738 4738 ... ... @@ -4746,18 +4746,18 @@ 4746 4746 Пример запроса: 4747 4747 4748 4748 { 4749 -"id": "", ~/~/ Идентификаторретранслятора4750 -"description": "string", ~/~/ Поле описания ретранслятора4751 -"subscriberId": "", ~/~/ Идентификатор подписчика4752 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4753 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4754 -"address": "string", ~/~/ Адрес и портпринимающего сервера4755 -"objects": ~/~/ 4142 +"id": "", ~/~/ идентификатор пользователя 4143 +"description": "string", ~/~/ Определяет описание 4144 +"subscriberId": "", ~/~/ идентификатор запроса 4145 +"protocolType": 0, ~/~/ Тип протокола 4146 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4147 +"address": "string", ~/~/ Адрес события 4148 +"objects": ~/~/Объекты для ретрансляции 4756 4756 [ 4757 4757 { 4758 -"id": "", ~/~/ Идентификатор объектаретрансляции4759 -"imei": "", ~/~/ ретрансляции4760 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4151 +"id": "", ~/~/ идентификатор пользователя 4152 +"imei": "", ~/~/IMEI объекта 4153 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4761 4761 } 4762 4762 ] 4763 4763 } ... ... @@ -4766,22 +4766,22 @@ 4766 4766 Пример ответа: 4767 4767 4768 4768 { 4769 -"description": "", ~/~/ Поле описания ретранслятора4770 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4771 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4772 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4773 -"address": "string", ~/~/ Адрес и портпринимающего сервера4774 -"objects": [ ~/~/ 4162 +"description": "", ~/~/ Определяет описание 4163 +"subscriberId": "", ~/~/ идентификатор запроса 4164 +"protocolType": 0, ~/~/ Тип протокола 4165 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4166 +"address": "string", ~/~/ Адрес события 4167 +"objects": [ ~/~/Объекты для ретрансляции 4775 4775 { 4776 -"id": "", ~/~/ Идентификатор объектаретрансляции4777 -"name": "string", ~/~/ На именование объекта ретрансляции4778 -"imei": "", ~/~/ ретрансляции4779 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4169 +"id": "", ~/~/ идентификатор пользователя 4170 +"name": "string", ~/~/ Название уведомления 4171 +"imei": "", ~/~/IMEI объекта 4172 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4780 4780 } 4781 4781 ], 4782 -"id": "", ~/~/ Идентификаторретранслятора4783 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4784 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4175 +"id": "", ~/~/ идентификатор пользователя 4176 +"parentId": "", ~/~/ Guid идентификатор родителя 4177 +"deleted": true ~/~/ Признак удаления 4785 4785 } 4786 4786 4787 4787 ... ... @@ -4795,9 +4795,9 @@ 4795 4795 Пример запроса: 4796 4796 4797 4797 { 4798 -"id": "", ~/~/ Идентификаторретранслятора4799 -"search": "string", ~/~/ 4800 -"parentId": "" ~/~/ Идентификатор родительскогоагента, для которого надо получить данные(обязательный параметр).4191 +"id": "", ~/~/ идентификатор пользователя 4192 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4193 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4801 4801 } 4802 4802 4803 4803 Ответ: ... ... @@ -4804,14 +4804,14 @@ 4804 4804 4805 4805 [ 4806 4806 { 4807 -"description": "", ~/~/ Поле описания ретранслятора4808 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4809 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4810 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4811 -"address": "string", ~/~/ Адрес и портпринимающего сервера4812 -"id": "", ~/~/ Идентификаторретранслятора4813 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4814 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4200 +"description": "", ~/~/ Определяет описание 4201 +"subscriberId": "", ~/~/ идентификатор запроса 4202 +"protocolType": 0, ~/~/ Тип протокола 4203 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4204 +"address": "string", ~/~/ Адрес события 4205 +"id": "", ~/~/ идентификатор пользователя 4206 +"parentId": "", ~/~/ Guid идентификатор родителя 4207 +"deleted": true ~/~/ Признак удаления 4815 4815 } 4816 4816 ] 4817 4817 ... ... @@ -4822,7 +4822,7 @@ 4822 4822 4823 4823 (% class="box infomessage" %) 4824 4824 ((( 4825 - **POST /api/v3/Reports/harvesterUnloading**4218 +POST **/api/v3/Reports/harvesterUnloading** 4826 4826 ))) 4827 4827 4828 4828 Пример запроса: ... ... @@ -4894,743 +4894,7 @@ 4894 4894 ] 4895 4895 4896 4896 4897 -== **Отчет трек-датчики** == 4898 - 4899 -(% class="box infomessage" %) 4900 -((( 4901 -**POST /api/v3/Reports/sensorsWorks** 4902 -))) 4903 - 4904 -**Пример запроса:** 4905 - 4906 -{ 4907 - "vehicleIds": [ ~/~/ Список ID объектов 4908 - 0 4909 - ], 4910 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4911 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4912 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4913 -} 4914 - 4915 -**Пример ответа:** 4916 - 4917 -((( 4918 -{ 4919 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4920 - { 4921 - "vehicleId": 0, ~/~/ Идентификатор ТС 4922 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4923 - { 4924 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4925 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4926 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4927 - "name": "string", ~/~/ Наименование оборудования. 4928 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4929 - "totalMileage": 0, ~/~/ Общий пробег. 4930 - "avgSpeed": 0 ~/~/ Средняя скорость. 4931 - } 4932 - ] 4933 - } 4934 - ] 4935 -} 4936 - 4937 - 4938 -== **Превышение скорости** == 4939 - 4940 -(% class="box infomessage" %) 4941 -((( 4942 -**POST /api/v3/Reports/overSpeedDuration** 4943 -))) 4944 - 4945 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 4946 - 4947 -Пример запроса: 4948 - 4949 -((( 4950 -{ 4951 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 4952 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 4953 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 4954 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4955 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 4956 -} 4957 -))) 4958 - 4959 -((( 4960 - 4961 -))) 4962 - 4963 -((( 4964 -Пример ответа: 4965 -))) 4966 - 4967 -((( 4968 -((( 4969 -[ 4970 - { 4971 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 4972 - "duration": 0, ~/~/ Продолжительность события в секундах 4973 - "maxSpeed": 0, ~/~/ Максимальная скорость 4974 - "speedLimit": 0 ~/~/ Ограничение скорости 4975 - } 4976 -] 4977 -))) 4978 -))) 4979 -))) 4980 - 4981 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4982 - 4983 - 4984 -== **Запрос списка полей** == 4985 - 4986 -(% class="box successmessage" %) 4987 -((( 4988 -**POST /api/v3/agroLands/find** 4989 -))) 4990 - 4991 -Пример запроса: 4992 - 4993 -((( 4994 -((( 4995 -((( 4996 -{ 4997 - "year": 0, ~/~/ Фильтр по году 4998 - "name": "string", ~/~/ Фильтр по названию 4999 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 5000 -} 5001 -))) 5002 -))) 5003 - 5004 - 5005 -))) 5006 - 5007 -Пример ответа: 5008 - 5009 -((( 5010 -[ 5011 - { 5012 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5013 - "year": 0, ~/~/ Год поля 5014 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 5015 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 5016 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5017 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5018 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5019 - "counts": { ~/~/ Счётчики с/х поля 5020 - "fieldOperations": 0, ~/~/ Количество операций на поле 5021 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5022 - "facts": 0 ~/~/ Счётчик факта 5023 - }, 5024 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5025 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5026 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5027 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5028 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5029 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5030 - "planComment": "string", ~/~/ Комментарий к полю 5031 - "productivity": 0, ~/~/ Урожайность. 5032 - "id": 0, ~/~/ Идентификатор объекта геозоны 5033 - "name": "string", ~/~/ Название объекта геозоны 5034 - "type": 0, ~/~/ Тип объекта геозоны 5035 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5036 - "fname": "string", ~/~/ Имя файла 5037 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5038 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 5039 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 5040 - "description": "string", ~/~/ Описание объекта геозоны 5041 - "area": 0, ~/~/ Площадь, м2 5042 - "perimetr": 0, ~/~/ Периметр, м 5043 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 5044 - } 5045 -] 5046 - 5047 - 5048 -== **Создание нового поля ** == 5049 - 5050 -(% class="box successmessage" %) 5051 -((( 5052 -**POST /api/v3/agroLands** 5053 -))) 5054 - 5055 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 5056 -X-agent - ID клиента 5057 - 5058 -Пример запроса: 5059 - 5060 -((( 5061 -{ 5062 - "extId": "string", 5063 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля 5064 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля 5065 - "display": "string", ~/~/ Настройки отображения 5066 - "year": 0, ~/~/ Год поля 5067 - "name": "string", ~/~/ Наименование 5068 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5069 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая 5070 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая 5071 - "planComment": "string", ~/~/ Комментарий к полю 5072 - "cropRotations": [ ~/~/ Данные по севообороту 5073 - { 5074 - "landId": 0, ~/~/ ID поля 5075 - "landName": "string", ~/~/ Название поля 5076 - "year": 0, ~/~/ Год урожая 5077 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5078 - "cultureName": "string", ~/~/ Название культуры 5079 - "productivity": 0, ~/~/ Урожайность 5080 - "area": 0, ~/~/ Площадь поля, Га 5081 - "total": 0, ~/~/ Валовый сбор 5082 - "productivityFact": 0, ~/~/ Фактическая урожайность 5083 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5084 - "totalFact": 0, ~/~/ Фактический валовый сбор 5085 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ 5086 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева 5087 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая 5088 - "isyearplan": true, ~/~/ Годовой план 5089 - "comment": "string" ~/~/ Комментарий 5090 - } 5091 - ] 5092 -} 5093 -))) 5094 - 5095 -((( 5096 - 5097 -))) 5098 - 5099 -Пример ответа: 5100 - 5101 -((( 5102 -((( 5103 -{ 5104 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5105 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5106 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5107 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5108 - "cropRotations": [ ~/~/ Данные по севообороту 5109 - { 5110 - "landId": 0, ~/~/ ID поля 5111 - "landName": "string", ~/~/ Название поля 5112 - "year": 0, ~/~/ Год урожая 5113 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5114 - "cultureName": "string", ~/~/ Название культуры 5115 - "productivity": 0, ~/~/ Урожайность 5116 - "area": 0, ~/~/ Площадь поля, Га. 5117 - "total": 0, ~/~/ Валовый сбор 5118 - "productivityFact": 0, ~/~/ Фактическая урожайность 5119 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5120 - "totalFact": 0, ~/~/ Фактический валовый сбор 5121 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ 5122 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева 5123 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая 5124 - "isyearplan": true, ~/~/ годовой план 5125 - "comment": "string" ~/~/ Комментарий 5126 - } 5127 - ], 5128 - "cropVegetation": [ ~/~/ История вегетации поля 5129 - { 5130 - "values": [ ~/~/ Данные вегетации и состояния посева 5131 - { 5132 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5133 - "ndvi": 0 ~/~/ Индекс вегетации 5134 - } 5135 - ], 5136 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5137 - { 5138 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5139 - "type": "string", ~/~/ Тип 5140 - "pictureid": "string" ~/~/ Идентификатор ресурса 5141 - } 5142 - ], 5143 - "states": [ ~/~/ Ключевые даты развития поля 5144 - { 5145 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5146 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5147 - } 5148 - ] 5149 - } 5150 - ], 5151 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая 5152 - "counts": { 5153 - "fieldOperations": 0, ~/~/ Количество операций на поле 5154 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5155 - "facts": 0 ~/~/ Счётчик факта 5156 - }, 5157 - "planComment": "string", ~/~/ Комментарий к полю 5158 -))) 5159 - 5160 -((( 5161 - "productivity": 0, ~/~/ Урожайность. 5162 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5163 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая 5164 - "year": 0, ~/~/ Год поля 5165 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5166 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5167 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5168 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5169 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто 5170 - "id": 0, ~/~/ Идентификатор объекта геозоны 5171 - "name": "string", ~/~/ Название объекта геозоны 5172 - "type": 0, ~/~/ Тип объекта геозоны 5173 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5174 - "fname": "string", ~/~/ Имя файла 5175 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5176 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны 5177 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны 5178 - "description": "string", ~/~/ Описание объекта геозоны 5179 - "area": 0, ~/~/ Площадь, м2 5180 - "perimetr": 0, ~/~/ Периметр, м 5181 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5182 -} 5183 - 5184 - 5185 -))) 5186 -))) 5187 -))) 5188 - 5189 -== **Получение поля по id** == 5190 - 5191 -(% class="box infomessage" %) 5192 -((( 5193 -**GET /api/v3/agroLands/{id}** 5194 -))) 5195 - 5196 -Пример запроса: 5197 -id ~/~/ Идентификатор поля 5198 - 5199 -Пример ответа: 5200 - 5201 -((( 5202 -{ 5203 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5204 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5205 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5206 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5207 - "cropRotations": [ ~/~/ Данные по севообороту 5208 - { 5209 - "landId": 0, ~/~/ ID поля 5210 - "landName": "string", ~/~/ Название поля 5211 - "year": 0, ~/~/ Год урожая 5212 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5213 - "cultureName": "string", ~/~/ Название культуры 5214 - "productivity": 0, ~/~/ Урожайность 5215 - "area": 0, ~/~/ Площадь поля, Га 5216 - "total": 0, ~/~/ Валовый сбор 5217 - "productivityFact": 0, ~/~/ Фактическая урожайность 5218 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5219 - "totalFact": 0, ~/~/ Фактический валовый сбор 5220 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5221 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5222 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5223 - "isyearplan": true, ~/~/ План года 5224 - "comment": "string" ~/~/ Комментарий 5225 - } 5226 - ], 5227 - "cropVegetation": [ ~/~/ История вегетации поля 5228 - { 5229 - "values": [ ~/~/ Данные вегетации и состояния посева 5230 - { 5231 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5232 - "ndvi": 0 ~/~/ Индекс вегетации 5233 - } 5234 - ], 5235 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5236 - { 5237 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5238 - "type": "string", ~/~/ Тип 5239 - "pictureid": "string" ~/~/ Идентификатор ресурса 5240 - } 5241 - ], 5242 - "states": [ ~/~/ Ключевые даты развития поля 5243 - { 5244 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5245 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5246 - } 5247 - ] 5248 - } 5249 - ], 5250 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5251 - "counts": { 5252 - "fieldOperations": 0, ~/~/ Количество операций на поле 5253 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5254 - "facts": 0 ~/~/ Счётчик факта 5255 - }, 5256 - "planComment": "string", ~/~/ Комментарий к полю 5257 - "productivity": 0, ~/~/ Урожайность. 5258 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5259 -))) 5260 - 5261 -((( 5262 -((( 5263 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5264 - "year": 0, ~/~/ Год поля 5265 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5266 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5267 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5268 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5269 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5270 - "id": 0, ~/~/ Идентификатор объекта геозоны 5271 - "name": "string", ~/~/ Название объекта геозоны 5272 - "type": 0, ~/~/ Тип объекта геозоны 5273 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5274 - "fname": "string", ~/~/ Имя файла 5275 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5276 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5277 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5278 - "description": "string", ~/~/ Описание объекта геозоны 5279 - "area": 0, ~/~/ Площадь, м2 5280 - "perimetr": 0, ~/~/ Периметр, м 5281 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5282 -} 5283 -))) 5284 - 5285 - 5286 -((( 5287 -((( 5288 -((( 5289 -== **Изменение поля** == 5290 - 5291 -(% class="box infomessage" %) 5292 -((( 5293 -**PUT /api/v3/agroLands** 5294 -))) 5295 - 5296 -Пример запроса: 5297 - 5298 -((( 5299 -((( 5300 -{ 5301 - "id": 0, ~/~/ Идентификатор поля 5302 - "extId": "string", ~/~/ ExtId 5303 - "shape": "string", ~/~/ Форма поля 5304 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5305 - "display": "string", ~/~/ Настройки отображения 5306 - "year": 0, ~/~/ Год поля 5307 - "name": "string", ~/~/ Наименование 5308 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5309 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая 5310 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая 5311 - "planComment": "string", ~/~/Комментарий к полю 5312 - "cropRotations": [ ~/~/ Данные по севообороту 5313 - { 5314 - "landId": 0, ~/~/ ID поля 5315 - "landName": "string", ~/~/ Название поля 5316 - "year": 0, ~/~/ Год урожая 5317 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5318 - "cultureName": "string", ~/~/ Название культуры 5319 - "productivity": 0, ~/~/ Урожайность 5320 - "area": 0, ~/~/ Площадь поля, Га. 5321 - "total": 0, ~/~/ Валовый сбор 5322 - "productivityFact": 0, ~/~/ Фактическая урожайность 5323 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5324 - "totalFact": 0, ~/~/ Фактический валовый сбор 5325 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ 5326 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева 5327 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая 5328 - "isyearplan": true, 5329 - "comment": "string" ~/~/ Комментарий 5330 - } 5331 - ], 5332 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику 5333 -} 5334 -))) 5335 -))) 5336 - 5337 -((( 5338 - 5339 -))) 5340 - 5341 -Пример ответа: 5342 - 5343 -((( 5344 -((( 5345 -((( 5346 -{ 5347 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5348 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5349 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5350 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5351 - "cropRotations": [ ~/~/ Данные по севообороту 5352 - { 5353 - "landId": 0, ~/~/ ID поля 5354 - "landName": "string", ~/~/ Название поля 5355 - "year": 0, ~/~/ Год урожая 5356 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5357 - "cultureName": "string", ~/~/ Название культуры 5358 - "productivity": 0, ~/~/ Урожайность 5359 - "area": 0, ~/~/ Площадь поля, Га 5360 - "total": 0, ~/~/ Валовый сбор 5361 - "productivityFact": 0, ~/~/ Фактическая урожайность 5362 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5363 - "totalFact": 0, ~/~/ Фактический валовый сбор 5364 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ 5365 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева 5366 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая 5367 - "isyearplan": true, ~/~/ 5368 - "comment": "string" ~/~/ Комментарий 5369 - } 5370 - ], 5371 - "cropVegetation": [ ~/~/ История вегетации поля 5372 - { 5373 - "values": [ ~/~/ Данные вегетации и состояния посева 5374 - { 5375 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5376 - "ndvi": 0 ~/~/ Индекс вегетации 5377 - } 5378 - ], 5379 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5380 - { 5381 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5382 - "type": "string", ~/~/ Тип 5383 - "pictureid": "string" ~/~/ Идентификатор ресурса 5384 - } 5385 - ], 5386 - "states": [ ~/~/ Ключевые даты развития поля 5387 - { 5388 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5389 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5390 - } 5391 - ] 5392 - } 5393 - ], 5394 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая 5395 - "counts": { 5396 - "fieldOperations": 0, ~/~/ Количество операций на поле 5397 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5398 - "facts": 0 ~/~/ Счётчик факта 5399 - }, 5400 - "planComment": "string", ~/~/ Комментарий к полю 5401 - "productivity": 0, ~/~/ Урожайность. 5402 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5403 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая 5404 - "year": 0, ~/~/ Год поля 5405 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5406 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5407 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5408 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5409 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5410 - "id": 0, ~/~/ Идентификатор объекта геозоны 5411 - "name": "string", ~/~/ Название объекта геозоны 5412 - "type": 0, ~/~/ Тип объекта геозоны 5413 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5414 - "fname": "string", ~/~/ Имя файла 5415 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5416 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны 5417 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны 5418 - "description": "string", ~/~/ Описание объекта геозоны 5419 - "area": 0, ~/~/ Площадь, м2 5420 - "perimetr": 0, ~/~/ Периметр, м 5421 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд 5422 -} 5423 -))) 5424 -))) 5425 -))) 5426 -))) 5427 -))) 5428 - 5429 - 5430 -== **Редактирование года урожая ** == 5431 - 5432 -(% class="box successmessage" %) 5433 -((( 5434 -**POST /api/v3/agroLands/updateOpenCloseYear** 5435 -))) 5436 - 5437 -Пример запроса: 5438 - 5439 -((( 5440 -((( 5441 -{ 5442 - "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5443 - 0 5444 - ], 5445 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5446 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5447 -} 5448 -))) 5449 - 5450 - 5451 -))) 5452 - 5453 -Пример ответа: 5454 - 5455 -((( 5456 -((( 5457 -{ 5458 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5459 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5460 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5461 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5462 - "cropRotations": [ ~/~/ Данные по севообороту 5463 - { 5464 - "landId": 0, ~/~/ ID поля 5465 - "landName": "string", ~/~/ Название поля 5466 - "year": 0, ~/~/ Год урожая 5467 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5468 - "cultureName": "string", ~/~/ Название культуры 5469 - "productivity": 0, ~/~/ Урожайность 5470 - "area": 0, ~/~/ Площадь поля, Га. 5471 - "total": 0, ~/~/ Валовый сбор 5472 - "productivityFact": 0, ~/~/ Фактическая урожайность 5473 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5474 - "totalFact": 0, ~/~/ Фактический валовый сбор 5475 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5476 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5477 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5478 - "isyearplan": true, ~/~/ 5479 - "comment": "string" ~/~/ Комментарий 5480 - } 5481 - ], 5482 - "cropVegetation": [ ~/~/ История вегетации поля 5483 - { 5484 - "values": [ ~/~/ Данные вегетации и состояния посева 5485 - { 5486 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5487 - "ndvi": 0 ~/~/ Индекс вегетации 5488 - } 5489 - ], 5490 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5491 - { 5492 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5493 - "type": "string", ~/~/ Тип 5494 - "pictureid": "string" ~/~/ Идентификатор ресурса 5495 - } 5496 - ], 5497 - "states": [ ~/~/ Ключевые даты развития поля 5498 - { 5499 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5500 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5501 - } 5502 - ] 5503 - } 5504 - ], 5505 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5506 - "counts": { 5507 - "fieldOperations": 0, ~/~/ Количество операций на поле 5508 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5509 - "facts": 0 ~/~/ Счётчик факта 5510 - }, 5511 - "planComment": "string", ~/~/ Комментарий к полю 5512 - "productivity": 0, ~/~/ Урожайность. 5513 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5514 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5515 - "year": 0, ~/~/ Год поля 5516 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5517 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5518 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5519 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5520 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5521 - "id": 0, ~/~/ Идентификатор объекта геозоны 5522 - "name": "string", ~/~/ Название объекта геозоны 5523 - "type": 0, ~/~/ Тип объекта геозоны 5524 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5525 - "fname": "string", ~/~/ Имя файла 5526 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5527 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5528 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5529 - "description": "string", ~/~/ Описание объекта геозоны 5530 - "area": 0, ~/~/ Площадь, м2 5531 - "perimetr": 0, ~/~/ ериметр, м 5532 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5533 -} 5534 - 5535 - 5536 -== **Какие поля посещал объект** == 5537 - 5538 -(% class="box successmessage" %) 5539 -((( 5540 -**POST /api/v3/agroLands/visitingByVehicle** 5541 -))) 5542 - 5543 -Пример запроса: 5544 - 5545 -{ 5546 - "vehicleId": 0, ~/~/ id объекта 5547 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5548 - "byTime": 0, ~/~/ Объединение событий по времени 5549 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5550 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5551 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5552 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5553 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5554 -} 5555 - 5556 -Пример ответа: 5557 - 5558 -[ 5559 - { 5560 - "fieldId": 0, ~/~/ id объекта 5561 - "vehicleName": "string", ~/~/ Наименование объекта 5562 - "fieldName": "string", ~/~/ Наименование поля 5563 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5564 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5565 - "vehicleId": 0, ~/~/ Идентификатор ТС 5566 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5567 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5568 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5569 - "mileage": 0 ~/~/ Пробег 5570 - } 5571 -] 5572 -))) 5573 - 5574 - 5575 -== **Посещение поля объектами ** == 5576 - 5577 -(% class="box successmessage" %) 5578 -((( 5579 -**POST /api/v3/agroLands/visitingByField** 5580 -))) 5581 - 5582 -Пример запроса: 5583 -{ 5584 - "fieldId": 0, ~/~/ ID поля 5585 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5586 - "byTime": 0, ~/~/ Объединение событий по времени 5587 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5588 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5589 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5590 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5591 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5592 -} 5593 - 5594 -Пример ответа: 5595 - 5596 -[ 5597 - { 5598 - "fieldId": 0, ~/~/ ID поля 5599 - "vehicleName": "string", ~/~/ Наименование объекта 5600 - "fieldName": "string", ~/~/ Имя поля 5601 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5602 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5603 - "vehicleId": 0, ~/~/ Идентификатор ТС 5604 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5605 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5606 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5607 - "mileage": 0 ~/~/ Пробег 5608 - } 5609 -] 5610 - 5611 - 5612 -== **Удаление существующего поля** == 5613 - 5614 -(% class="box errormessage" %) 5615 -((( 5616 -**DELETE /api/v3/agroLands/{id}** 5617 -))) 5618 - 5619 -Пример запроса: 5620 -id ~/~/ Идентификатор поля 5621 - 5622 -Пример ответа: 5623 - 5624 -((( 5625 -200 ~/~/ Успех 5626 - 5627 - 5628 -))) 5629 - 5630 5630 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5631 -))) 5632 -))) 5633 -))) 5634 5634 5635 5635 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5636 5636 ... ... @@ -5637,7 +5637,7 @@ 5637 5637 5638 5638 (% class="box infomessage" %) 5639 5639 ((( 5640 - **GET api/v3/Vehicles/recyclebin/all**4297 +GET api/v3/Vehicles/recyclebin/all 5641 5641 ))) 5642 5642 5643 5643 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5672,11 +5672,11 @@ 5672 5672 ] 5673 5673 5674 5674 5675 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==4332 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5676 5676 5677 5677 (% class="box infomessage" %) 5678 5678 ((( 5679 - **POST**4336 +POST/api/v3/Vehicles/recyclebin/erase 5680 5680 ))) 5681 5681 5682 5682 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5718,7 +5718,7 @@ 5718 5718 5719 5719 (% class="box infomessage" %) 5720 5720 ((( 5721 - **POST**4378 +POST/api/v3/Vehicles/recyclebin/restore 5722 5722 ))) 5723 5723 5724 5724 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5770,782 +5770,7 @@ 5770 5770 ] 5771 5771 5772 5772 5773 -= **Раздел: Журнал заданий ** = 5774 5774 5775 - 5776 -== **Создание задания в Журнале заданий** == 5777 - 5778 -(% class="box infomessage" %) 5779 -((( 5780 -**POST /api/v3/vehicletasks** 5781 -))) 5782 - 5783 -Пример запроса: 5784 - 5785 -((( 5786 -{ 5787 - "vehicleId": 0, ~/~/ Идентификатор ТС 5788 - "description": "string", ~/~/ Описание 5789 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5790 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5791 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5792 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5793 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5794 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5795 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5796 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5797 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5798 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5799 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5800 - "cost": { 5801 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5802 - "Name": "string", ~/~/ Наименование 5803 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5804 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5805 - "Norm": 0 ~/~/ Норма внесения 5806 - }, 5807 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5808 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5809 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5810 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5811 - "deleted": true, ~/~/ Признак удаления 5812 - "extId": "string", 5813 - "GeoIds": [ ~/~/ Cвязанные поля 5814 - 0 5815 - ] 5816 -} 5817 -))) 5818 - 5819 - 5820 -Пример ответа: 5821 - 5822 -{ 5823 - "vehicleId": 0, ~/~/ Идентификатор ТС 5824 - "description": "string", ~/~/ Описание 5825 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5826 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5827 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5828 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5829 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5830 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5831 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5832 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5833 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5834 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5835 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5836 - "cost": { 5837 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5838 - "Name": "string", ~/~/ Наименование 5839 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5840 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5841 - "Norm": 0 ~/~/ Норма внесения 5842 - }, 5843 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5844 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5845 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5846 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5847 - "deleted": true, ~/~/ Признак удаления 5848 - "extId": "string", ~/~/ ExtId 5849 - "GeoIds": [ ~/~/ Связанные поля 5850 - 0 5851 - ] 5852 -} 5853 - 5854 - 5855 -== **Редактирование задания в Журнале заданий** == 5856 - 5857 -(% class="box successmessage" %) 5858 -((( 5859 -**PUT /api/v3/vehicletasks** 5860 -))) 5861 - 5862 -Пример запроса: 5863 - 5864 -((( 5865 -{ 5866 - "vehicleId": 0, ~/~/ Идентификатор ТС 5867 - "description": "string", ~/~/ Описание 5868 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5869 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5870 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5871 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5872 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5873 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5874 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5875 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5876 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5877 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5878 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5879 - "cost": { 5880 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5881 - "Name": "string", ~/~/ Наименование 5882 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5883 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5884 - "Norm": 0 ~/~/ Норма внесения 5885 - }, 5886 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5887 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5888 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5889 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5890 - "deleted": true, ~/~/ Признак удаления 5891 - "extId": "string", ~/~/ ExtId 5892 - "GeoIds": [ ~/~/ Связанные поля 5893 - 0 5894 - ] 5895 -} 5896 -))) 5897 - 5898 - 5899 -Пример ответа: 5900 - 5901 -{ 5902 - "vehicleId": 0, ~/~/ Идентификатор ТС 5903 - "description": "string", ~/~/ Описание 5904 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5905 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5906 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5907 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5908 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5909 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5910 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5911 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5912 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5913 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5914 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5915 - "cost": { 5916 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5917 - "Name": "string", ~/~/ Наименование 5918 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5919 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5920 - "Norm": 0 ~/~/ Норма внесения 5921 - }, 5922 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5923 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5924 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5925 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5926 - "deleted": true, ~/~/ Признак удаления 5927 - "extId": "string", ~/~/ ExtId 5928 - "GeoIds": [ ~/~/ Связанные поля 5929 - 0 5930 - ] 5931 -} 5932 - 5933 - 5934 -== **Удаление задания в Журнале заданий** == 5935 - 5936 -(% class="box warningmessage" %) 5937 -((( 5938 -**DELETE /api/v3/vehicletasks** 5939 -))) 5940 - 5941 -Пример запроса: 5942 - 5943 -((( 5944 -[ 5945 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5946 -] 5947 -))) 5948 - 5949 -((( 5950 - 5951 -))) 5952 - 5953 -Пример ответа: 5954 - 5955 -{ 5956 - "vehicleId": 0, ~/~/ Идентификатор ТС 5957 - "description": "string", ~/~/ Описание 5958 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5959 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5960 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5961 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5962 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5963 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5964 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5965 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5966 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5967 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5968 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5969 - "cost": { 5970 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5971 - "Name": "string", ~/~/ Наименование 5972 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5973 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5974 - "Norm": 0 ~/~/ Норма внесения 5975 - }, 5976 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5977 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5978 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5979 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5980 - "deleted": true, ~/~/ Признак удаления 5981 - "extId": "string", ~/~/ ExtId 5982 - "GeoIds": [ ~/~/ Связанные поля 5983 - 0 5984 - ] 5985 -} 5986 - 5987 - 5988 -== **Получение списка Журнала заданий** == 5989 - 5990 -(% class="box infomessage" %) 5991 -((( 5992 -**POST /api/v3/vehicletasks/getbyperiod** 5993 -))) 5994 - 5995 -Пример запроса: 5996 - 5997 -((( 5998 -{ 5999 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 6000 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 6001 - "TimeZone": 0, ~/~/ Часовой пояс. 6002 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 6003 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 6004 - ], 6005 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 6006 - 0 6007 - ], 6008 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 6009 - 0 6010 - ], 6011 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 6012 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 6013 -} 6014 -))) 6015 - 6016 - 6017 -Пример ответа: 6018 - 6019 -((( 6020 -{ 6021 - "total": 0, ~/~/ Общее количество записей 6022 - "pages": 0, ~/~/ Общее количество страниц 6023 - "currentPage": 0, ~/~/ Текущая страница 6024 - "items": [ ~/~/ Записи 6025 - { 6026 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6027 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 6028 - "name": "string", ~/~/ Название задания. 6029 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 6030 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 6031 - "workKind": "string", ~/~/ Вид работ 6032 - "techOp": "string", ~/~/ Тех. операция 6033 - "trailerModel": "string", ~/~/ Модель агрегата 6034 - "width": "string", ~/~/ Ширина, м 6035 - "speed": "string", ~/~/ Тех. скорость 6036 - "fields": "string", ~/~/ Поля 6037 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 6038 - "vehicles": "string", ~/~/ Объект-модель 6039 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 6040 - "drivers": "string", ~/~/ Водители 6041 - "tmc": "string", ~/~/ ТМЦ 6042 - "client": "string", ~/~/ Клиент 6043 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6044 - "dep": "string", ~/~/ Подразделение 6045 - "geoIds": [ ~/~/ Связанные поля 6046 - 0 6047 - ] 6048 - } 6049 - ] 6050 -} 6051 -))) 6052 - 6053 - 6054 -= **Раздел: Роли** = 6055 - 6056 -== **Получение списка клиентских и системных ролей пользователя ** == 6057 - 6058 -(% class="box successmessage" %) 6059 -((( 6060 -**POST /api/v3/groups/find** 6061 -))) 6062 - 6063 -Пример запроса: 6064 - 6065 -((( 6066 -{ 6067 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6068 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6069 -} 6070 -))) 6071 - 6072 -((( 6073 - 6074 -))) 6075 - 6076 -((( 6077 -Пример ответа: 6078 -))) 6079 - 6080 -((( 6081 -((( 6082 -{ 6083 - "groups": [ ~/~/ Системные роли пользователя 6084 - { 6085 - "code": "string", ~/~/ Код роли. 6086 - "name": "string", ~/~/ Имя 6087 - "shortName": "string" ~/~/ Короткое имя 6088 - } 6089 - ], 6090 - "customGroups": [ ~/~/ Системные роли пользователя 6091 - { 6092 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6093 - "name": "string", ~/~/ Наименование 6094 - "shortName": "string", ~/~/ Короткое наименование 6095 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6096 - } 6097 - ] 6098 -} 6099 -))) 6100 -))) 6101 - 6102 -((( 6103 - 6104 -))) 6105 - 6106 -((( 6107 - 6108 -))) 6109 - 6110 -= **Раздел: Локатор ** = 6111 - 6112 - 6113 -== **Получение данных по локатору** == 6114 - 6115 -(% class="box infomessage" %) 6116 -((( 6117 -**GET /api/v3/locators/{locatorId}** 6118 -))) 6119 - 6120 -В запросе указывается locatorid - идентификатор локатора 6121 - 6122 - 6123 -Пример ответа: 6124 - 6125 -((( 6126 -((( 6127 -{ 6128 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6129 - 0 6130 - ], 6131 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6132 - 0 6133 - ], 6134 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6135 - 0 6136 - ], 6137 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6138 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6139 - "agentName": "string", ~/~/ Наименование агента. 6140 - "isEnabled": true, ~/~/ Активность 6141 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6142 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6143 - "name": "string", ~/~/ Наименование. 6144 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6145 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6146 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6147 - "validity": 0, ~/~/ Значение срока действия 6148 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6149 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6150 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6151 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6152 - "url": "string", ~/~/ Ссылка 6153 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6154 - 6155 - "showVehicleName": true, ~/~/ Наименование объекта 6156 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6157 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6158 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6159 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6160 - "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ГИС) 6161 - 6162 - 1 6163 - 6164 - ] 6165 -} 6166 -))) 6167 -))) 6168 - 6169 - 6170 -((( 6171 -((( 6172 - 6173 -))) 6174 -))) 6175 - 6176 - 6177 -== **Создание локатора** == 6178 - 6179 -(% class="box successmessage" %) 6180 -((( 6181 -**POST /api/v3/locators** 6182 -))) 6183 - 6184 -Пример запроса: 6185 - 6186 -((( 6187 -{ 6188 - "isEnabled": true, ~/~/ Активность 6189 - "name": "string", ~/~/ Наименование локатора 6190 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6191 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6192 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6193 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6194 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6195 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6196 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6197 - 0 6198 - ], 6199 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6200 - 0 6201 - ], 6202 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6203 - 0 6204 - ], 6205 - 6206 - "showVehicleName": true, ~/~/ Наименование объекта 6207 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6208 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6209 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6210 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6211 - "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ГИС) 6212 - 6213 - 1 6214 - 6215 - ] 6216 -} 6217 -))) 6218 - 6219 - 6220 -Пример ответа: 6221 - 6222 -((( 6223 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6224 -))) 6225 - 6226 - 6227 -== **Выводит список локаторов ** == 6228 - 6229 -(% class="box successmessage" %) 6230 -((( 6231 -**POST /api/v3/locators/find** 6232 -))) 6233 - 6234 -Пример запроса: 6235 - 6236 -((( 6237 -{ 6238 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6239 -} 6240 -))) 6241 - 6242 -((( 6243 - 6244 -))) 6245 - 6246 -((( 6247 - 6248 -))) 6249 - 6250 - 6251 -Пример ответа: 6252 - 6253 -((( 6254 -[ 6255 - { 6256 - "vehiclesCount": 0, ~/~/ Количество объектов. 6257 - "geozonesCount": 0, ~/~/ Количество геозон. 6258 - "fieldsCount": 0, ~/~/ Количество полей. 6259 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6260 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6261 - "agentName": "string", ~/~/ Наименование агента. 6262 - "isEnabled": true, ~/~/ Активность локатора 6263 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6264 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6265 - "name": "string", ~/~/ Наименование локатора 6266 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6267 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6268 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6269 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6270 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6271 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6272 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6273 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6274 - "url": "string", ~/~/ ссылка на локатор 6275 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6276 - "showVehicleName": true, ~/~/ Наименование объекта 6277 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6278 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6279 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6280 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6281 - "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ГИС) 6282 - 6283 - 0 6284 - ] 6285 - } 6286 -] 6287 -))) 6288 - 6289 - 6290 -== **Изменение локатора** == 6291 - 6292 -(% class="box infomessage" %) 6293 -((( 6294 -**PUT /api/v3/locators** 6295 -))) 6296 - 6297 -Пример запроса: 6298 - 6299 -((( 6300 -{ 6301 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6302 - "isEnabled": true, ~/~/ Активность 6303 - "name": "string", ~/~/ Наименование 6304 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6305 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6306 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6307 - "autoProlongation": true, ~/~/ Автопродление срока действия 6308 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6309 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6310 - 0 6311 - ], 6312 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6313 - 0 6314 - ], 6315 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6316 - 0 6317 - ], 6318 - "showVehicleName": true, ~/~/ Наименование объекта 6319 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6320 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6321 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6322 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6323 - "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ГИС) 6324 - 6325 - 0 6326 - 6327 - ] 6328 -} 6329 - 6330 - 6331 -))) 6332 - 6333 -Пример ответа: 6334 - 6335 -200 ~/~/ Success 6336 - 6337 - 6338 -== **Удалить локатор** == 6339 - 6340 -(% class="box warningmessage" %) 6341 -((( 6342 -**DELETE /api/v3/locators** 6343 -))) 6344 - 6345 -Пример запроса: 6346 - 6347 -((( 6348 -[ 6349 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6350 -] 6351 -))) 6352 - 6353 - 6354 -= **Раздел: Яндекс Маршруты** = 6355 - 6356 - 6357 -== **Возвращение списка маршрутов** == 6358 - 6359 -(% class="box infomessage" %) 6360 -((( 6361 -**GET /api/v3/TransportRoutes** 6362 -))) 6363 - 6364 -Пример запроса: 6365 -Id ~/~/ Идентификатор поля 6366 - 6367 -Пример ответа: 6368 - 6369 -((( 6370 -[ 6371 - { 6372 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6373 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6374 - "name": "string", ~/~/ Наименование маршрута. 6375 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6376 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6377 - 0 6378 - ] 6379 - } 6380 -] 6381 -))) 6382 - 6383 - 6384 -== **Добавить маршрут** == 6385 - 6386 -(% class="box infomessage" %) 6387 -((( 6388 -**POST /api/v3/TransportRoutes** 6389 -))) 6390 - 6391 -Пример запроса: 6392 -{ 6393 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6394 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6395 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6396 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6397 - 0 6398 - ] 6399 -} 6400 - 6401 - 6402 -Пример ответа: 6403 - 6404 -((( 6405 -{ 6406 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6407 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6408 - "name": "string", ~/~/ Определяет наименование маршрута 6409 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6410 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6411 - 0 6412 - ] 6413 -} 6414 -))) 6415 - 6416 - 6417 -== **Обновление маршрута** == 6418 - 6419 -(% class="box successmessage" %) 6420 -((( 6421 -**PUT /api/v3/TransportRoutes** 6422 -))) 6423 - 6424 -Пример запроса: 6425 - 6426 -((( 6427 -{ 6428 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6429 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6430 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6431 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6432 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6433 - 0 6434 - ] 6435 -} 6436 -))) 6437 - 6438 -Пример ответа: 6439 - 6440 -((( 6441 -{ 6442 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6443 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6444 - "name": "string", ~/~/ Определяет наименование маршрута 6445 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6446 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6447 - 0 6448 - ] 6449 -} 6450 -))) 6451 - 6452 - 6453 -== **Получить связки маршрутов ТС** == 6454 - 6455 -(% class="box infomessage" %) 6456 -((( 6457 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6458 -))) 6459 - 6460 -Пример запроса: 6461 - 6462 -((( 6463 -[ 6464 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6465 -] 6466 -))) 6467 - 6468 -Пример ответа: 6469 - 6470 -((( 6471 -[ 6472 - { 6473 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6474 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6475 - } 6476 -] 6477 -))) 6478 - 6479 - 6480 -== **Удалить маршрут** == 6481 - 6482 -(% class="box warningmessage" %) 6483 -((( 6484 -**DELETE /api/v3/TransportRoutes/{id}** 6485 -))) 6486 - 6487 -Пример запроса: 6488 -Id ~/~/ Идентификатор поля 6489 - 6490 - 6491 -= **Раздел: Управление доступа к машинам** = 6492 - 6493 - 6494 -== Получение списка транспортных средств видимых пользователю == 6495 - 6496 -(% class="box infomessage" %) 6497 -((( 6498 -**GET /api/v3/UserVisibleVehicles/{userId}** 6499 -))) 6500 - 6501 -Пример ответа: 6502 - 6503 -((( 6504 -{ 6505 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6506 - 0 6507 - ] 6508 -} 6509 -))) 6510 - 6511 - 6512 -== Задает видимость транспортных средств пользователю == 6513 - 6514 -(% class="box infomessage" %) 6515 -((( 6516 -**POST /api/v3/UserVisibleVehicles** 6517 -))) 6518 - 6519 -Пример запроса: 6520 - 6521 -((( 6522 -((( 6523 -{ 6524 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6525 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6526 - 0 6527 - ] 6528 -} 6529 -))) 6530 - 6531 -((( 6532 - 6533 -))) 6534 - 6535 -((( 6536 -Пример ответа : 6537 -))) 6538 - 6539 -((( 6540 - 6541 -))) 6542 - 6543 -((( 6544 -200 ~/~/ Success 6545 -))) 6546 -))) 6547 - 6548 - 6549 6549 (% class="box" lang="en-US" style="text-align: center;" %) 6550 6550 ((( 6551 6551 (% 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]] **