Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Андрей Калиновский 2025/09/16 11:13
<
отредактировано Андрей Калиновский
на 2025/09/16 11:13
на 2025/09/16 11:13
отредактировано Андрей Калиновский
на 2024/07/25 10:10
на 2024/07/25 10:10
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -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 ... ... @@ -1206,25 +1206,6 @@ 1206 1206 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1207 1207 1208 1208 1209 -== **Отправить команду на терминал** == 1210 - 1211 -(% class="box successmessage" %) 1212 -((( 1213 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1214 -))) 1215 - 1216 -Команда для отправки на тс. 1217 - 1218 -{ 1219 -"id": "", ~/~/идентификатор объекта (он же идентификатор ТС: vehicleId) 1220 -"command": "", ~/~/ Текст отправляемой команды 1221 -"retries": "", ~/~/ Количество попыток отправки на терминал 1222 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов). 1223 -} 1224 - 1225 -В ответ получаем cmdid 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 Id1173 +Идентификатор команды: cmdid 1236 1236 1237 1237 Запрос от терминала на ответ команды 1238 1238 1239 1239 Пример ответ от терминала: 1240 1240 1241 -ID= "" ~/~/ идентификатор о бъекта1179 +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 - 1232 +(% 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 - ] 1349 + "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 - По датчику относительных Моточасов 1354 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1355 + "name": "string", 1356 + "value": "string", 1357 + "forClient": true, 1358 + "forTooltip": true, 1359 + "forReport": true 1360 + } 1361 + ] 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 ~/~/ Условие по количеству записей для деактивации 1366 +(% style="color:#000000" %){(%%) 1367 + "vehicleId": "", ~/~/ID ТС 1368 + "parentId": "", ~/~/Guid владельца ТС 1369 + "name": "", ~/~/Имя объекта 1370 + "imei": "", ~/~/IMEI 1371 + "deviceTypeId": "", ~/~/ID типа устройства 1372 + "modelId": "", ~/~/ID модели 1373 + "unitId": "", ~/~/ID подразделения 1374 + "sim1": "", ~/~/SIM1 1375 + "sim2": "", ~/~/SIM2 1376 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1377 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1378 + "counters": { ~/~/Счётчики 1379 + "mileageEnabled": true, 1380 + "motohoursEnabled": true, 1381 + "mileage": "", 1382 + "motohours": 345.0 1383 + }, 1384 + "cmsv6Parameters": { ~/~/Параметры CmsV6 1385 + "id": null, 1386 + "enabled": true, ~/~/флаг включения 1387 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1388 + "login": "", ~/~/ имя учетной записи 1389 + "password": "" ~/~/ пароль учетной записи 1390 + }, 1391 + "inspectionTasks": { ~/~/ задания на ТО 1392 + "id": "", ~/~/ ID задачи 1393 + "enabled": false, ~/~/ Признак включения 1394 + "name": "", ~/~/ Имя задания 1395 + "description": "", ~/~/ Описание задания 1396 + "mileageCondition": "", ~/~/ Условие по пробегу 1397 + "lastMileage": "", ~/~/ Пробег (в метрах) 1398 + "motohoursCondition": "", ~/~/ Условие по моточасам 1399 + "lastMotohours": "", ~/~/ Моточасы 1400 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1401 + "kind": "", ~/~/ Вид периодичности по времени 1402 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 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 -))) 1404 +(% 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 1411 +== (% 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" ~/~/ Идентификатор агента, для которого надо получить данные 1452 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1453 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1454 + "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": "" ~/~/ идентификатор объекта 1461 +(% style="color:#000000" %){ 1462 + "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 -))) 1487 + }(%%) 1488 +(% 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,7 +1756,23 @@ 1756 1756 "stage": "", ~/~/ Состояние 1757 1757 (% style="color:#000000" %) } 1758 1758 1534 +== **Отправить команду на терминал** == 1759 1759 1536 +(% class="box successmessage" %) 1537 +((( 1538 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1539 +))) 1540 + 1541 +Команда для отправки на тс. 1542 + 1543 +{ 1544 +"id": "", ~/~/идентификатор произвольного поля 1545 +"command": "", ~/~/ Текст команды 1546 +"retries": "", ~/~/ Количество попыток 1547 +"idTemplate": "" ~/~/ ID шаблона команды 1548 +} 1549 + 1550 + 1760 1760 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1761 1761 1762 1762 (% class="box warningmessage" %) ... ... @@ -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 - } 1626 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1627 + "isDefault": true 1628 + } 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 ~/~/ Отобразить произвольное поле в отчете1692 + { 1693 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1694 + "name": "string", 1695 + "value": "string", 1696 + "forClient": true, 1697 + "forTooltip": true, 1698 + "forReport": true 1933 1933 } 1934 - 1935 -((( 1936 - ], 1937 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1938 -))) 1939 - 1700 + ] 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": [ ~/~/ Тарировка 1705 +(% lang="en-US" style="text-align:left" %) 1706 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1707 + "vehicleId": "", ~/~/ ID ТС 1708 + "parentId": "", ~/~/ ID клиента 1709 + "name": "", ~/~/ имя ТС 1710 + "imei": "", ~/~/ IMEI 1711 + "deviceTypeId": "", ~/~/ типа устройства 1712 + "modelId": "", ~/~/ ID модели 1713 + "unitId": "", ~/~/ ID подразделения 1714 + "sim1": "", ~/~/ SIM 1 1715 + "sim2": "", ~/~/ SIM2 1716 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1717 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1718 + "counters": 1719 + { 1720 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1721 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1722 + "mileage": "", ~/~/ пробег 1723 + "motohours": "", ~/~/ моточасы 1724 + } 1725 + "cmsv6Parameters": ~/~/ параметры CMSv6 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": [ ~/~/ Интервалы значений для подсветки в мониторинге 1727 + "id": ~/~/ идентификатор 1728 + "enabled": true, ~/~/ флаг включения 1729 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1730 + "login": "", ~/~/ имя учетной записи 1731 + "password": "", ~/~/ пароль учетной записи 1732 + } 1733 + "inspectionTasks": ~/~/ задания на ТО 2096 2096 { 2097 - "from": 0, ~/~/ С какого значения 2098 - "color": "string", ~/~/ Каким цветом 2099 - "text": "string" ~/~/ Текст подписи к этому интервалу 1735 + "id": "", ~/~/ ID задания 1736 + "enabled": false, ~/~/ Признак включения 1737 + "name": "", ~/~/ Имя задания 1738 + "description": "", ~/~/ Описание задания 1739 + "mileageCondition": "", ~/~/ Условие по пробегу 1740 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1741 + "motohoursCondition": "", ~/~/ Условие по моточасам 1742 + "lastMotohours": "", ~/~/ Моточасы 1743 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1744 + "kind": "", ~/~/ Вид периодичности по времени 1745 + "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 -))) 1747 +(% 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 секунд. Весь период разбивает на подпериоды с указанной частотой.2005 + "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 - 2022 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2023 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2024 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2025 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2400 2400 } 2401 2401 ] 2402 2402 } ... ... @@ -2419,6 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2048 + "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,22 +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 -))) 2455 - 2456 2456 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2457 2457 2458 2458 (% class="box infomessage" %) ... ... @@ -2487,21 +2487,12 @@ 2487 2487 "model": "string", ~/~/ Модель объекта 2488 2488 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2489 2489 { 2490 - "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 2491 - 2492 -((( 2108 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2493 2493 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2494 2494 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2495 2495 "valueFuel": 0, ~/~/ Количество 2496 2496 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2497 2497 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2498 -))) 2499 - 2500 -((( 2501 - "latitude": 0, ~/~/ Широта. 2502 - "longitude": 0 ~/~/ Долгота. 2503 -))) 2504 - 2505 2505 } 2506 2506 ] 2507 2507 } ... ... @@ -2549,7 +2549,7 @@ 2549 2549 ], 2550 2550 "stops": [ ~/~/ События стоянок 2551 2551 { 2552 - "address": " [Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес событияУлица, Дом, Город, Регион, Страна, Координаты2161 + "address": "string", ~/~/ Адрес события 2553 2553 "eventId": 0, ~/~/ Идентификатор события 2554 2554 "eventName": "string", ~/~/ Название события 2555 2555 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -2575,241 +2575,194 @@ 2575 2575 В заголовках запроса: X-Auth: Токен авторизации 2576 2576 2577 2577 2578 -В массивеуказываемid объектов через запятую2187 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2579 2579 2580 2580 Ответ: 2581 - 2582 -[ 2583 2583 { 2584 - "vehicleId": 55728, ~/~/2585 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",Guidобъекта2586 - "vehicleNumber": " 0105 КМ",2587 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",датапоступления данных2588 - "recordTime": "202 5-06-27T12:37:19Z",датаформированиеданных2589 - "state": 4,2590 - "speed": 31,2591 - "course": 116,2592 - "latitude": 45.722128,2593 - "longitude": 39.800432,2594 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/2595 - "geozones": [ ~/~/ 2191 + "vehicleId": 0, ~/~/Идентификатор объекта. 2192 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2193 + "vehicleNumber": "string",~/~/Номер объекта. 2194 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2195 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2196 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2197 + "speed": 0,~/~/Скорость объекта. 2198 + "course": 0,~/~/Курс движения [0;360] 2199 + "latitude": 0,~/~/Широта [-90°;90°]. 2200 + "longitude": 0,~/~/Долгота [-180°;180°]. 2201 + "address": "string",~/~/Адрес. 2202 + "geozones": [ ~/~/Сведения по геозонам. 2596 2596 { 2597 - "id": 10225647, ~/~/ ID Геозоны 2598 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2599 - }, 2600 - { 2601 - "id": 10282875, ~/~/ ID Геозоны 2602 - "name": "Ё2" ~/~/ Наименование геозоны 2603 - }, 2604 - { 2605 - "id": 10226240, ~/~/ ID Геозоны 2606 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2607 - }, 2608 - { 2609 - "id": 9747869, ~/~/ ID Геозоны 2610 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2611 - }, 2612 - { 2613 - "id": 10221123, ~/~/ ID Геозоны 2614 - "name": "53r" ~/~/ Наименование геозоны 2615 - }, 2616 - { 2617 - "id": 10197638, ~/~/ ID Геозоны 2618 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2204 + "id": 0, 2205 + "name": "string" 2619 2619 } 2620 - ] 2621 - } 2622 2622 2623 2623 2624 -= = 2209 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2625 2625 2626 -= (% style="color:#000000; font-size:1 8.6667px" %)Раздел:**Уведомления**(%%) =2211 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2627 2627 2628 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2629 - 2630 2630 (% class="box infomessage" %) 2631 2631 ((( 2632 -**POST /api/v3/ notifications/find**2215 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2633 2633 ))) 2634 2634 2635 -Метод возвращаетинформациюобуведомлениях переданногоклиента иегоклиентов нижепо иерархии.2218 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2636 2636 2637 -(% style="text-align: left;" %) 2638 -Метод запроса **POST** 2220 +(% style="color:#000000" %)Метод запроса: **POST** 2639 2639 2640 -(% style="text-align: left;" %) 2641 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2222 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2642 2642 2643 -(% style="text-align: left;" %) 2644 2644 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2645 2645 2226 +(% style="text-align:left" %) 2227 +Тело запроса: 2228 + 2229 +(% style="text-align:left" %) 2646 2646 { 2647 - "parentId": "" ~/~/ id клиента2231 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2648 2648 } 2649 2649 2234 +(% style="text-align:left" %) 2650 2650 Ответ: 2651 2651 2652 2652 [ 2653 2653 { 2654 - "id": 0, ~/~/ ID уведомления 2655 - "name": "string", ~/~/ Название уведомления 2656 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 2657 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2658 - "userId": "", ~/~/ Пользователь, создавший уведомление 2659 - "parentId": "", ~/~/ Идентификатор клиента 2660 - "parentName": "string" ~/~/ Имя клиента 2239 + "id": 0, ~/~/ Идентификатор объекта геозоны 2240 + "name": "string", ~/~/ Название объекта геозоны 2241 + "type": 0, ~/~/ Тип объекта геозоны 2242 + "fname": "string", ~/~/ Имя файла 2243 + "parentId": "string", ~/~/ Идентификатор клиента 2244 + "radius": 0, ~/~/ Радиус геообъекта 2245 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2246 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2247 + "description": "string", ~/~/ Описание 2248 + "area": 0, ~/~/ Площадь, м^^2^^ 2249 + "perimetr": 0, ~/~/ Периметр, м 2250 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2661 2661 } 2662 2662 ] 2663 2663 2254 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2664 2664 2665 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2666 - 2667 2667 (% class="box infomessage" %) 2668 2668 ((( 2669 -**POST /api/v3/ notifications**2258 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2670 2670 ))) 2671 2671 2672 -Метод з апроса**POST**2261 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2673 2673 2674 -(% style="text-align: left;" %) 2675 -(% style="color:#000000" %)Пример запроса 2263 +(% style="color:#000000" %)Метод запроса: **POST** 2676 2676 2677 -((( 2265 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2266 + 2267 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2268 + 2269 +(% style="text-align:left" %) 2270 +Тело запроса: 2271 + 2678 2678 { 2679 - "id": 0, ~/~/ ID правила 2680 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2681 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2682 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2683 - "name": "string", ~/~/ Имя правила 2684 - "active": true, ~/~/ Активность правила 2685 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2686 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2687 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2688 - ], 2689 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2690 - 0 2691 - ], 2692 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2693 - 0 2694 - ], 2695 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2696 - 0 2697 - ], 2698 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2699 - "additionalProp1": "string", 2700 - "additionalProp2": "string", 2701 - "additionalProp3": "string" 2702 - }, 2703 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2704 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2705 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2706 - ], 2707 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2708 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2709 - "string" 2710 - ], 2711 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2712 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2713 - { 2714 - "id": 0, ~/~/ Идентификатор участника чата. 2715 - "info": "string" ~/~/ Дополнительные сведения. 2716 - } 2717 - ], 2718 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2719 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2720 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2721 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2722 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2723 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2724 - "timezone": 0, ~/~/ часовой пояс 2725 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2726 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2727 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2728 - { 2729 - "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 - Срок действия правила истек 2730 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2731 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2732 - "additionalProp1": "string", 2733 - "additionalProp2": "string", 2734 - "additionalProp3": "string" 2735 - } 2736 - } 2737 - ] 2273 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2274 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2275 + "ids": [ ], ~/~/ Массив id объектов 2276 + "byTime": 0, ~/~/ Объединение событий по времени 2277 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2278 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2279 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2738 2738 } 2739 -))) 2740 2740 2282 +Ответ: 2283 +[ 2284 + { 2285 + "geozoneId": 0, ~/~/ ID геообъекта 2286 + "geozoneName": "string", ~/~/ Название геообъекта 2287 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2288 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2289 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2290 + "vehicleId": 0, ~/~/ ID объекта 2291 + "vehicleName": "string" ~/~/ Имя объекта 2292 + } 2293 +] 2294 + 2295 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2296 + 2297 +(% class="box infomessage" %) 2741 2741 ((( 2742 - 2299 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2743 2743 ))) 2744 2744 2302 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2303 + 2304 +(% style="color:#000000" %)Метод запроса: **POST** 2305 + 2306 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2307 + 2308 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2309 + 2310 +(% style="text-align:left" %) 2311 +Тело запроса: 2312 + 2313 +{ 2314 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2315 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2316 + "ids": [ ], ~/~/ Массив id геообъектов 2317 + "byTime": 0, ~/~/ Объединение событий по времени 2318 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2319 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2320 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2321 +} 2322 + 2323 +Ответ: 2324 + 2325 +[ 2326 + { 2327 + "geozoneId": 0, ~/~/ ID геообъекта 2328 + "geozoneName": "string", ~/~/ Название геообъекта 2329 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2330 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2331 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2332 + "vehicleId": 0, ~/~/ ID объекта 2333 + "vehicleName": "string" ~/~/ Имя объекта 2334 + } 2335 +] 2336 + 2337 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2338 + 2339 +== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2340 + 2341 +(% class="box infomessage" %) 2745 2745 ((( 2746 - 2343 +**POST /api/v3/notifications/find** 2747 2747 ))) 2748 2748 2749 - Ответ:2346 +Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 2750 2750 2348 +(% style="text-align: left;" %) 2349 +Метод запроса **POST** 2350 + 2351 +(% style="text-align: left;" %) 2352 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2353 + 2354 +(% style="text-align: left;" %) 2355 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2356 + 2751 2751 { 2752 - "id": 0, ~/~/ ID правила 2753 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2754 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2755 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2756 - "name": "string", ~/~/ Имя правила 2757 - "active": true, ~/~/ Активность правила 2758 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2759 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2760 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2761 - ], 2762 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2763 - 0 2764 - ], 2765 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2766 - 0 2767 - ], 2768 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2769 - 0 2770 - ], 2771 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2772 - "additionalProp1": "string", 2773 - "additionalProp2": "string", 2774 - "additionalProp3": "string" 2775 - }, 2776 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2777 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2778 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2779 - ], 2780 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2781 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2782 - "string" 2783 - ], 2784 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2785 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2786 - { 2787 - "id": 0, ~/~/ Идентификатор участника чата. 2788 - "info": "string" ~/~/ Дополнительные сведения. 2789 - } 2790 - ], 2791 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2792 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2793 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2794 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2795 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2796 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2797 - "timezone": 0, ~/~/ часовой пояс 2798 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2799 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2800 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2801 - { 2802 - "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 - Срок действия правила истек 2803 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2804 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2805 - "additionalProp1": "string", 2806 - "additionalProp2": "string", 2807 - "additionalProp3": "string" 2808 - } 2809 - } 2810 - ] 2358 + "parentId": "" ~/~/ id клиента 2811 2811 } 2812 2812 2361 +Ответ: 2362 + 2363 +[ 2364 + { 2365 + "id": 0, ~/~/ ID уведомления 2366 + "name": "string", ~/~/ Название уведомления 2367 + "active": true, ~/~/ Состояние true - активен, false - деактивирован 2368 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2369 + "userId": "", ~/~/ Пользователь, создавший уведомление 2370 + "parentId": "", ~/~/ Идентификатор клиента 2371 + "parentName": "string" ~/~/ Имя клиента 2372 + } 2373 +] 2374 + 2813 2813 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2814 2814 2815 2815 (% class="box infomessage" %) ... ... @@ -2951,32 +2951,6 @@ 2951 2951 2952 2952 Success 2953 2953 2954 - 2955 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2956 - 2957 -(% class="box warningmessage" %) 2958 -((( 2959 -**PUT** /api/v3/notifications/prolongation 2960 -))) 2961 - 2962 -Метод позволяет продлить уведомления. 2963 - 2964 -Метод запроса **PUT** 2965 - 2966 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2967 - 2968 -В заголовках запроса: X-Auth: Токен авторизации. 2969 - 2970 -Тело запроса: 2971 - 2972 -[ 2973 - 2974 -0 2975 - 2976 -] 2977 - 2978 -где 0 идентификатор ids. 2979 - 2980 2980 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2981 2981 2982 2982 (% class="box errormessage" %) ... ... @@ -4027,12 +4027,16 @@ 4027 4027 Тело запроса: 4028 4028 4029 4029 { 4030 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4031 - "Balance": 0 ~/~/ Значение баланса.3566 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3567 + "Balance": 0 4032 4032 } 4033 4033 4034 4034 Ответ: Success 4035 4035 3572 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3573 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3574 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3575 + 4036 4036 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4037 4037 4038 4038 (% class="box warningmessage" %) ... ... @@ -4044,29 +4044,16 @@ 4044 4044 4045 4045 Тело запроса: 4046 4046 4047 -((( 4048 4048 { 4049 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4050 - "a mount": 0~/~/ Сумма пополнения баланса3588 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3589 + "Balance": 0 4051 4051 } 4052 -))) 4053 4053 4054 -((( 4055 - 4056 -))) 4057 - 4058 4058 Ответ: Success 4059 4059 4060 -((( 4061 -{ 4062 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4063 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4064 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4065 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4066 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4067 - "Description": "string" ~/~/ Описание корректировки. 4068 -} 4069 -))) 3594 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3595 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3596 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4070 4070 4071 4071 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4072 4072 ... ... @@ -4079,25 +4079,16 @@ 4079 4079 4080 4080 Тело запроса: 4081 4081 4082 -((( 4083 4083 { 4084 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4085 - "a mount": 0~/~/ Сумма списания с баланса3610 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3611 + "Balance": 0 4086 4086 } 4087 -))) 4088 4088 4089 4089 Ответ: Success 4090 4090 4091 -((( 4092 -{ 4093 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4094 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4095 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4096 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4097 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4098 - "Description": "string" ~/~/ Описание корректировки 4099 -} 4100 -))) 3616 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3617 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3618 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4101 4101 4102 4102 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4103 4103 ... ... @@ -4108,35 +4108,28 @@ 4108 4108 4109 4109 Тело запроса: 4110 4110 4111 -((( 4112 4112 { 4113 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4114 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4115 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4116 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4117 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4118 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 3630 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3631 + "CalculationType": 0, 3632 + "PermissibleBalance": 0, 3633 + "DefermentDays": 0, 3634 + "SendUiNotifications": true, 3635 + "SendEmailNotifications": true, 3636 + "IsPrivate": true, 4119 4119 } 4120 -))) 4121 4121 4122 -((( 4123 - 4124 -))) 4125 - 4126 4126 Ответ: Success 4127 4127 4128 -((( 4129 -{ 4130 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4131 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4132 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4133 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4134 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4135 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4136 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4137 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4138 -} 3641 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3642 +|ClientId|Идентификатор клиента 3643 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 3644 +|PermissibleBalance|Допустимый баланс 3645 +|DefermentDays|((( 3646 +Отсрочка, количество дней 4139 4139 ))) 3648 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 3649 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 3650 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4140 4140 4141 4141 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4142 4142 ... ... @@ -4148,68 +4148,35 @@ 4148 4148 Тело запроса: 4149 4149 4150 4150 { 4151 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4152 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4153 - "Features": [ ~/~/ Набор услуг по тарифу клиента.3662 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3663 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3664 + "Features": [ 4154 4154 { 4155 - "Feature": "string", ~/~/ Код услуги.4156 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4157 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4158 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4159 - "Price": 0, ~/~/ Цена за единицу.4160 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4161 - "PeriodValue": 0, ~/~/ Значение периода.4162 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)3666 + "Feature": "string", 3667 + "IsEnabled": true, 3668 + "IsFactual": true, 3669 + "Limit": 0, 3670 + "Price": 0, 3671 + "DebitDate": "2023-10-18T13:26:58.987Z", 3672 + "PeriodValue": 0, 3673 + "PeriodType": 0 4163 4163 } 4164 4164 ] 4165 4165 } 4166 4166 4167 - 4168 4168 Ответ: Success 4169 4169 4170 -((( 4171 -{ 4172 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4173 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4174 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4175 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4176 - "Name": "string", ~/~/ Наименование. 4177 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4178 - "Constraint": { ~/~/ Ограничения по тарифу 4179 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4180 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4181 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4182 - }, 4183 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4184 - { 4185 - "Feature": "string", ~/~/Код услуги. 4186 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4187 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4188 - "Price": 0, ~/~/ Цена за единицу. 4189 - "PeriodValue": 0, ~/~/ Значение периода. 4190 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4191 - } 4192 - ], 4193 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4194 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4195 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4196 - }, 4197 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4198 - { 4199 - "Feature": "string", ~/~/ Код услуги. 4200 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4201 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4202 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4203 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4204 - "Price": 0, ~/~/ Цена за единицу. 4205 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4206 - "PeriodValue": 0, ~/~/ Значение периода. 4207 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4208 - "Quantity": 0 ~/~/ Количество использования услуги. 4209 - } 4210 - ] 4211 -} 4212 -))) 3680 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3681 +|ClientId|Идентификатор клиента 3682 +|PlanId|Идентификатор тарифного плана 3683 +|Feature|Код услуги 3684 +|IsEnabled|Признак, определяющий активирована ли услуга 3685 +|IsFactual|Признак, определяющий расчёт по факту 3686 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 3687 +|Price|Цена за единицу. 3688 +|DebitDate|Следующий момент времени списания с баланса за услугу. 3689 +|PeriodValue|Значение периода. 3690 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4213 4213 4214 4214 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4215 4215 ... ... @@ -4225,7 +4225,7 @@ 4225 4225 **POST /api/v3/vehicles/import/{agentId}** 4226 4226 ))) 4227 4227 4228 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение*.xls)**или **wlp. **Также они могут находится в** zip-архиве(один файл - один архив).**3706 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 4229 4229 4230 4230 В пути указывается **agentId** - id клиента. 4231 4231 ... ... @@ -4237,7 +4237,7 @@ 4237 4237 4238 4238 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4239 4239 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 4240 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace- Замена,Merge- Слияние,Add- Добавление3718 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 4241 4241 4242 4242 В теле использовать тип **form-data,** тип значения** file** 4243 4243 ... ... @@ -4314,43 +4314,6 @@ 4314 4314 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4315 4315 |msgCount|Кол-во обработанных сообщений всего 4316 4316 4317 -== **Импортировать историю ТС (Асинхронный запрос)** == 4318 - 4319 -(% class="box successmessage" %) 4320 -((( 4321 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4322 -))) 4323 - 4324 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4325 - 4326 -Метод запроса: **POST** 4327 - 4328 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4329 - 4330 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4331 - 4332 - 4333 -Ответ: 4334 - 4335 -{ 4336 - 4337 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4338 - 4339 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4340 - 4341 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4342 - 4343 - "Message": "string", ~/~/ Информация о выполнении запроса 4344 - 4345 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4346 - 4347 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4348 - 4349 - "Data": "string" ~/~/ Данные 4350 - 4351 -} 4352 - 4353 - 4354 4354 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4355 4355 4356 4356 (% class="box infomessage" %) ... ... @@ -4368,59 +4368,10 @@ 4368 4368 "message": "string" 4369 4369 } 4370 4370 4371 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4372 -**Параметр** 4373 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4374 -**Описание** 4375 -))) 4376 -|((( 4377 -activity 4378 -)))|((( 4379 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4380 -))) 4381 -|((( 4382 -progress 4383 -)))|((( 4384 -Guid ТС 4385 -))) 3812 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3813 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 3814 +|progress|Guid ТС 4386 4386 4387 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4388 - 4389 -(% class="box infomessage" %) 4390 -((( 4391 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4392 -))) 4393 - 4394 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4395 - 4396 -Метод запроса: **GET** 4397 - 4398 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4399 - 4400 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4401 - 4402 - 4403 -Ответ: 4404 - 4405 -{ 4406 - 4407 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4408 - 4409 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4410 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4411 - 4412 - "Message": "string", ~/~/ Информация о выполнении запроса 4413 - 4414 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4415 - 4416 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4417 - 4418 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4419 - 4420 - "Data": "string" ~/~/ Данные 4421 - 4422 -} 4423 - 4424 4424 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4425 4425 4426 4426 (% class="box infomessage" %) ... ... @@ -4502,67 +4502,64 @@ 4502 4502 Тело запроса: 4503 4503 4504 4504 { 4505 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4506 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4507 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса3897 + "vehicleIds": [vehicleId], 3898 + "from": "2023-11-22T09:29:48.051Z", 3899 + "to": "2023-11-22T09:29:48.051Z" 4508 4508 } 4509 4509 3902 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3903 +|vehicleIds|Массив ID объектов 3904 +|from|Дата начала запроса 3905 +|to|Дата окончания запроса 3906 + 4510 4510 Ответ: 4511 4511 4512 4512 { 4513 - "items": [ ~/~/ Список в разрезе ТС3910 + "items": [ 4514 4514 { 4515 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4516 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4517 - "vehicleId": 0, ~/~/ ID ТС4518 - "vehicleName": "string", ~/~/ Название ТС4519 - "vehicleModel": "string", ~/~/ Модель ТС4520 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4521 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4522 - "totalViolations": 0, ~/~/ Нарушений всего4523 - "violationsByType": { ~/~/ Информация о нарушениях по типу4524 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4525 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4526 - "brakingViolations": 0, ~/~/ Нарушений торможения4527 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4528 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4529 - "sensorViolations": 0 ~/~/ Нарушений по датчику3912 + "from": "2023-11-22T09:29:48.052Z", 3913 + "to": "2023-11-22T09:29:48.052Z", 3914 + "vehicleId": 0, 3915 + "vehicleName": "string", 3916 + "vehicleModel": "string", 3917 + "penalty": 0, 3918 + "score": 0, 3919 + "totalViolations": 0, 3920 + "violationsByType": { 3921 + "overspeedingViolations": 0, 3922 + "accelerationViolations": 0, 3923 + "brakingViolations": 0, 3924 + "turningViolations": 0, 3925 + "dangerousDrivingViolations": 0, 3926 + "sensorViolations": 0 4530 4530 }, 4531 - 4532 -((( 4533 - 4534 -))) 4535 - 4536 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4537 - "mileage": 0, ~/~/ Пробег, м 4538 - "tripsCount": 0, ~/~/ Кол-во рейсов 4539 - "trips": [ ~/~/ Информация по рейсу 3928 + "moveTime": 0, 3929 + "mileage": 0, 3930 + "tripsCount": 0, 3931 + "trips": [ 4540 4540 { 4541 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4542 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4543 - "violationsCount": 0, ~/~/ Всего нарушений4544 - "violationsByType": { ~/~/ Информация о нарушениях по типу4545 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4546 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4547 - "brakingViolations": 0, ~/~/ Нарушений торможения4548 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4549 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4550 - "sensorViolations": 0 ~/~/ Нарушений по датчику3933 + "penalty": 0, 3934 + "score": 0, 3935 + "violationsCount": 0, 3936 + "violationsByType": { 3937 + "overspeedingViolations": 0, 3938 + "accelerationViolations": 0, 3939 + "brakingViolations": 0, 3940 + "turningViolations": 0, 3941 + "dangerousDrivingViolations": 0, 3942 + "sensorViolations": 0 4551 4551 }, 4552 - 4553 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4554 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4555 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4556 - "mileage": 0, ~/~/ Пробег, м 4557 - "motohours": 0, ~/~/ Моточасы, секунды 4558 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4559 - "startAddress": "string", ~/~/ Адрес начала рейса 4560 - "endAddress": "string", ~/~/ Адрес конца рейса 4561 - "drivers": [ ~/~/ Список водителей 3944 + "moveTime": 0, 3945 + "mileage": 0, 3946 + "motohours": 0, 3947 + "maxSpeed": 0, 3948 + "startAddress": "string", 3949 + "endAddress": "string", 3950 + "drivers": [ 4562 4562 { 4563 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4564 - "driverName": "string", ~/~/ФИО водителя4565 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки3952 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3953 + "driverName": "string", 3954 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4566 4566 } 4567 4567 ] 4568 4568 } ... ... @@ -4571,6 +4571,34 @@ 4571 4571 ] 4572 4572 } 4573 4573 3963 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3964 +|from|Дата начала запроса 3965 +|to|Дата окончания 3966 +|vehicleId|ID объекта 3967 +|vehicleName|Имя объекта 3968 +|vehicleModel|Модель объекта 3969 +|penalty|Сумма штрафных баллов 3970 +|score|Оценка 3971 +|totalViolations|Суммарное количество нарушений 3972 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 3973 +|overspeedingViolations|Превышение скорости 3974 +|accelerationViolations|Ускорение 3975 +|brakingViolations|Торможение 3976 +|turningViolations|Резкий поворот 3977 +|dangerousDrivingViolations|Резкое вождение 3978 +|sensorViolations|Нарушение по датчику 3979 +|moveTime|Время в движении 3980 +|mileage|Пробег 3981 +|tripsCount|Количество рейсов 3982 +|motohours|Моточасы 3983 +|maxSpeed|Максимальная скорость 3984 +|startAddress|Адрес начала рейса 3985 +|endAddress|Адрес окончания рейса 3986 +|drivers|Список водителей, которые были на объекте в течениии рейса 3987 +|driverGuid|Guid водителя 3988 +|driverName|Имя водителя 3989 +|driverRfid|Номер Карты-метки 3990 + 4574 4574 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4575 4575 4576 4576 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == ... ... @@ -4579,7 +4579,7 @@ 4579 4579 4580 4580 (% class="box infomessage" %) 4581 4581 ((( 4582 - **POST /api/v3/fuelcards/transactions**3999 +POST /api/v3/fuelcards/transactions 4583 4583 ))) 4584 4584 4585 4585 Метод запроса: POST ... ... @@ -4590,59 +4590,34 @@ 4590 4590 Параметры в теле запроса (JSON): 4591 4591 4592 4592 { 4593 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ 4594 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ 4010 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4011 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4595 4595 "ids": [ 4596 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы4013 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4597 4597 ], 4598 - "timezone": 0 ~/~/ Часовойпояс4015 + "timezone": 0 ~/~/Таймзона 4599 4599 } 4600 4600 4601 4601 4602 4602 Ответ: 4603 4603 { 4604 - "date": "2024-04-11T10:41:02.265Z", ~/~/ 4605 - "driver": "string", ~/~/ 4606 - "object": "string", ~/~/ 4607 - "amount": 0, ~/~/ 4608 - "amountDut": 0, ~/~/ 4609 - "amountDiff": 0, ~/~/ 4610 - "amountDiffPerc": 0, ~/~/ 4611 - "summa": 0, ~/~/ 4612 - "serviceName": "string", ~/~/ 4613 - "price": 0, ~/~/ 4614 - "cardName": "string", ~/~/ 4615 - "cardNum": "string", ~/~/ 4616 - "operator": "string", ~/~/ 4617 - "address": "string" ~/~/ 4021 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4022 + "driver": "string", ~/~/Водители, привязанные к ТК 4023 + "object": "string", ~/~/Наименование ТС 4024 + "amount": 0, ~/~/Количество топлива 4025 + "amountDut": 0, ~/~/Количество по ДУТ 4026 + "amountDiff": 0, ~/~/Разница, л 4027 + "amountDiffPerc": 0, ~/~/Разница, % 4028 + "summa": 0, ~/~/Стоимость, руб 4029 + "serviceName": "string", ~/~/Тип топлива 4030 + "price": 0, ~/~/Цена за литр, руб 4031 + "cardName": "string", ~/~/Наименование ТК 4032 + "cardNum": "string", ~/~/Номер ТК 4033 + "operator": "string", ~/~/Оператор ТК 4034 + "address": "string" ~/~/Адрес АЗС 4618 4618 } 4619 4619 4620 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4621 4621 4622 -(% class="box infomessage" %) 4623 -((( 4624 -**GET /api/v3/fuelcards** 4625 -))) 4626 - 4627 -Метод запроса: GET 4628 - 4629 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4630 - 4631 -Ответ: 4632 - 4633 -[ 4634 - { 4635 - "Name": "string", ~/~/ Определяет наименование карты. 4636 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4637 - "Number": "string", ~/~/ Определяет № карты. 4638 - "Enabled": true, ~/~/ Определяет признак активности карты. 4639 - "Description": "string", ~/~/ Определяет описание карты. 4640 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4641 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4642 - "deleted": true ~/~/ Признак удаления 4643 - } 4644 -] 4645 - 4646 4646 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4647 4647 4648 4648 ... ... @@ -4653,28 +4653,28 @@ 4653 4653 **GET ** **/api/v3/retranslations/{id}** 4654 4654 ))) 4655 4655 4656 - id -Идентификаторретранслятора4048 +Идентификатор запроса: ID 4657 4657 4658 4658 4659 4659 Пример ответа: 4660 4660 4661 4661 { 4662 -"description": "", ~/~/ Поле описания ретранслятора4663 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)4664 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4665 -"isEnabled": true, ~/~/ Признак включенияретранслятора, Включен, true - включен, false - отключен4666 -"address": "string", ~/~/ Адрес и портпринимающего сервера4667 -"objects": [ ~/~/ 4054 +"description": "", ~/~/ Определяет описание 4055 +"subscriberId": "", ~/~/ Подписчик 4056 +"protocolType": 0, ~/~/ Тип протокола 4057 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4058 +"address": "string", ~/~/ Адрес события 4059 +"objects": [ ~/~/Объекты для ретрансляции 4668 4668 { 4669 4669 "id": "", ~/~/ Идентификатор объекта ретрансляции 4670 4670 "name": "", ~/~/ Наименование объекта ретрансляции 4671 -"imei": "", ~/~/ IMEI объекта ретрансляции4672 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4063 +"imei": "", ~/~/ IMEI объекта 4064 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4673 4673 } 4674 4674 ], 4675 -"id": "", ~/~/ Идентификаторретранслятора4676 -"parentId": "", ~/~/ Идентификаторродителя(вышестоящего клиента)4677 -"deleted": "" ~/~/ Признак удаления ретранслятора:true - включен, false - отключен4067 +"id": "", ~/~/ идентификатор пользователя 4068 +"parentId": "", ~/~/Guid родителя 4069 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4678 4678 } 4679 4679 4680 4680 ... ... @@ -4685,7 +4685,7 @@ 4685 4685 **DELETE** **/api/v3/retranslations/{id}** 4686 4686 ))) 4687 4687 4688 - id - Идентификаторретранслятора4080 +Параметр запроса: ID 4689 4689 4690 4690 4691 4691 == **Создание ретранслятора** == ... ... @@ -4698,16 +4698,16 @@ 4698 4698 Запрос: 4699 4699 4700 4700 { 4701 -"description": "", ~/~/ Поле описания ретранслятора4702 -"subscriberId": "", ~/~/ Идентификатор подписчика4703 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4704 -"address": "", ~/~/ Адрес и портпринимающегосервера4705 -"isEnabled": "", ~/~/ Признакретранслятора, true - включен, false - отключен4093 +"description": "", ~/~/ Описание 4094 +"subscriberId": "", ~/~/ Подписчик 4095 +"protocolType": 0, ~/~/ Тип протокола 4096 +"address": "", ~/~/ Адрес ретрансляции 4097 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4706 4706 "objects": [ ~/~/Объекты для ретрансляции 4707 4707 { 4708 -"id": "", ~/~/ Идентификаторретранслятора4709 -"imei": "", ~/~/ ретрансляции4710 -"isEnabled": "" ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4100 +"id": "", ~/~/ идентификатор пользователя 4101 +"imei": "", ~/~/IMEI объекта 4102 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4711 4711 } 4712 4712 ] 4713 4713 } ... ... @@ -4716,22 +4716,22 @@ 4716 4716 Ответ: 4717 4717 4718 4718 { 4719 -"description": "", ~/~/ Поле описания ретранслятора4720 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4721 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4722 -"isEnabled": true, ~/~/Признакретранслятора:true - включен, false - отключен4723 -"address": " string", ~/~/ Адреси портпринимающего сервера4724 -"objects": [ 4111 +"description": "string", ~/~/ Определяет описание 4112 +"subscriberId": "", ~/~/ идентификатор запроса 4113 +"protocolType": 0, ~/~/ Тип протокола 4114 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4115 +"address": "", ~/~/ Адрес события 4116 +"objects": [ ~/~/Объекты для ретрансляции 4725 4725 { 4726 -"id": "", ~/~/ Идентификатор объектаретрансляции4727 -"name": "string", ~/~/ На именование объекта ретрансляции4728 -"imei": "", ретрансляции4729 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4118 +"id": "", ~/~/ идентификатор пользователя 4119 +"name": "string", ~/~/ Название уведомления 4120 +"imei": "string", ~/~/IMEI объекта 4121 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4730 4730 } 4731 - ], 4732 -"id": "", ~/~/ Идентификаторретранслятора4733 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4734 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4123 + ], 4124 +"id": "", ~/~/ идентификатор пользователя 4125 +"parentId": "", ~/~/ Guid идентификатор родителя 4126 +"deleted": true ~/~/ Признак удаления 4735 4735 } 4736 4736 4737 4737 ... ... @@ -4745,18 +4745,18 @@ 4745 4745 Пример запроса: 4746 4746 4747 4747 { 4748 -"id": "", ~/~/ Идентификаторретранслятора4749 -"description": "string", ~/~/ Поле описания ретранслятора4750 -"subscriberId": "", ~/~/ Идентификатор подписчика4751 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4752 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4753 -"address": "string", ~/~/ Адрес и портпринимающего сервера4754 -"objects": ~/~/ 4140 +"id": "", ~/~/ идентификатор пользователя 4141 +"description": "string", ~/~/ Определяет описание 4142 +"subscriberId": "", ~/~/ идентификатор запроса 4143 +"protocolType": 0, ~/~/ Тип протокола 4144 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4145 +"address": "string", ~/~/ Адрес события 4146 +"objects": ~/~/Объекты для ретрансляции 4755 4755 [ 4756 4756 { 4757 -"id": "", ~/~/ Идентификатор объектаретрансляции4758 -"imei": "", ~/~/ ретрансляции4759 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4149 +"id": "", ~/~/ идентификатор пользователя 4150 +"imei": "", ~/~/IMEI объекта 4151 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4760 4760 } 4761 4761 ] 4762 4762 } ... ... @@ -4765,22 +4765,22 @@ 4765 4765 Пример ответа: 4766 4766 4767 4767 { 4768 -"description": "", ~/~/ Поле описания ретранслятора4769 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4770 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4771 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4772 -"address": "string", ~/~/ Адрес и портпринимающего сервера4773 -"objects": [ ~/~/ 4160 +"description": "", ~/~/ Определяет описание 4161 +"subscriberId": "", ~/~/ идентификатор запроса 4162 +"protocolType": 0, ~/~/ Тип протокола 4163 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4164 +"address": "string", ~/~/ Адрес события 4165 +"objects": [ ~/~/Объекты для ретрансляции 4774 4774 { 4775 -"id": "", ~/~/ Идентификатор объектаретрансляции4776 -"name": "string", ~/~/ На именование объекта ретрансляции4777 -"imei": "", ~/~/ ретрансляции4778 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4167 +"id": "", ~/~/ идентификатор пользователя 4168 +"name": "string", ~/~/ Название уведомления 4169 +"imei": "", ~/~/IMEI объекта 4170 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4779 4779 } 4780 4780 ], 4781 -"id": "", ~/~/ Идентификаторретранслятора4782 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4783 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4173 +"id": "", ~/~/ идентификатор пользователя 4174 +"parentId": "", ~/~/ Guid идентификатор родителя 4175 +"deleted": true ~/~/ Признак удаления 4784 4784 } 4785 4785 4786 4786 ... ... @@ -4794,9 +4794,9 @@ 4794 4794 Пример запроса: 4795 4795 4796 4796 { 4797 -"id": "", ~/~/ Идентификаторретранслятора4798 -"search": "string", ~/~/ 4799 -"parentId": "" ~/~/ Идентификатор родительскогоагента, для которого надо получить данные(обязательный параметр).4189 +"id": "", ~/~/ идентификатор пользователя 4190 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4191 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4800 4800 } 4801 4801 4802 4802 Ответ: ... ... @@ -4803,14 +4803,14 @@ 4803 4803 4804 4804 [ 4805 4805 { 4806 -"description": "", ~/~/ Поле описания ретранслятора4807 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4808 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4809 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4810 -"address": "string", ~/~/ Адрес и портпринимающего сервера4811 -"id": "", ~/~/ Идентификаторретранслятора4812 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4813 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4198 +"description": "", ~/~/ Определяет описание 4199 +"subscriberId": "", ~/~/ идентификатор запроса 4200 +"protocolType": 0, ~/~/ Тип протокола 4201 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4202 +"address": "string", ~/~/ Адрес события 4203 +"id": "", ~/~/ идентификатор пользователя 4204 +"parentId": "", ~/~/ Guid идентификатор родителя 4205 +"deleted": true ~/~/ Признак удаления 4814 4814 } 4815 4815 ] 4816 4816 ... ... @@ -4821,7 +4821,7 @@ 4821 4821 4822 4822 (% class="box infomessage" %) 4823 4823 ((( 4824 - **POST /api/v3/Reports/harvesterUnloading**4216 +POST **/api/v3/Reports/harvesterUnloading** 4825 4825 ))) 4826 4826 4827 4827 Пример запроса: ... ... @@ -4893,743 +4893,7 @@ 4893 4893 ] 4894 4894 4895 4895 4896 -== **Отчет трек-датчики** == 4897 - 4898 -(% class="box infomessage" %) 4899 -((( 4900 -**POST /api/v3/Reports/sensorsWorks** 4901 -))) 4902 - 4903 -**Пример запроса:** 4904 - 4905 -{ 4906 - "vehicleIds": [ ~/~/ Список ID объектов 4907 - 0 4908 - ], 4909 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4910 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4911 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4912 -} 4913 - 4914 -**Пример ответа:** 4915 - 4916 -((( 4917 -{ 4918 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4919 - { 4920 - "vehicleId": 0, ~/~/ Идентификатор ТС 4921 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4922 - { 4923 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4924 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4925 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4926 - "name": "string", ~/~/ Наименование оборудования. 4927 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4928 - "totalMileage": 0, ~/~/ Общий пробег. 4929 - "avgSpeed": 0 ~/~/ Средняя скорость. 4930 - } 4931 - ] 4932 - } 4933 - ] 4934 -} 4935 - 4936 - 4937 -== **Превышение скорости** == 4938 - 4939 -(% class="box infomessage" %) 4940 -((( 4941 -**POST /api/v3/Reports/overSpeedDuration** 4942 -))) 4943 - 4944 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 4945 - 4946 -Пример запроса: 4947 - 4948 -((( 4949 -{ 4950 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 4951 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 4952 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 4953 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4954 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 4955 -} 4956 -))) 4957 - 4958 -((( 4959 - 4960 -))) 4961 - 4962 -((( 4963 -Пример ответа: 4964 -))) 4965 - 4966 -((( 4967 -((( 4968 -[ 4969 - { 4970 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 4971 - "duration": 0, ~/~/ Продолжительность события в секундах 4972 - "maxSpeed": 0, ~/~/ Максимальная скорость 4973 - "speedLimit": 0 ~/~/ Ограничение скорости 4974 - } 4975 -] 4976 -))) 4977 -))) 4978 -))) 4979 - 4980 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4981 - 4982 - 4983 -== **Запрос списка полей** == 4984 - 4985 -(% class="box successmessage" %) 4986 -((( 4987 -**POST /api/v3/agroLands/find** 4988 -))) 4989 - 4990 -Пример запроса: 4991 - 4992 -((( 4993 -((( 4994 -((( 4995 -{ 4996 - "year": 0, ~/~/ Фильтр по году 4997 - "name": "string", ~/~/ Фильтр по названию 4998 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 4999 -} 5000 -))) 5001 -))) 5002 - 5003 - 5004 -))) 5005 - 5006 -Пример ответа: 5007 - 5008 -((( 5009 -[ 5010 - { 5011 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5012 - "year": 0, ~/~/ Год поля 5013 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 5014 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 5015 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5016 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5017 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5018 - "counts": { ~/~/ Счётчики с/х поля 5019 - "fieldOperations": 0, ~/~/ Количество операций на поле 5020 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5021 - "facts": 0 ~/~/ Счётчик факта 5022 - }, 5023 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5024 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5025 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5026 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5027 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5028 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5029 - "planComment": "string", ~/~/ Комментарий к полю 5030 - "productivity": 0, ~/~/ Урожайность. 5031 - "id": 0, ~/~/ Идентификатор объекта геозоны 5032 - "name": "string", ~/~/ Название объекта геозоны 5033 - "type": 0, ~/~/ Тип объекта геозоны 5034 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5035 - "fname": "string", ~/~/ Имя файла 5036 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5037 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 5038 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 5039 - "description": "string", ~/~/ Описание объекта геозоны 5040 - "area": 0, ~/~/ Площадь, м2 5041 - "perimetr": 0, ~/~/ Периметр, м 5042 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 5043 - } 5044 -] 5045 - 5046 - 5047 -== **Создание нового поля ** == 5048 - 5049 -(% class="box successmessage" %) 5050 -((( 5051 -**POST /api/v3/agroLands** 5052 -))) 5053 - 5054 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 5055 -X-agent - ID клиента 5056 - 5057 -Пример запроса: 5058 - 5059 -((( 5060 -{ 5061 - "extId": "string", 5062 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля 5063 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля 5064 - "display": "string", ~/~/ Настройки отображения 5065 - "year": 0, ~/~/ Год поля 5066 - "name": "string", ~/~/ Наименование 5067 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5068 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая 5069 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая 5070 - "planComment": "string", ~/~/ Комментарий к полю 5071 - "cropRotations": [ ~/~/ Данные по севообороту 5072 - { 5073 - "landId": 0, ~/~/ ID поля 5074 - "landName": "string", ~/~/ Название поля 5075 - "year": 0, ~/~/ Год урожая 5076 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5077 - "cultureName": "string", ~/~/ Название культуры 5078 - "productivity": 0, ~/~/ Урожайность 5079 - "area": 0, ~/~/ Площадь поля, Га 5080 - "total": 0, ~/~/ Валовый сбор 5081 - "productivityFact": 0, ~/~/ Фактическая урожайность 5082 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5083 - "totalFact": 0, ~/~/ Фактический валовый сбор 5084 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ 5085 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева 5086 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая 5087 - "isyearplan": true, ~/~/ Годовой план 5088 - "comment": "string" ~/~/ Комментарий 5089 - } 5090 - ] 5091 -} 5092 -))) 5093 - 5094 -((( 5095 - 5096 -))) 5097 - 5098 -Пример ответа: 5099 - 5100 -((( 5101 -((( 5102 -{ 5103 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5104 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5105 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5106 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5107 - "cropRotations": [ ~/~/ Данные по севообороту 5108 - { 5109 - "landId": 0, ~/~/ ID поля 5110 - "landName": "string", ~/~/ Название поля 5111 - "year": 0, ~/~/ Год урожая 5112 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5113 - "cultureName": "string", ~/~/ Название культуры 5114 - "productivity": 0, ~/~/ Урожайность 5115 - "area": 0, ~/~/ Площадь поля, Га. 5116 - "total": 0, ~/~/ Валовый сбор 5117 - "productivityFact": 0, ~/~/ Фактическая урожайность 5118 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5119 - "totalFact": 0, ~/~/ Фактический валовый сбор 5120 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ 5121 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева 5122 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая 5123 - "isyearplan": true, ~/~/ годовой план 5124 - "comment": "string" ~/~/ Комментарий 5125 - } 5126 - ], 5127 - "cropVegetation": [ ~/~/ История вегетации поля 5128 - { 5129 - "values": [ ~/~/ Данные вегетации и состояния посева 5130 - { 5131 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5132 - "ndvi": 0 ~/~/ Индекс вегетации 5133 - } 5134 - ], 5135 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5136 - { 5137 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5138 - "type": "string", ~/~/ Тип 5139 - "pictureid": "string" ~/~/ Идентификатор ресурса 5140 - } 5141 - ], 5142 - "states": [ ~/~/ Ключевые даты развития поля 5143 - { 5144 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 5145 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5146 - } 5147 - ] 5148 - } 5149 - ], 5150 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая 5151 - "counts": { 5152 - "fieldOperations": 0, ~/~/ Количество операций на поле 5153 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5154 - "facts": 0 ~/~/ Счётчик факта 5155 - }, 5156 - "planComment": "string", ~/~/ Комментарий к полю 5157 -))) 5158 - 5159 -((( 5160 - "productivity": 0, ~/~/ Урожайность. 5161 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5162 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая 5163 - "year": 0, ~/~/ Год поля 5164 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5165 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5166 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5167 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5168 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто 5169 - "id": 0, ~/~/ Идентификатор объекта геозоны 5170 - "name": "string", ~/~/ Название объекта геозоны 5171 - "type": 0, ~/~/ Тип объекта геозоны 5172 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5173 - "fname": "string", ~/~/ Имя файла 5174 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5175 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны 5176 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны 5177 - "description": "string", ~/~/ Описание объекта геозоны 5178 - "area": 0, ~/~/ Площадь, м2 5179 - "perimetr": 0, ~/~/ Периметр, м 5180 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5181 -} 5182 - 5183 - 5184 -))) 5185 -))) 5186 -))) 5187 - 5188 -== **Получение поля по id** == 5189 - 5190 -(% class="box infomessage" %) 5191 -((( 5192 -**GET /api/v3/agroLands/{id}** 5193 -))) 5194 - 5195 -Пример запроса: 5196 -id ~/~/ Идентификатор поля 5197 - 5198 -Пример ответа: 5199 - 5200 -((( 5201 -{ 5202 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5203 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5204 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5205 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5206 - "cropRotations": [ ~/~/ Данные по севообороту 5207 - { 5208 - "landId": 0, ~/~/ ID поля 5209 - "landName": "string", ~/~/ Название поля 5210 - "year": 0, ~/~/ Год урожая 5211 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5212 - "cultureName": "string", ~/~/ Название культуры 5213 - "productivity": 0, ~/~/ Урожайность 5214 - "area": 0, ~/~/ Площадь поля, Га 5215 - "total": 0, ~/~/ Валовый сбор 5216 - "productivityFact": 0, ~/~/ Фактическая урожайность 5217 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5218 - "totalFact": 0, ~/~/ Фактический валовый сбор 5219 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5220 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5221 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5222 - "isyearplan": true, ~/~/ План года 5223 - "comment": "string" ~/~/ Комментарий 5224 - } 5225 - ], 5226 - "cropVegetation": [ ~/~/ История вегетации поля 5227 - { 5228 - "values": [ ~/~/ Данные вегетации и состояния посева 5229 - { 5230 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5231 - "ndvi": 0 ~/~/ Индекс вегетации 5232 - } 5233 - ], 5234 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5235 - { 5236 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5237 - "type": "string", ~/~/ Тип 5238 - "pictureid": "string" ~/~/ Идентификатор ресурса 5239 - } 5240 - ], 5241 - "states": [ ~/~/ Ключевые даты развития поля 5242 - { 5243 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5244 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5245 - } 5246 - ] 5247 - } 5248 - ], 5249 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5250 - "counts": { 5251 - "fieldOperations": 0, ~/~/ Количество операций на поле 5252 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5253 - "facts": 0 ~/~/ Счётчик факта 5254 - }, 5255 - "planComment": "string", ~/~/ Комментарий к полю 5256 - "productivity": 0, ~/~/ Урожайность. 5257 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5258 -))) 5259 - 5260 -((( 5261 -((( 5262 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5263 - "year": 0, ~/~/ Год поля 5264 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5265 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5266 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5267 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5268 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5269 - "id": 0, ~/~/ Идентификатор объекта геозоны 5270 - "name": "string", ~/~/ Название объекта геозоны 5271 - "type": 0, ~/~/ Тип объекта геозоны 5272 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5273 - "fname": "string", ~/~/ Имя файла 5274 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5275 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5276 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5277 - "description": "string", ~/~/ Описание объекта геозоны 5278 - "area": 0, ~/~/ Площадь, м2 5279 - "perimetr": 0, ~/~/ Периметр, м 5280 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5281 -} 5282 -))) 5283 - 5284 - 5285 -((( 5286 -((( 5287 -((( 5288 -== **Изменение поля** == 5289 - 5290 -(% class="box infomessage" %) 5291 -((( 5292 -**PUT /api/v3/agroLands** 5293 -))) 5294 - 5295 -Пример запроса: 5296 - 5297 -((( 5298 -((( 5299 -{ 5300 - "id": 0, ~/~/ Идентификатор поля 5301 - "extId": "string", ~/~/ ExtId 5302 - "shape": "string", ~/~/ Форма поля 5303 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5304 - "display": "string", ~/~/ Настройки отображения 5305 - "year": 0, ~/~/ Год поля 5306 - "name": "string", ~/~/ Наименование 5307 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5308 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая 5309 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая 5310 - "planComment": "string", ~/~/Комментарий к полю 5311 - "cropRotations": [ ~/~/ Данные по севообороту 5312 - { 5313 - "landId": 0, ~/~/ ID поля 5314 - "landName": "string", ~/~/ Название поля 5315 - "year": 0, ~/~/ Год урожая 5316 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5317 - "cultureName": "string", ~/~/ Название культуры 5318 - "productivity": 0, ~/~/ Урожайность 5319 - "area": 0, ~/~/ Площадь поля, Га. 5320 - "total": 0, ~/~/ Валовый сбор 5321 - "productivityFact": 0, ~/~/ Фактическая урожайность 5322 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5323 - "totalFact": 0, ~/~/ Фактический валовый сбор 5324 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ 5325 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева 5326 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая 5327 - "isyearplan": true, 5328 - "comment": "string" ~/~/ Комментарий 5329 - } 5330 - ], 5331 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику 5332 -} 5333 -))) 5334 -))) 5335 - 5336 -((( 5337 - 5338 -))) 5339 - 5340 -Пример ответа: 5341 - 5342 -((( 5343 -((( 5344 -((( 5345 -{ 5346 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5347 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5348 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5349 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5350 - "cropRotations": [ ~/~/ Данные по севообороту 5351 - { 5352 - "landId": 0, ~/~/ ID поля 5353 - "landName": "string", ~/~/ Название поля 5354 - "year": 0, ~/~/ Год урожая 5355 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5356 - "cultureName": "string", ~/~/ Название культуры 5357 - "productivity": 0, ~/~/ Урожайность 5358 - "area": 0, ~/~/ Площадь поля, Га 5359 - "total": 0, ~/~/ Валовый сбор 5360 - "productivityFact": 0, ~/~/ Фактическая урожайность 5361 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5362 - "totalFact": 0, ~/~/ Фактический валовый сбор 5363 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ 5364 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева 5365 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая 5366 - "isyearplan": true, ~/~/ 5367 - "comment": "string" ~/~/ Комментарий 5368 - } 5369 - ], 5370 - "cropVegetation": [ ~/~/ История вегетации поля 5371 - { 5372 - "values": [ ~/~/ Данные вегетации и состояния посева 5373 - { 5374 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5375 - "ndvi": 0 ~/~/ Индекс вегетации 5376 - } 5377 - ], 5378 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5379 - { 5380 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5381 - "type": "string", ~/~/ Тип 5382 - "pictureid": "string" ~/~/ Идентификатор ресурса 5383 - } 5384 - ], 5385 - "states": [ ~/~/ Ключевые даты развития поля 5386 - { 5387 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5388 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5389 - } 5390 - ] 5391 - } 5392 - ], 5393 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая 5394 - "counts": { 5395 - "fieldOperations": 0, ~/~/ Количество операций на поле 5396 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5397 - "facts": 0 ~/~/ Счётчик факта 5398 - }, 5399 - "planComment": "string", ~/~/ Комментарий к полю 5400 - "productivity": 0, ~/~/ Урожайность. 5401 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5402 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая 5403 - "year": 0, ~/~/ Год поля 5404 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5405 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5406 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5407 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5408 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5409 - "id": 0, ~/~/ Идентификатор объекта геозоны 5410 - "name": "string", ~/~/ Название объекта геозоны 5411 - "type": 0, ~/~/ Тип объекта геозоны 5412 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5413 - "fname": "string", ~/~/ Имя файла 5414 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5415 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны 5416 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны 5417 - "description": "string", ~/~/ Описание объекта геозоны 5418 - "area": 0, ~/~/ Площадь, м2 5419 - "perimetr": 0, ~/~/ Периметр, м 5420 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд 5421 -} 5422 -))) 5423 -))) 5424 -))) 5425 -))) 5426 -))) 5427 - 5428 - 5429 -== **Редактирование года урожая ** == 5430 - 5431 -(% class="box successmessage" %) 5432 -((( 5433 -**POST /api/v3/agroLands/updateOpenCloseYear** 5434 -))) 5435 - 5436 -Пример запроса: 5437 - 5438 -((( 5439 -((( 5440 -{ 5441 - "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5442 - 0 5443 - ], 5444 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5445 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5446 -} 5447 -))) 5448 - 5449 - 5450 -))) 5451 - 5452 -Пример ответа: 5453 - 5454 -((( 5455 -((( 5456 -{ 5457 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5458 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5459 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5460 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5461 - "cropRotations": [ ~/~/ Данные по севообороту 5462 - { 5463 - "landId": 0, ~/~/ ID поля 5464 - "landName": "string", ~/~/ Название поля 5465 - "year": 0, ~/~/ Год урожая 5466 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5467 - "cultureName": "string", ~/~/ Название культуры 5468 - "productivity": 0, ~/~/ Урожайность 5469 - "area": 0, ~/~/ Площадь поля, Га. 5470 - "total": 0, ~/~/ Валовый сбор 5471 - "productivityFact": 0, ~/~/ Фактическая урожайность 5472 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5473 - "totalFact": 0, ~/~/ Фактический валовый сбор 5474 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5475 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5476 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5477 - "isyearplan": true, ~/~/ 5478 - "comment": "string" ~/~/ Комментарий 5479 - } 5480 - ], 5481 - "cropVegetation": [ ~/~/ История вегетации поля 5482 - { 5483 - "values": [ ~/~/ Данные вегетации и состояния посева 5484 - { 5485 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5486 - "ndvi": 0 ~/~/ Индекс вегетации 5487 - } 5488 - ], 5489 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5490 - { 5491 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5492 - "type": "string", ~/~/ Тип 5493 - "pictureid": "string" ~/~/ Идентификатор ресурса 5494 - } 5495 - ], 5496 - "states": [ ~/~/ Ключевые даты развития поля 5497 - { 5498 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5499 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5500 - } 5501 - ] 5502 - } 5503 - ], 5504 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5505 - "counts": { 5506 - "fieldOperations": 0, ~/~/ Количество операций на поле 5507 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5508 - "facts": 0 ~/~/ Счётчик факта 5509 - }, 5510 - "planComment": "string", ~/~/ Комментарий к полю 5511 - "productivity": 0, ~/~/ Урожайность. 5512 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5513 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5514 - "year": 0, ~/~/ Год поля 5515 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5516 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5517 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5518 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5519 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5520 - "id": 0, ~/~/ Идентификатор объекта геозоны 5521 - "name": "string", ~/~/ Название объекта геозоны 5522 - "type": 0, ~/~/ Тип объекта геозоны 5523 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5524 - "fname": "string", ~/~/ Имя файла 5525 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5526 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5527 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5528 - "description": "string", ~/~/ Описание объекта геозоны 5529 - "area": 0, ~/~/ Площадь, м2 5530 - "perimetr": 0, ~/~/ ериметр, м 5531 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5532 -} 5533 - 5534 - 5535 -== **Какие поля посещал объект** == 5536 - 5537 -(% class="box successmessage" %) 5538 -((( 5539 -**POST /api/v3/agroLands/visitingByVehicle** 5540 -))) 5541 - 5542 -Пример запроса: 5543 - 5544 -{ 5545 - "vehicleId": 0, ~/~/ id объекта 5546 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5547 - "byTime": 0, ~/~/ Объединение событий по времени 5548 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5549 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5550 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5551 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5552 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5553 -} 5554 - 5555 -Пример ответа: 5556 - 5557 -[ 5558 - { 5559 - "fieldId": 0, ~/~/ id объекта 5560 - "vehicleName": "string", ~/~/ Наименование объекта 5561 - "fieldName": "string", ~/~/ Наименование поля 5562 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5563 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5564 - "vehicleId": 0, ~/~/ Идентификатор ТС 5565 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5566 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5567 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5568 - "mileage": 0 ~/~/ Пробег 5569 - } 5570 -] 5571 -))) 5572 - 5573 - 5574 -== **Посещение поля объектами ** == 5575 - 5576 -(% class="box successmessage" %) 5577 -((( 5578 -**POST /api/v3/agroLands/visitingByField** 5579 -))) 5580 - 5581 -Пример запроса: 5582 -{ 5583 - "fieldId": 0, ~/~/ ID поля 5584 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5585 - "byTime": 0, ~/~/ Объединение событий по времени 5586 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5587 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5588 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5589 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5590 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5591 -} 5592 - 5593 -Пример ответа: 5594 - 5595 -[ 5596 - { 5597 - "fieldId": 0, ~/~/ ID поля 5598 - "vehicleName": "string", ~/~/ Наименование объекта 5599 - "fieldName": "string", ~/~/ Имя поля 5600 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5601 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5602 - "vehicleId": 0, ~/~/ Идентификатор ТС 5603 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5604 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5605 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5606 - "mileage": 0 ~/~/ Пробег 5607 - } 5608 -] 5609 - 5610 - 5611 -== **Удаление существующего поля** == 5612 - 5613 -(% class="box errormessage" %) 5614 -((( 5615 -**DELETE /api/v3/agroLands/{id}** 5616 -))) 5617 - 5618 -Пример запроса: 5619 -id ~/~/ Идентификатор поля 5620 - 5621 -Пример ответа: 5622 - 5623 -((( 5624 -200 ~/~/ Успех 5625 - 5626 - 5627 -))) 5628 - 5629 5629 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5630 -))) 5631 -))) 5632 -))) 5633 5633 5634 5634 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5635 5635 ... ... @@ -5636,7 +5636,7 @@ 5636 5636 5637 5637 (% class="box infomessage" %) 5638 5638 ((( 5639 - **GET api/v3/Vehicles/recyclebin/all**4295 +GET api/v3/Vehicles/recyclebin/all 5640 5640 ))) 5641 5641 5642 5642 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5671,11 +5671,11 @@ 5671 5671 ] 5672 5672 5673 5673 5674 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==4330 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5675 5675 5676 5676 (% class="box infomessage" %) 5677 5677 ((( 5678 - **POST**4334 +POST/api/v3/Vehicles/recyclebin/erase 5679 5679 ))) 5680 5680 5681 5681 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5717,7 +5717,7 @@ 5717 5717 5718 5718 (% class="box infomessage" %) 5719 5719 ((( 5720 - **POST**4376 +POST/api/v3/Vehicles/recyclebin/restore 5721 5721 ))) 5722 5722 5723 5723 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5769,782 +5769,7 @@ 5769 5769 ] 5770 5770 5771 5771 5772 -= **Раздел: Журнал заданий ** = 5773 5773 5774 - 5775 -== **Создание задания в Журнале заданий** == 5776 - 5777 -(% class="box infomessage" %) 5778 -((( 5779 -**POST /api/v3/vehicletasks** 5780 -))) 5781 - 5782 -Пример запроса: 5783 - 5784 -((( 5785 -{ 5786 - "vehicleId": 0, ~/~/ Идентификатор ТС 5787 - "description": "string", ~/~/ Описание 5788 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5789 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5790 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5791 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5792 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5793 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5794 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5795 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5796 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5797 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5798 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5799 - "cost": { 5800 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5801 - "Name": "string", ~/~/ Наименование 5802 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5803 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5804 - "Norm": 0 ~/~/ Норма внесения 5805 - }, 5806 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5807 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5808 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5809 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5810 - "deleted": true, ~/~/ Признак удаления 5811 - "extId": "string", 5812 - "GeoIds": [ ~/~/ Cвязанные поля 5813 - 0 5814 - ] 5815 -} 5816 -))) 5817 - 5818 - 5819 -Пример ответа: 5820 - 5821 -{ 5822 - "vehicleId": 0, ~/~/ Идентификатор ТС 5823 - "description": "string", ~/~/ Описание 5824 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5825 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5826 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5827 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5828 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5829 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5830 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5831 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5832 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5833 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5834 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5835 - "cost": { 5836 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5837 - "Name": "string", ~/~/ Наименование 5838 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5839 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5840 - "Norm": 0 ~/~/ Норма внесения 5841 - }, 5842 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5843 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5844 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5845 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5846 - "deleted": true, ~/~/ Признак удаления 5847 - "extId": "string", ~/~/ ExtId 5848 - "GeoIds": [ ~/~/ Связанные поля 5849 - 0 5850 - ] 5851 -} 5852 - 5853 - 5854 -== **Редактирование задания в Журнале заданий** == 5855 - 5856 -(% class="box successmessage" %) 5857 -((( 5858 -**PUT /api/v3/vehicletasks** 5859 -))) 5860 - 5861 -Пример запроса: 5862 - 5863 -((( 5864 -{ 5865 - "vehicleId": 0, ~/~/ Идентификатор ТС 5866 - "description": "string", ~/~/ Описание 5867 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5868 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5869 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5870 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5871 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5872 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5873 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5874 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5875 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5876 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5877 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5878 - "cost": { 5879 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5880 - "Name": "string", ~/~/ Наименование 5881 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5882 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5883 - "Norm": 0 ~/~/ Норма внесения 5884 - }, 5885 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5886 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5887 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5888 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5889 - "deleted": true, ~/~/ Признак удаления 5890 - "extId": "string", ~/~/ ExtId 5891 - "GeoIds": [ ~/~/ Связанные поля 5892 - 0 5893 - ] 5894 -} 5895 -))) 5896 - 5897 - 5898 -Пример ответа: 5899 - 5900 -{ 5901 - "vehicleId": 0, ~/~/ Идентификатор ТС 5902 - "description": "string", ~/~/ Описание 5903 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5904 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5905 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5906 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5907 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5908 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5909 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5910 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5911 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5912 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5913 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5914 - "cost": { 5915 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5916 - "Name": "string", ~/~/ Наименование 5917 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5918 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5919 - "Norm": 0 ~/~/ Норма внесения 5920 - }, 5921 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5922 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5923 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5924 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5925 - "deleted": true, ~/~/ Признак удаления 5926 - "extId": "string", ~/~/ ExtId 5927 - "GeoIds": [ ~/~/ Связанные поля 5928 - 0 5929 - ] 5930 -} 5931 - 5932 - 5933 -== **Удаление задания в Журнале заданий** == 5934 - 5935 -(% class="box warningmessage" %) 5936 -((( 5937 -**DELETE /api/v3/vehicletasks** 5938 -))) 5939 - 5940 -Пример запроса: 5941 - 5942 -((( 5943 -[ 5944 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5945 -] 5946 -))) 5947 - 5948 -((( 5949 - 5950 -))) 5951 - 5952 -Пример ответа: 5953 - 5954 -{ 5955 - "vehicleId": 0, ~/~/ Идентификатор ТС 5956 - "description": "string", ~/~/ Описание 5957 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5958 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5959 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5960 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5961 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5962 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5963 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5964 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5965 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5966 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5967 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5968 - "cost": { 5969 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5970 - "Name": "string", ~/~/ Наименование 5971 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5972 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5973 - "Norm": 0 ~/~/ Норма внесения 5974 - }, 5975 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5976 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5977 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5978 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5979 - "deleted": true, ~/~/ Признак удаления 5980 - "extId": "string", ~/~/ ExtId 5981 - "GeoIds": [ ~/~/ Связанные поля 5982 - 0 5983 - ] 5984 -} 5985 - 5986 - 5987 -== **Получение списка Журнала заданий** == 5988 - 5989 -(% class="box infomessage" %) 5990 -((( 5991 -**POST /api/v3/vehicletasks/getbyperiod** 5992 -))) 5993 - 5994 -Пример запроса: 5995 - 5996 -((( 5997 -{ 5998 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 5999 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 6000 - "TimeZone": 0, ~/~/ Часовой пояс. 6001 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 6002 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 6003 - ], 6004 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 6005 - 0 6006 - ], 6007 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 6008 - 0 6009 - ], 6010 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 6011 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 6012 -} 6013 -))) 6014 - 6015 - 6016 -Пример ответа: 6017 - 6018 -((( 6019 -{ 6020 - "total": 0, ~/~/ Общее количество записей 6021 - "pages": 0, ~/~/ Общее количество страниц 6022 - "currentPage": 0, ~/~/ Текущая страница 6023 - "items": [ ~/~/ Записи 6024 - { 6025 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6026 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 6027 - "name": "string", ~/~/ Название задания. 6028 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 6029 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 6030 - "workKind": "string", ~/~/ Вид работ 6031 - "techOp": "string", ~/~/ Тех. операция 6032 - "trailerModel": "string", ~/~/ Модель агрегата 6033 - "width": "string", ~/~/ Ширина, м 6034 - "speed": "string", ~/~/ Тех. скорость 6035 - "fields": "string", ~/~/ Поля 6036 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 6037 - "vehicles": "string", ~/~/ Объект-модель 6038 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 6039 - "drivers": "string", ~/~/ Водители 6040 - "tmc": "string", ~/~/ ТМЦ 6041 - "client": "string", ~/~/ Клиент 6042 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6043 - "dep": "string", ~/~/ Подразделение 6044 - "geoIds": [ ~/~/ Связанные поля 6045 - 0 6046 - ] 6047 - } 6048 - ] 6049 -} 6050 -))) 6051 - 6052 - 6053 -= **Раздел: Роли** = 6054 - 6055 -== **Получение списка клиентских и системных ролей пользователя ** == 6056 - 6057 -(% class="box successmessage" %) 6058 -((( 6059 -**POST /api/v3/groups/find** 6060 -))) 6061 - 6062 -Пример запроса: 6063 - 6064 -((( 6065 -{ 6066 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6067 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6068 -} 6069 -))) 6070 - 6071 -((( 6072 - 6073 -))) 6074 - 6075 -((( 6076 -Пример ответа: 6077 -))) 6078 - 6079 -((( 6080 -((( 6081 -{ 6082 - "groups": [ ~/~/ Системные роли пользователя 6083 - { 6084 - "code": "string", ~/~/ Код роли. 6085 - "name": "string", ~/~/ Имя 6086 - "shortName": "string" ~/~/ Короткое имя 6087 - } 6088 - ], 6089 - "customGroups": [ ~/~/ Системные роли пользователя 6090 - { 6091 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6092 - "name": "string", ~/~/ Наименование 6093 - "shortName": "string", ~/~/ Короткое наименование 6094 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6095 - } 6096 - ] 6097 -} 6098 -))) 6099 -))) 6100 - 6101 -((( 6102 - 6103 -))) 6104 - 6105 -((( 6106 - 6107 -))) 6108 - 6109 -= **Раздел: Локатор ** = 6110 - 6111 - 6112 -== **Получение данных по локатору** == 6113 - 6114 -(% class="box infomessage" %) 6115 -((( 6116 -**GET /api/v3/locators/{locatorId}** 6117 -))) 6118 - 6119 -В запросе указывается locatorid - идентификатор локатора 6120 - 6121 - 6122 -Пример ответа: 6123 - 6124 -((( 6125 -((( 6126 -{ 6127 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6128 - 0 6129 - ], 6130 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6131 - 0 6132 - ], 6133 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6134 - 0 6135 - ], 6136 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6137 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6138 - "agentName": "string", ~/~/ Наименование агента. 6139 - "isEnabled": true, ~/~/ Активность 6140 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6141 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6142 - "name": "string", ~/~/ Наименование. 6143 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6144 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6145 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6146 - "validity": 0, ~/~/ Значение срока действия 6147 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6148 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6149 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6150 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6151 - "url": "string", ~/~/ Ссылка 6152 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6153 - 6154 - "showVehicleName": true, ~/~/ Наименование объекта 6155 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6156 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6157 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6158 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6159 - "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ГИС) 6160 - 6161 - 1 6162 - 6163 - ] 6164 -} 6165 -))) 6166 -))) 6167 - 6168 - 6169 -((( 6170 -((( 6171 - 6172 -))) 6173 -))) 6174 - 6175 - 6176 -== **Создание локатора** == 6177 - 6178 -(% class="box successmessage" %) 6179 -((( 6180 -**POST /api/v3/locators** 6181 -))) 6182 - 6183 -Пример запроса: 6184 - 6185 -((( 6186 -{ 6187 - "isEnabled": true, ~/~/ Активность 6188 - "name": "string", ~/~/ Наименование локатора 6189 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6190 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6191 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6192 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6193 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6194 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6195 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6196 - 0 6197 - ], 6198 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6199 - 0 6200 - ], 6201 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6202 - 0 6203 - ], 6204 - 6205 - "showVehicleName": true, ~/~/ Наименование объекта 6206 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6207 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6208 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6209 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6210 - "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ГИС) 6211 - 6212 - 1 6213 - 6214 - ] 6215 -} 6216 -))) 6217 - 6218 - 6219 -Пример ответа: 6220 - 6221 -((( 6222 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6223 -))) 6224 - 6225 - 6226 -== **Выводит список локаторов ** == 6227 - 6228 -(% class="box successmessage" %) 6229 -((( 6230 -**POST /api/v3/locators/find** 6231 -))) 6232 - 6233 -Пример запроса: 6234 - 6235 -((( 6236 -{ 6237 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6238 -} 6239 -))) 6240 - 6241 -((( 6242 - 6243 -))) 6244 - 6245 -((( 6246 - 6247 -))) 6248 - 6249 - 6250 -Пример ответа: 6251 - 6252 -((( 6253 -[ 6254 - { 6255 - "vehiclesCount": 0, ~/~/ Количество объектов. 6256 - "geozonesCount": 0, ~/~/ Количество геозон. 6257 - "fieldsCount": 0, ~/~/ Количество полей. 6258 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6259 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6260 - "agentName": "string", ~/~/ Наименование агента. 6261 - "isEnabled": true, ~/~/ Активность локатора 6262 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6263 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6264 - "name": "string", ~/~/ Наименование локатора 6265 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6266 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6267 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6268 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6269 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6270 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6271 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6272 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6273 - "url": "string", ~/~/ ссылка на локатор 6274 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6275 - "showVehicleName": true, ~/~/ Наименование объекта 6276 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6277 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6278 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6279 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6280 - "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ГИС) 6281 - 6282 - 0 6283 - ] 6284 - } 6285 -] 6286 -))) 6287 - 6288 - 6289 -== **Изменение локатора** == 6290 - 6291 -(% class="box infomessage" %) 6292 -((( 6293 -**PUT /api/v3/locators** 6294 -))) 6295 - 6296 -Пример запроса: 6297 - 6298 -((( 6299 -{ 6300 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6301 - "isEnabled": true, ~/~/ Активность 6302 - "name": "string", ~/~/ Наименование 6303 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6304 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6305 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6306 - "autoProlongation": true, ~/~/ Автопродление срока действия 6307 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6308 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6309 - 0 6310 - ], 6311 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6312 - 0 6313 - ], 6314 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6315 - 0 6316 - ], 6317 - "showVehicleName": true, ~/~/ Наименование объекта 6318 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6319 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6320 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6321 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6322 - "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ГИС) 6323 - 6324 - 0 6325 - 6326 - ] 6327 -} 6328 - 6329 - 6330 -))) 6331 - 6332 -Пример ответа: 6333 - 6334 -200 ~/~/ Success 6335 - 6336 - 6337 -== **Удалить локатор** == 6338 - 6339 -(% class="box warningmessage" %) 6340 -((( 6341 -**DELETE /api/v3/locators** 6342 -))) 6343 - 6344 -Пример запроса: 6345 - 6346 -((( 6347 -[ 6348 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6349 -] 6350 -))) 6351 - 6352 - 6353 -= **Раздел: Яндекс Маршруты** = 6354 - 6355 - 6356 -== **Возвращение списка маршрутов** == 6357 - 6358 -(% class="box infomessage" %) 6359 -((( 6360 -**GET /api/v3/TransportRoutes** 6361 -))) 6362 - 6363 -Пример запроса: 6364 -Id ~/~/ Идентификатор поля 6365 - 6366 -Пример ответа: 6367 - 6368 -((( 6369 -[ 6370 - { 6371 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6372 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6373 - "name": "string", ~/~/ Наименование маршрута. 6374 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6375 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6376 - 0 6377 - ] 6378 - } 6379 -] 6380 -))) 6381 - 6382 - 6383 -== **Добавить маршрут** == 6384 - 6385 -(% class="box infomessage" %) 6386 -((( 6387 -**POST /api/v3/TransportRoutes** 6388 -))) 6389 - 6390 -Пример запроса: 6391 -{ 6392 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6393 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6394 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6395 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6396 - 0 6397 - ] 6398 -} 6399 - 6400 - 6401 -Пример ответа: 6402 - 6403 -((( 6404 -{ 6405 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6406 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6407 - "name": "string", ~/~/ Определяет наименование маршрута 6408 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6409 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6410 - 0 6411 - ] 6412 -} 6413 -))) 6414 - 6415 - 6416 -== **Обновление маршрута** == 6417 - 6418 -(% class="box successmessage" %) 6419 -((( 6420 -**PUT /api/v3/TransportRoutes** 6421 -))) 6422 - 6423 -Пример запроса: 6424 - 6425 -((( 6426 -{ 6427 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6428 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6429 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6430 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6431 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6432 - 0 6433 - ] 6434 -} 6435 -))) 6436 - 6437 -Пример ответа: 6438 - 6439 -((( 6440 -{ 6441 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6442 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6443 - "name": "string", ~/~/ Определяет наименование маршрута 6444 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6445 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6446 - 0 6447 - ] 6448 -} 6449 -))) 6450 - 6451 - 6452 -== **Получить связки маршрутов ТС** == 6453 - 6454 -(% class="box infomessage" %) 6455 -((( 6456 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6457 -))) 6458 - 6459 -Пример запроса: 6460 - 6461 -((( 6462 -[ 6463 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6464 -] 6465 -))) 6466 - 6467 -Пример ответа: 6468 - 6469 -((( 6470 -[ 6471 - { 6472 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6473 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6474 - } 6475 -] 6476 -))) 6477 - 6478 - 6479 -== **Удалить маршрут** == 6480 - 6481 -(% class="box warningmessage" %) 6482 -((( 6483 -**DELETE /api/v3/TransportRoutes/{id}** 6484 -))) 6485 - 6486 -Пример запроса: 6487 -Id ~/~/ Идентификатор поля 6488 - 6489 - 6490 -= **Раздел: Управление доступа к машинам** = 6491 - 6492 - 6493 -== Получение списка транспортных средств видимых пользователю == 6494 - 6495 -(% class="box infomessage" %) 6496 -((( 6497 -**GET /api/v3/UserVisibleVehicles/{userId}** 6498 -))) 6499 - 6500 -Пример ответа: 6501 - 6502 -((( 6503 -{ 6504 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6505 - 0 6506 - ] 6507 -} 6508 -))) 6509 - 6510 - 6511 -== Задает видимость транспортных средств пользователю == 6512 - 6513 -(% class="box infomessage" %) 6514 -((( 6515 -**POST /api/v3/UserVisibleVehicles** 6516 -))) 6517 - 6518 -Пример запроса: 6519 - 6520 -((( 6521 -((( 6522 -{ 6523 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6524 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6525 - 0 6526 - ] 6527 -} 6528 -))) 6529 - 6530 -((( 6531 - 6532 -))) 6533 - 6534 -((( 6535 -Пример ответа : 6536 -))) 6537 - 6538 -((( 6539 - 6540 -))) 6541 - 6542 -((( 6543 -200 ~/~/ Success 6544 -))) 6545 -))) 6546 - 6547 - 6548 6548 (% class="box" lang="en-US" style="text-align: center;" %) 6549 6549 ((( 6550 6550 (% 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]] **