Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/04/24 15:46
<
>
edited by Андрей Калиновский
on 2025/03/25 13:59
on 2025/03/25 13:59
edited by Андрей Калиновский
on 2024/07/19 15:49
on 2024/07/19 15:49
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -1,22 +1,5 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -(% class="box warningmessage" %) 4 -((( 5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 -просим вас соблюдать несколько простых правил при использовании API-команд:## 7 -))) 8 - 9 -* Формировать не более 3 отчётов одновременно. 10 -* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 - 12 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 - 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 -))) 19 - 20 20 **Содержание страницы:** 21 21 ))) 22 22 ... ... @@ -31,20 +31,11 @@ 31 31 32 32 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 33 33 34 -(% style="color:#000000" %)− (%%)При **редактировании** любойзаписи (пользователь, объект и т.д)необходимо передавать все параметры записив теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 35 35 36 - 37 -(% style="color:#000000; font-size:16px" %)**Рекомендации** 38 - 39 -- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 40 - 41 41 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 42 42 43 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 44 -((( 45 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 46 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 47 -))) 21 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 48 48 49 49 (% class="box successmessage" %) 50 50 ((( ... ... @@ -70,8 +70,12 @@ 70 70 71 71 (% lang="en-US" %) 72 72 (% style="color:#000000" %){ 73 - "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации 74 - "User": "testuser" , ~/~/ имя пользователя(%%) 47 + 48 +(% lang="en-US" %) 49 +(% style="color:#000000" %) "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации 50 + "User": "testuser" , ~/~/ имя пользователя 51 + 52 +(% lang="en-US" %) 75 75 } 76 76 77 77 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. ... ... @@ -251,6 +251,7 @@ 251 251 "bankKS": "string" ~/~/ корр. счёт 252 252 } 253 253 232 + 254 254 Ответ: 255 255 256 256 { ... ... @@ -444,6 +444,7 @@ 444 444 ], 445 445 "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 446 446 } 426 + 447 447 { 448 448 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 449 449 "lastName": "string", ... ... @@ -457,8 +457,12 @@ 457 457 458 458 (% style="text-align:left" %) 459 459 (% style="color:#000000; font-weight:normal" %)Ответ: 460 -{ 461 - "id": "" , ~/~/ ID пользователя 440 + 441 +(% style="text-align:left" %) 442 +(% style="color:#000000; font-weight:normal" %){ 443 + 444 +(% style="text-align:left" %) 445 +(% style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 462 462 "lastName": "" , ~/~/ Фамилия , 463 463 "firstName": "" , ~/~/ Имя 464 464 "position": "" , ~/~/ Должность ... ... @@ -475,9 +475,11 @@ 475 475 "kind": "" , ~/~/ тип аутентификации 476 476 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 477 477 "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя 478 -} 479 479 463 +(% style="text-align:left" %) 464 +(% style="color:#000000; font-weight:normal" %)} 480 480 466 + 481 481 == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) == 482 482 483 483 (% class="box infomessage" %) ... ... @@ -497,16 +497,19 @@ 497 497 498 498 (% style="color:#000000" %)Параметры в теле запроса (JSON): 499 499 500 -(% style="color:#000000" %){(%%) 486 +(% style="color:#000000" %){ 487 + 501 501 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента 502 502 "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно 503 503 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 504 504 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 492 + 505 505 (% style="color:#000000" %)} 506 506 507 507 (% style="color:#000000" %)Ответ: 508 508 509 509 (% style="color:#000000" %){ (%%) 498 + 510 510 "id": "" , ~/~/ идентификатор пользователя 511 511 "lastName": "" , ~/~/ фамилия 512 512 "firstName": "" , ~/~/ имя ... ... @@ -520,6 +520,7 @@ 520 520 "sessionDuration":"", ~/~/ длительность сессии в минутах 521 521 "status": "1", ~/~/ статус пользователя 522 522 "lastLogged": "", ~/~/ дата/время последней авторизации 512 + 523 523 (% style="color:#000000" %)} 524 524 525 525 == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) == ... ... @@ -593,8 +593,10 @@ 593 593 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 594 594 595 595 (% lang="en-US" style="text-align:left" %) 596 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 597 - "id": "" , ~/~/ ID пользователя 586 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 587 + 588 +(% lang="en-US" style="text-align:left" %) 589 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 598 598 "lastName": "" , ~/~/ фамилия 599 599 "firstName": "" , ~/~/ имя 600 600 "position": "" , ~/~/ должность ... ... @@ -616,7 +616,9 @@ 616 616 "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации 617 617 }, 618 618 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 619 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя(%%) 611 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 612 + 613 +(% lang="en-US" style="text-align:left" %) 620 620 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 621 621 622 622 (% lang="en-US" style="text-align:left" %) ... ... @@ -623,8 +623,10 @@ 623 623 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 624 624 625 625 (% lang="en-US" style="text-align:left" %) 626 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 627 - "id": "" , ~/~/ идентификатор пользователя 620 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 621 + 622 +(% lang="en-US" style="text-align:left" %) 623 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя 628 628 "lastName": "" , ~/~/ фамилия 629 629 "firstName": "" , ~/~/ имя 630 630 "position": "" , ~/~/ должность ... ... @@ -645,8 +645,10 @@ 645 645 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 646 646 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 647 647 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 648 -} 649 649 645 +(% lang="en-US" style="text-align:left" %) 646 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 647 + 650 650 == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) == 651 651 652 652 (% class="box warningmessage" %) ... ... @@ -666,10 +666,12 @@ 666 666 667 667 (% style="color:#000000" %)Параметры в теле запроса (JSON): 668 668 669 -(% style="color:#000000" %){(%%) 667 +(% style="color:#000000" %){ 668 + 670 670 "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 671 671 "description": "" , ~/~/ описание 672 672 "data": "" , ~/~/ данные, связанные со сменой статуса 672 + 673 673 (% style="color:#000000" %)} 674 674 675 675 (% style="text-align:left" %) ... ... @@ -691,7 +691,7 @@ 691 691 (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 692 692 693 693 [ 694 - "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 694 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 695 695 "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 696 696 ] 697 697 ... ... @@ -997,7 +997,7 @@ 997 997 998 998 Ответ: В случае успеха **Success 200** 999 999 1000 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =1000 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 1001 1001 1002 1002 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 1003 1003 ... ... @@ -1026,17 +1026,6 @@ 1026 1026 1027 1027 ((( 1028 1028 { 1029 - 1030 -((( 1031 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1032 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1033 -))) 1034 - 1035 -((( 1036 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1037 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1038 -))) 1039 - 1040 1040 "vehicleId": "", ~/~/ ID объекта 1041 1041 "name": "", ~/~/ Имя объекта 1042 1042 "imei": "", ~/~/ IMEI объекта ... ... @@ -1044,15 +1044,19 @@ 1044 1044 "deviceTypeName": "", ~/~/ Название типа устройства 1045 1045 "sim1": "", ~/~/ Номер SIM1 1046 1046 "sim2": "", ~/~/ Номер SIM2 1036 + 1047 1047 "parentId": "", ~/~/ ID клиента-родителя 1048 1048 "parentName": "", ~/~/ Наименование клиента-родителя 1049 1049 "modelId": "", ~/~/ ID модели объекта 1050 1050 "modelName": "", ~/~/ Имя модели объекта 1041 + 1051 1051 "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1052 1052 "unitName": "string", ~/~/ Наименование подразделения 1053 1053 "status": 0, ~/~/ Статус объекта 1045 + 1054 1054 "createdAt": "", ~/~/ Дата создания объекта 1055 1055 }, 1048 + 1056 1056 "customFields": [ ~/~/ Произвольные поля 1057 1057 { 1058 1058 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля ... ... @@ -1075,7 +1075,8 @@ 1075 1075 "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1076 1076 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1077 1077 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1078 - "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1071 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1072 + 1079 1079 "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания 1080 1080 "mileageCoeff": 0, ~/~/ коэффициент пробега 1081 1081 "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна ... ... @@ -1105,6 +1105,7 @@ 1105 1105 "retries": 0 ~/~/ Количество попыток 1106 1106 } 1107 1107 ], 1102 + 1108 1108 "sensors": [ ~/~/ Датчики 1109 1109 { 1110 1110 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика ... ... @@ -1131,7 +1131,6 @@ 1131 1131 ], 1132 1132 "showInTooltip": true, ~/~/ Отображать в подсказке 1133 1133 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1134 - "color": "string", ~/~/ Код цвета датчиков 1135 1135 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1136 1136 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1137 1137 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1146,19 +1146,31 @@ 1146 1146 }, 1147 1147 1148 1148 ~/~/ Характерные для произвольного: 1143 + 1149 1149 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1145 + 1150 1150 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1147 + 1151 1151 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1149 + 1152 1152 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1151 + 1153 1153 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1153 + 1154 1154 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1155 + 1155 1155 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1157 + 1156 1156 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1159 + 1157 1157 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1161 + 1158 1158 ~/~/ "ValueOn": "Вкл.", 1163 + 1159 1159 ~/~/ "ValueOff": "Выкл." 1160 1160 "summaryMaxValue": 0 ~/~/ Макс. значение 1161 1161 } 1167 + 1162 1162 "drivers": [ ~/~/ Водители 1163 1163 { 1164 1164 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1167,6 +1167,7 @@ 1167 1167 "isDefault": true ~/~/ По умолчанию 1168 1168 } 1169 1169 ], 1176 + 1170 1170 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1171 1171 { 1172 1172 "id": "", ~/~/ ID задания ... ... @@ -1183,27 +1183,19 @@ 1183 1183 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1184 1184 } 1185 1185 ], 1186 -"statusHistory": [ ~/~/ История статусов 1193 + 1194 + "statusHistory": [ ~/~/ История статусов 1187 1187 { 1188 1188 "status": 0, 1189 1189 "date": "2023-05-22T09:57:39.562Z", 1190 1190 "description": "string", 1191 1191 "additionalInfo": "string" 1200 + } 1201 + ] 1192 1192 1193 -((( 1194 1194 } 1195 - ], 1196 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1197 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1198 1198 ))) 1199 1199 1200 -((( 1201 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1202 -} 1203 - 1204 -))) 1205 -))) 1206 - 1207 1207 (% style="text-align:left" %) 1208 1208 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1209 1209 ... ... @@ -1211,25 +1211,6 @@ 1211 1211 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1212 1212 1213 1213 1214 -== **Отправить команду на терминал** == 1215 - 1216 -(% class="box successmessage" %) 1217 -((( 1218 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1219 -))) 1220 - 1221 -Команда для отправки на тс. 1222 - 1223 -{ 1224 -"id": "", ~/~/идентификатор объекта (он же идентификатор ТС: vehicleId) 1225 -"command": "", ~/~/ Текст отправляемой команды 1226 -"retries": "", ~/~/ Количество попыток отправки на терминал 1227 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов). 1228 -} 1229 - 1230 -В ответ получаем cmdid 1231 - 1232 - 1233 1233 == **Получить ответ на отправленную на ТС команду** == 1234 1234 1235 1235 (% class="box infomessage" %) ... ... @@ -1237,13 +1237,13 @@ 1237 1237 (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1238 1238 ))) 1239 1239 1240 -Идентификатор команды: cmd Id1220 +Идентификатор команды: cmdid 1241 1241 1242 1242 Запрос от терминала на ответ команды 1243 1243 1244 1244 Пример ответ от терминала: 1245 1245 1246 -ID= "" ~/~/ идентификатор о бъекта1226 +ID= "" ~/~/ идентификатор произвольного поля 1247 1247 Soft="" ~/~/ версия софта 1248 1248 GPS=4 ~/~/ тип трекера 1249 1249 Time=11:05:43 28.06.24 ~/~/ время запроса ... ... @@ -1277,6 +1277,8 @@ 1277 1277 "status": "" ~/~/ Статус отправки 1278 1278 } 1279 1279 ] 1260 + 1261 + 1280 1280 ))) 1281 1281 1282 1282 == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) == ... ... @@ -1298,11 +1298,6 @@ 1298 1298 1299 1299 (% style="color:#000000" %){ 1300 1300 1301 - 1302 -((( 1303 - "vehicleId": 0, ~/~/ ID ТС 1304 -))) 1305 - 1306 1306 "parentId": "" , ~/~/ ID клиента 1307 1307 "name": "" , ~/~/ имя ТС 1308 1308 "imei": "" , ~/~/ IMEI ... ... @@ -1323,6 +1323,7 @@ 1323 1323 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1324 1324 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1325 1325 "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1303 + 1326 1326 "mileageCalcMethod": 0, 1327 1327 "mileageCoeff": 0, 1328 1328 "locationByCellId": true, ... ... @@ -1355,6 +1355,7 @@ 1355 1355 "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано) 1356 1356 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1357 1357 } 1336 + 1358 1358 "drivers": [ ~/~/ Водители 1359 1359 { 1360 1360 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1369,7 +1369,8 @@ 1369 1369 "retries": 0 1370 1370 } 1371 1371 ], 1372 -"sensors": [ ~/~/ Датчики 1351 + 1352 + "sensors": [ ~/~/ Датчики 1373 1373 { 1374 1374 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1375 1375 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1395,7 +1395,6 @@ 1395 1395 ], 1396 1396 "showInTooltip": true, ~/~/ Отображать в подсказке 1397 1397 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1398 - "color": "string", ~/~/ код цвета датчиков 1399 1399 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1400 1400 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1401 1401 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1408,289 +1408,99 @@ 1408 1408 "additionalProp2": "string", 1409 1409 "additionalProp3": "string" 1410 1410 }, 1390 + 1411 1411 ~/~/ Характерные для произвольного: 1392 + 1412 1412 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1394 + 1413 1413 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1396 + 1414 1414 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1398 + 1415 1415 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1400 + 1416 1416 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1402 + 1417 1417 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1404 + 1418 1418 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1406 + 1419 1419 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1408 + 1420 1420 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1410 + 1421 1421 ~/~/ "ValueOn": "Вкл.", 1422 -~/~/ "ValueOff": "Выкл." 1423 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1424 1424 1425 -((( 1426 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1427 - { 1428 - "from": 0, ~/~/ С какого значения 1429 - "color": "string", ~/~/ Каким цветом 1430 - "text": "string" ~/~/ Текст подписи к этому интервалу 1431 - } 1432 - ] 1413 +~/~/ "ValueOff": "Выкл." 1414 + "summaryMaxValue": 0 ~/~/ Макс. значение 1433 1433 } 1434 1434 ], 1435 -))) 1436 - 1437 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1438 - 1439 - 1440 1440 "customFields": [ ~/~/ Произвольные поля 1441 1441 { 1442 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1443 - "name": "string", ~/~/ Наименование произвольного поля 1444 - "value": "string", ~/~/ Значение произвольного поля 1445 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1446 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1447 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1448 - 1449 -((( 1450 - } 1451 - ], 1452 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1453 -))) 1454 - 1455 -((( 1456 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1419 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1420 + "name": "string", 1421 + "value": "string", 1422 + "forClient": true, 1423 + "forTooltip": true, 1424 + "forReport": true 1425 + } 1426 + ] 1457 1457 } 1458 -))) 1459 1459 1460 - 1461 1461 (% style="color:#000000" %)Ответ: 1462 1462 1431 +(% style="color:#000000" %){ 1463 1463 1464 -((( 1465 -((( 1466 -((( 1467 -{ 1468 - "vehicleId": 0, ~/~/ ID ТС 1469 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1470 - "name": "string", ~/~/ Имя объекта 1471 - "imei": "string", ~/~/ IMEI 1472 - "deviceTypeId": 0, ~/~/ ID типа устройства 1473 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1474 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1475 - "sim1": "string", ~/~/ SIM1 1476 - "sim2": "string", ~/~/ SIM2 1477 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1478 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1479 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1480 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1481 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1482 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1483 - "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1484 - "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1485 - "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1486 - "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1487 - "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1488 - "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1489 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1490 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1491 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1492 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1493 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1494 - "counters": { ~/~/ Dto для состояний счётчиков 1495 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1496 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1497 - "mileage": 0, ~/~/ Пробег 1498 - "motohours": 0 ~/~/ Моточасы 1499 - }, 1500 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1501 - "id": "string", ~/~/ CMSV6 Идентификатор 1502 - "enabled": true, ~/~/ Признак включения 1503 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1504 - "login": "string", ~/~/ CMSV6 имя учетной записи 1505 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1506 - }, 1507 - "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1508 - { 1509 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1510 - "enabled": true, ~/~/ Признак включения 1511 - "name": "string", ~/~/ Имя задания 1512 - "description": "string", ~/~/ Описание задания 1513 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1514 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1515 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1516 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1517 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1518 - "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1519 - "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1520 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 1433 + "vehicleId": "", ~/~/ID ТС 1434 + "parentId": "", ~/~/Guid владельца ТС 1435 + "name": "", ~/~/Имя объекта 1436 + "imei": "", ~/~/IMEI 1437 + "deviceTypeId": "", ~/~/ID типа устройства 1438 + "modelId": "", ~/~/ID модели 1439 + "unitId": "", ~/~/ID подразделения 1440 + "sim1": "", ~/~/SIM1 1441 + "sim2": "", ~/~/SIM2 1442 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1443 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1444 + "counters": { ~/~/Счётчики 1445 + "mileageEnabled": true, 1446 + "motohoursEnabled": true, 1447 + "mileage": "", 1448 + "motohours": 345.0 1449 + }, 1450 + "cmsv6Parameters": { ~/~/Параметры CmsV6 1451 + "id": null, 1452 + "enabled": true, ~/~/флаг включения 1453 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1454 + "login": "", ~/~/ имя учетной записи 1455 + "password": "" ~/~/ пароль учетной записи 1456 + }, 1457 + "inspectionTasks": { ~/~/ задания на ТО 1458 + "id": "", ~/~/ ID задачи 1459 + "enabled": false, ~/~/ Признак включения 1460 + "name": "", ~/~/ Имя задания 1461 + "description": "", ~/~/ Описание задания 1462 + "mileageCondition": "", ~/~/ Условие по пробегу 1463 + "lastMileage": "", ~/~/ Пробег (в метрах) 1464 + "motohoursCondition": "", ~/~/ Условие по моточасам 1465 + "lastMotohours": "", ~/~/ Моточасы 1466 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1467 + "kind": "", ~/~/ Вид периодичности по времени 1468 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1521 1521 } 1522 - ], 1523 - "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1524 - { 1525 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1526 - "inputNumber": 0, ~/~/ № входа. 1527 - "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1528 - "comment": "string", ~/~/ Комментарий 1529 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1530 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1531 - "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1532 - "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1533 - } 1534 - ], 1535 - "commandTemplates": [ ~/~/ Список шаблонов команд 1536 - { 1537 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1538 - "name": "string", ~/~/ Название шаблона команд 1539 - "command": "string", ~/~/ Команда на выполнение 1540 - "retries": 0 ~/~/ Лимит попыток отправки 1541 - } 1542 - ], 1543 - "sensors": [ ~/~/ Список датчиков 1544 - { 1545 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1546 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1547 - "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 1548 - "name": "string", ~/~/ Имя датчика 1549 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1550 - "inputNumber": 0, ~/~/ Номер входа 1551 - "pseudonym": "string", ~/~/ Псевдоним 1552 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1553 - "isInverted": true, ~/~/ Признак инверсии 1554 - "disabled": true, ~/~/ Датчик не участвует в обработке 1555 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1556 - "gradesTables": [ ~/~/ Тарировка 1557 - { 1558 - "grades": [ ~/~/ Таблицы тарировки 1559 - { 1560 - "input": 0, ~/~/ Вход 1561 - "output": 0 ~/~/ Выход 1562 - } 1563 - ], 1564 - "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1565 - } 1566 - ], 1567 - "showInTooltip": true, ~/~/ Отображение в подсказке 1568 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 1569 - "color": "string", ~/~/ код цвета датчиков 1570 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1571 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1572 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1573 - "expr": "string", ~/~/ Выражение 1574 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1575 - "string" 1576 - ], 1577 - "customParams": { 1578 - "additionalProp1": "string", 1579 - "additionalProp2": "string", 1580 - "additionalProp3": "string" 1581 - }, 1582 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1583 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1584 - { 1585 - "from": 0, ~/~/ С какого значения 1586 - "color": "string", ~/~/ Каким цветом 1587 -))) 1588 1588 1589 -((( 1590 - "text": "string" ~/~/ Текст подписи к этому интервалу 1591 - } 1592 - ] 1593 - } 1594 - ], 1595 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1596 - "customFields": [ ~/~/ Список произвольных полей 1597 - { 1598 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1599 - "name": "string", ~/~/ Наименование произвольного поля 1600 - "value": "string", ~/~/ Значение произвольного поля 1601 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1602 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1603 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1604 - } 1605 - ], 1606 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1607 -} 1608 -))) 1609 -))) 1610 -))) 1471 +(% style="text-align:left" %) 1472 +(% style="color:#000000" %)} 1611 1611 1612 - 1613 1613 **Валидация:** 1614 1614 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1615 1615 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1616 1616 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1617 1617 1479 +== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) == 1618 1618 1619 -== **Импортировать историю ТС (Асинхронный запрос)** == 1620 - 1621 -(% class="box successmessage" %) 1622 -((( 1623 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1624 -))) 1625 - 1626 -Метод запроса: **POST** 1627 - 1628 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1629 - 1630 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1631 - 1632 - 1633 -Ответ: 1634 - 1635 -{ 1636 - 1637 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1638 - 1639 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1640 - 1641 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1642 - 1643 - "Message": "string", ~/~/ Информация о выполнении запроса 1644 - 1645 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1646 - 1647 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1648 - 1649 - "Data": "string" ~/~/ Данные 1650 - 1651 -} 1652 - 1653 - 1654 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 1655 - 1656 1656 (% class="box infomessage" %) 1657 1657 ((( 1658 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1659 -))) 1660 - 1661 -Метод запроса: **GET** 1662 - 1663 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1664 - 1665 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1666 - 1667 - 1668 -Ответ: 1669 - 1670 -{ 1671 - 1672 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1673 - 1674 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 1675 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1676 - 1677 - "Message": "string", ~/~/ Информация о выполнении запроса 1678 - 1679 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1680 - 1681 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1682 - 1683 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1684 - 1685 - "Data": "string" ~/~/ Данные 1686 - 1687 -} 1688 - 1689 - 1690 -== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1691 - 1692 -(% class="box infomessage" %) 1693 -((( 1694 1694 (% lang="en-US" %)**POST /api/v3/vehicles/find** 1695 1695 ))) 1696 1696 ... ... @@ -1728,12 +1728,9 @@ 1728 1728 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1729 1729 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1730 1730 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1731 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1732 - "unitName": "string", ~/~/ Название подразделения (опционально) 1733 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1734 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1735 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1736 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1520 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1521 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1522 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1737 1737 } 1738 1738 1739 1739 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1740,14 +1740,8 @@ 1740 1740 1741 1741 (% style="color:#000000" %)Ответ: 1742 1742 1743 -(% style="color:#000000" %)[ 1744 -{ 1529 +(% style="color:#000000" %){ 1745 1745 1746 -((( 1747 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1748 -))) 1749 - 1750 -((( 1751 1751 (% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1752 1752 "name": "" ~/~/ наименование объекта 1753 1753 "imei": "" ~/~/ IMEI объекта ... ... @@ -1773,21 +1773,9 @@ 1773 1773 "forClient": true, ~/~/ право на отображение у клиента 1774 1774 "forTooltip": false, ~/~/ право на отображение в подсказке 1775 1775 "forReport": false ~/~/ право на отображение в отчетах 1776 -))) 1556 + }(%%) 1557 +(% style="color:#000000" %)} 1777 1777 1778 -((( 1779 - } 1780 - ], 1781 - "vehicleGroups": [ ~/~/ Группы ТС 1782 - { 1783 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1784 - "name": "string" ~/~/ Наименование группы ТС 1785 - } 1786 - ] 1787 - } 1788 -] 1789 -))) 1790 - 1791 1791 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1792 1792 1793 1793 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1819,11 +1819,13 @@ 1819 1819 "data": "", ~/~/ Данные 1820 1820 "overwrite": false, ~/~/ Флаг перезаписи 1821 1821 "stage": "", ~/~/ Состояние, может быть null 1590 + 1822 1822 (% style="color:#000000" %)} 1823 1823 1824 1824 (% style="color:#000000" %)Ответ: 1825 1825 1826 -(% style="color:#000000" %){(%%) 1595 +(% style="color:#000000" %){ 1596 + 1827 1827 "status": "", ~/~/ значение статуса 1828 1828 "date": "", ~/~/ Дата смены статуса 1829 1829 "description": "", ~/~/ Описание ... ... @@ -1830,10 +1830,28 @@ 1830 1830 "data": "", ~/~/ Данные 1831 1831 "overwrite": false, ~/~/ Флаг перезаписи 1832 1832 "stage": "", ~/~/ Состояние 1603 + 1604 +(% style="text-align:left" %) 1833 1833 (% style="color:#000000" %) } 1834 1834 1835 -== == 1607 +(% class="wikigeneratedid" id="H41843743C43543D43543D43843544144243044244344143043E43144A43543A442430" %) 1608 +**Отправить команду на терминал** 1836 1836 1610 +(% class="box successmessage" %) 1611 +((( 1612 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1613 +))) 1614 + 1615 +Команда для отправки на тс. 1616 + 1617 +{ 1618 +"id": "", ~/~/идентификатор произвольного поля 1619 +"command": "", ~/~/ Текст команды 1620 +"retries": "", ~/~/ Количество попыток 1621 +"idTemplate": "" ~/~/ ID шаблона команды 1622 +} 1623 + 1624 + 1837 1837 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1838 1838 1839 1839 (% class="box warningmessage" %) ... ... @@ -1909,19 +1909,9 @@ 1909 1909 1910 1910 "drivers": [ ~/~/ Водители 1911 1911 { 1912 - 1913 -((( 1914 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1915 - "inputNumber": 0, ~/~/ № входа. 1916 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1917 - "comment": "string", ~/~/ Комментарий. 1918 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1919 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1920 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1921 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1922 -))) 1923 - 1924 - } 1700 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1701 + "isDefault": true 1702 + } 1925 1925 ], 1926 1926 "commandTemplates": [ ~/~/ Шаблон команды 1927 1927 { ... ... @@ -1931,7 +1931,8 @@ 1931 1931 "retries": 0 1932 1932 } 1933 1933 ], 1934 -"sensors": [ ~/~/ Датчики 1712 + 1713 + "sensors": [ ~/~/ Датчики 1935 1935 { 1936 1936 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1937 1937 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1957,11 +1957,6 @@ 1957 1957 ], 1958 1958 "showInTooltip": true, ~/~/ Отображать в подсказке 1959 1959 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1960 - 1961 -((( 1962 - "color": "string",** ~/~/ **Цвет датчика 1963 -))) 1964 - 1965 1965 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1966 1966 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1967 1967 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1974,225 +1974,95 @@ 1974 1974 "additionalProp2": "string", 1975 1975 "additionalProp3": "string" 1976 1976 }, 1751 + 1977 1977 ~/~/ Характерные для произвольного: 1753 + 1978 1978 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1755 + 1979 1979 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1757 + 1980 1980 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1759 + 1981 1981 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1761 + 1982 1982 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1763 + 1983 1983 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1765 + 1984 1984 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1767 + 1985 1985 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1769 + 1986 1986 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1771 + 1987 1987 ~/~/ "ValueOn": "Вкл.", 1773 + 1988 1988 ~/~/ "ValueOff": "Выкл." 1989 1989 "summaryMaxValue": 0 ~/~/ Макс. значение 1990 - 1991 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1992 - { 1993 - "from": 0, ~/~/ С какого значения 1994 - "color": "string", ~/~/ Каким цветом 1995 - "text": "string" ~/~/ Текст подписи к этому интервалу 1996 - } 1997 - ] 1998 1998 } 1999 1999 ], 2000 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2001 - 2002 2002 "customFields": [ ~/~/ Произвольные поля 2003 - { 2004 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности2005 - "name": "string", ~/~/ Наименование произвольного поля2006 - "value": "string", ~/~/ Значение произвольного поля2007 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента2008 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)2009 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1779 + { 1780 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1781 + "name": "string", 1782 + "value": "string", 1783 + "forClient": true, 1784 + "forTooltip": true, 1785 + "forReport": true 2010 2010 } 2011 - 2012 -((( 2013 - ], 2014 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 2015 -))) 2016 - 1787 + ] 2017 2017 } 2018 2018 2019 - 2020 2020 (% style="color:#000000" %)Ответ: 2021 2021 2022 -((( 2023 -{ 2024 - "vehicleId": 0, ~/~/ ID ТС 2025 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 2026 - "name": "string", ~/~/ Имя объекта 2027 - "imei": "string", ~/~/ IMEI 2028 - "deviceTypeId": 0, ~/~/ ID типа устройства 2029 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 2030 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 2031 - "sim1": "string", ~/~/ SIM1 2032 - "sim2": "string", ~/~/ SIM2 2033 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 2034 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 2035 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 2036 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 2037 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 2038 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 2039 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 2040 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 2041 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 2042 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 2043 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 2044 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 2045 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 2046 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 2047 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 2048 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 2049 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 2050 - "counters": { ~/~/ состояний счётчиков 2051 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 2052 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 2053 - "mileage": 0, ~/~/ Пробег 2054 - "motohours": 0 ~/~/ Моточасы 2055 - }, 2056 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 2057 - "id": "string", ~/~/ CMSV6 Идентификатор 2058 - "enabled": true, ~/~/ Признак включения 2059 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 2060 -))) 1792 +(% lang="en-US" style="text-align:left" %) 1793 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 2061 2061 2062 - 2063 -((( 2064 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 2065 - "login": "string", ~/~/ CMSV6 имя учетной записи 2066 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 2067 - }, 2068 - "inspectionTasks": [ ~/~/ Задания на ТО 2069 - { 2070 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 2071 - "enabled": true, ~/~/ Признак включения 2072 - "name": "string", ~/~/ Имя задания 2073 - "description": "string", ~/~/ Описание задания 2074 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 2075 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 2076 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 2077 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 2078 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 2079 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 2080 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 2081 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 2082 - } 2083 - ], 2084 - "drivers": [ ~/~/ Список водителей 2085 - { 2086 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 2087 - "inputNumber": 0, ~/~/ № входа. 2088 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 2089 - "comment": "string", ~/~/ Комментарий. 2090 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 2091 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 2092 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 2093 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 2094 - } 2095 - ], 2096 - "commandTemplates": [ ~/~/ Список шаблонов команд 2097 - { 2098 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 2099 - "name": "string", ~/~/ Название шаблона команд 2100 - "command": "string", ~/~/ Команда на выполнение 2101 - "retries": 0 ~/~/ Лимит попыток отправки 2102 - } 2103 - ], 2104 - "sensors": [ ~/~/ Список датчиков 2105 - { 2106 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 2107 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 2108 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 2109 -))) 2110 - 2111 -((( 2112 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 2113 -))) 2114 - 2115 -((( 2116 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 2117 -))) 2118 - 2119 -((( 2120 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 2121 -))) 2122 - 2123 -((( 2124 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 2125 -))) 2126 - 2127 -((( 2128 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 2129 - "name": "string", ~/~/ Имя датчика 2130 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 2131 -))) 2132 - 2133 -((( 2134 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 2135 - "inputNumber": 0, ~/~/ Номер входа 2136 - "pseudonym": "string", ~/~/ Псевдоним 2137 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 2138 - "isInverted": true, ~/~/ Признак инверсии 2139 - "disabled": true, ~/~/ Датчик не участвует в обработке 2140 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 2141 - "gradesTables": [ ~/~/ Тарировка 1795 +(% lang="en-US" style="text-align:left" %) 1796 + "vehicleId": "", ~/~/ ID ТС 1797 + "parentId": "", ~/~/ ID клиента 1798 + "name": "", ~/~/ имя ТС 1799 + "imei": "", ~/~/ IMEI 1800 + "deviceTypeId": "", ~/~/ типа устройства 1801 + "modelId": "", ~/~/ ID модели 1802 + "unitId": "", ~/~/ ID подразделения 1803 + "sim1": "", ~/~/ SIM 1 1804 + "sim2": "", ~/~/ SIM2 1805 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1806 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1807 + "counters": 1808 + { 1809 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1810 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1811 + "mileage": "", ~/~/ пробег 1812 + "motohours": "", ~/~/ моточасы 1813 + } 1814 + "cmsv6Parameters": ~/~/ параметры CMSv6 2142 2142 { 2143 - "grades": [ ~/~/ Таблицы тарировки 2144 - { 2145 - "input": 0, ~/~/ Вход 2146 - "output": 0 ~/~/ Выход 2147 - } 2148 - ], 2149 - "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2150 - } 2151 - ], 2152 - "showInTooltip": true, ~/~/ Отображение в подсказке 2153 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 2154 - 2155 -((( 2156 - "color": "string", ~/~/ цвет уведомлений 2157 -))) 2158 - 2159 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2160 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2161 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2162 - "expr": "string", ~/~/ Выражение 2163 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2164 - "string" 2165 - ], 2166 - "customParams": { ~/~/ Дополнительные настройки 2167 - "additionalProp1": "string", 2168 - "additionalProp2": "string", 2169 - "additionalProp3": "string" 2170 - }, 2171 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2172 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1816 + "id": ~/~/ идентификатор 1817 + "enabled": true, ~/~/ флаг включения 1818 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1819 + "login": "", ~/~/ имя учетной записи 1820 + "password": "", ~/~/ пароль учетной записи 1821 + } 1822 + "inspectionTasks": ~/~/ задания на ТО 2173 2173 { 2174 - "from": 0, ~/~/ С какого значения 2175 - "color": "string", ~/~/ Каким цветом 2176 - "text": "string" ~/~/ Текст подписи к этому интервалу 1824 + "id": "", ~/~/ ID задания 1825 + "enabled": false, ~/~/ Признак включения 1826 + "name": "", ~/~/ Имя задания 1827 + "description": "", ~/~/ Описание задания 1828 + "mileageCondition": "", ~/~/ Условие по пробегу 1829 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1830 + "motohoursCondition": "", ~/~/ Условие по моточасам 1831 + "lastMotohours": "", ~/~/ Моточасы 1832 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1833 + "kind": "", ~/~/ Вид периодичности по времени 1834 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 2177 2177 } 2178 - ] 2179 - } 2180 - ], 2181 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2182 - "customFields": [ ~/~/ Список произвольных полей 2183 - { 2184 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2185 - "name": "string", ~/~/ Наименование произвольного поля 2186 - "value": "string", ~/~/ Значение произвольного поля 2187 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2188 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2189 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 2190 - } 2191 - ], 2192 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2193 -} 2194 -))) 2195 2195 1837 +(% lang="en-US" style="text-align:left" %) 1838 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1839 + 2196 2196 **Валидация:** 2197 2197 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 2198 2198 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; ... ... @@ -2237,9 +2237,12 @@ 2237 2237 2238 2238 (% style="color:#000000" %)Ответ: 2239 2239 2240 -(% style="color:#000000" %){(%%) 1884 +(% style="color:#000000" %){ 1885 + 2241 2241 "deviceTypeId" : "", ~/~/ ID типа устройства 2242 2242 "deviceTypeName" : "" ~/~/ Название типа устройства 1888 + 1889 +(% style="text-align:left" %) 2243 2243 (% style="color:#000000" %)} 2244 2244 2245 2245 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = ... ... @@ -2261,10 +2261,13 @@ 2261 2261 2262 2262 (% style="color:#000000" %)Ответ: 2263 2263 2264 -(% style="color:#000000" %){(%%) 1911 +(% style="color:#000000" %){ 1912 + 2265 2265 "id": "", ~/~/ ID типа датчика 2266 2266 "name": "", ~/~/ Название 2267 2267 "description": "", ~/~/ Описание 1916 + 1917 +(% style="text-align:left" %) 2268 2268 (% style="color:#000000" %)} 2269 2269 2270 2270 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = ... ... @@ -2466,14 +2466,10 @@ 2466 2466 { 2467 2467 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2468 2468 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2469 - "mileage": 0, ~/~/ Пробег за период, километры 2470 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2471 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2472 - "motohours": 0, ~/~/ Моточасы за период, секунды 2473 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2474 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2475 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2476 - 2119 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2120 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2121 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2122 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2477 2477 } 2478 2478 ] 2479 2479 } ... ... @@ -2517,19 +2517,11 @@ 2517 2517 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2518 2518 "fuelConsumption": 0, ~/~/ Расход топлива 2519 2519 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2520 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2521 - 2522 2522 } 2523 2523 ] 2524 2524 } 2525 2525 ] 2526 2526 2527 -(% class="box warningmessage" %) 2528 -((( 2529 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2530 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2531 -))) 2532 - 2533 2533 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2534 2534 2535 2535 (% class="box infomessage" %) ... ... @@ -2564,8 +2564,7 @@ 2564 2564 "model": "string", ~/~/ Модель объекта 2565 2565 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2566 2566 { 2567 - "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 2568 - 2205 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2569 2569 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2570 2570 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2571 2571 "valueFuel": 0, ~/~/ Количество ... ... @@ -2618,7 +2618,7 @@ 2618 2618 ], 2619 2619 "stops": [ ~/~/ События стоянок 2620 2620 { 2621 - "address": " [Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес событияУлица, Дом, Город, Регион, Страна, Координаты2258 + "address": "string", ~/~/ Адрес события 2622 2622 "eventId": 0, ~/~/ Идентификатор события 2623 2623 "eventName": "string", ~/~/ Название события 2624 2624 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -2666,6 +2666,7 @@ 2666 2666 } 2667 2667 2668 2668 2306 + 2669 2669 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2670 2670 2671 2671 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -2973,32 +2973,6 @@ 2973 2973 2974 2974 Success 2975 2975 2976 - 2977 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2978 - 2979 -(% class="box warningmessage" %) 2980 -((( 2981 -**PUT** /api/v3/notifications/prolongation 2982 -))) 2983 - 2984 -Метод позволяет продлить уведомления. 2985 - 2986 -Метод запроса **PUT** 2987 - 2988 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2989 - 2990 -В заголовках запроса: X-Auth: Токен авторизации. 2991 - 2992 -Тело запроса: 2993 - 2994 -[ 2995 - 2996 -0 2997 - 2998 -] 2999 - 3000 -где 0 идентификатор ids. 3001 - 3002 3002 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 3003 3003 3004 3004 (% class="box errormessage" %) ... ... @@ -4189,7 +4189,7 @@ 4189 4189 **POST /api/v3/vehicles/import/{agentId}** 4190 4190 ))) 4191 4191 4192 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение*.xls)**или **wlp. **Также они могут находится в** zip-архиве(один файл - один архив).**3804 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 4193 4193 4194 4194 В пути указывается **agentId** - id клиента. 4195 4195 ... ... @@ -4201,7 +4201,7 @@ 4201 4201 4202 4202 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4203 4203 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 4204 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace- Замена,Merge- Слияние,Add- Добавление3816 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 4205 4205 4206 4206 В теле использовать тип **form-data,** тип значения** file** 4207 4207 ... ... @@ -4380,67 +4380,64 @@ 4380 4380 Тело запроса: 4381 4381 4382 4382 { 4383 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4384 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4385 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса3995 + "vehicleIds": [vehicleId], 3996 + "from": "2023-11-22T09:29:48.051Z", 3997 + "to": "2023-11-22T09:29:48.051Z" 4386 4386 } 4387 4387 4000 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4001 +|vehicleIds|Массив ID объектов 4002 +|from|Дата начала запроса 4003 +|to|Дата окончания запроса 4004 + 4388 4388 Ответ: 4389 4389 4390 4390 { 4391 - "items": [ ~/~/ Список в разрезе ТС4008 + "items": [ 4392 4392 { 4393 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4394 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4395 - "vehicleId": 0, ~/~/ ID ТС4396 - "vehicleName": "string", ~/~/ Название ТС4397 - "vehicleModel": "string", ~/~/ Модель ТС4398 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4399 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4400 - "totalViolations": 0, ~/~/ Нарушений всего4401 - "violationsByType": { ~/~/ Информация о нарушениях по типу4402 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4403 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4404 - "brakingViolations": 0, ~/~/ Нарушений торможения4405 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4406 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4407 - "sensorViolations": 0 ~/~/ Нарушений по датчику4010 + "from": "2023-11-22T09:29:48.052Z", 4011 + "to": "2023-11-22T09:29:48.052Z", 4012 + "vehicleId": 0, 4013 + "vehicleName": "string", 4014 + "vehicleModel": "string", 4015 + "penalty": 0, 4016 + "score": 0, 4017 + "totalViolations": 0, 4018 + "violationsByType": { 4019 + "overspeedingViolations": 0, 4020 + "accelerationViolations": 0, 4021 + "brakingViolations": 0, 4022 + "turningViolations": 0, 4023 + "dangerousDrivingViolations": 0, 4024 + "sensorViolations": 0 4408 4408 }, 4409 - 4410 -((( 4411 - 4412 -))) 4413 - 4414 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4415 - "mileage": 0, ~/~/ Пробег, м 4416 - "tripsCount": 0, ~/~/ Кол-во рейсов 4417 - "trips": [ ~/~/ Информация по рейсу 4026 + "moveTime": 0, 4027 + "mileage": 0, 4028 + "tripsCount": 0, 4029 + "trips": [ 4418 4418 { 4419 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4420 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4421 - "violationsCount": 0, ~/~/ Всего нарушений4422 - "violationsByType": { ~/~/ Информация о нарушениях по типу4423 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4424 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4425 - "brakingViolations": 0, ~/~/ Нарушений торможения4426 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4427 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4428 - "sensorViolations": 0 ~/~/ Нарушений по датчику4031 + "penalty": 0, 4032 + "score": 0, 4033 + "violationsCount": 0, 4034 + "violationsByType": { 4035 + "overspeedingViolations": 0, 4036 + "accelerationViolations": 0, 4037 + "brakingViolations": 0, 4038 + "turningViolations": 0, 4039 + "dangerousDrivingViolations": 0, 4040 + "sensorViolations": 0 4429 4429 }, 4430 - 4431 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4432 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4433 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4434 - "mileage": 0, ~/~/ Пробег, м 4435 - "motohours": 0, ~/~/ Моточасы, секунды 4436 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4437 - "startAddress": "string", ~/~/ Адрес начала рейса 4438 - "endAddress": "string", ~/~/ Адрес конца рейса 4439 - "drivers": [ ~/~/ Список водителей 4042 + "moveTime": 0, 4043 + "mileage": 0, 4044 + "motohours": 0, 4045 + "maxSpeed": 0, 4046 + "startAddress": "string", 4047 + "endAddress": "string", 4048 + "drivers": [ 4440 4440 { 4441 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4442 - "driverName": "string", ~/~/ФИО водителя4443 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки4050 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4051 + "driverName": "string", 4052 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4444 4444 } 4445 4445 ] 4446 4446 } ... ... @@ -4449,6 +4449,34 @@ 4449 4449 ] 4450 4450 } 4451 4451 4061 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4062 +|from|Дата начала запроса 4063 +|to|Дата окончания 4064 +|vehicleId|ID объекта 4065 +|vehicleName|Имя объекта 4066 +|vehicleModel|Модель объекта 4067 +|penalty|Сумма штрафных баллов 4068 +|score|Оценка 4069 +|totalViolations|Суммарное количество нарушений 4070 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 4071 +|overspeedingViolations|Превышение скорости 4072 +|accelerationViolations|Ускорение 4073 +|brakingViolations|Торможение 4074 +|turningViolations|Резкий поворот 4075 +|dangerousDrivingViolations|Резкое вождение 4076 +|sensorViolations|Нарушение по датчику 4077 +|moveTime|Время в движении 4078 +|mileage|Пробег 4079 +|tripsCount|Количество рейсов 4080 +|motohours|Моточасы 4081 +|maxSpeed|Максимальная скорость 4082 +|startAddress|Адрес начала рейса 4083 +|endAddress|Адрес окончания рейса 4084 +|drivers|Список водителей, которые были на объекте в течениии рейса 4085 +|driverGuid|Guid водителя 4086 +|driverName|Имя водителя 4087 +|driverRfid|Номер Карты-метки 4088 + 4452 4452 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4453 4453 4454 4454 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == ... ... @@ -4457,7 +4457,7 @@ 4457 4457 4458 4458 (% class="box infomessage" %) 4459 4459 ((( 4460 - **POST /api/v3/fuelcards/transactions**4097 +POST /api/v3/fuelcards/transactions 4461 4461 ))) 4462 4462 4463 4463 Метод запроса: POST ... ... @@ -4468,59 +4468,34 @@ 4468 4468 Параметры в теле запроса (JSON): 4469 4469 4470 4470 { 4471 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ 4472 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ 4108 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4109 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4473 4473 "ids": [ 4474 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы4111 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4475 4475 ], 4476 - "timezone": 0 ~/~/ Часовойпояс4113 + "timezone": 0 ~/~/Таймзона 4477 4477 } 4478 4478 4479 4479 4480 4480 Ответ: 4481 4481 { 4482 - "date": "2024-04-11T10:41:02.265Z", ~/~/ 4483 - "driver": "string", ~/~/ 4484 - "object": "string", ~/~/ 4485 - "amount": 0, ~/~/ 4486 - "amountDut": 0, ~/~/ 4487 - "amountDiff": 0, ~/~/ 4488 - "amountDiffPerc": 0, ~/~/ 4489 - "summa": 0, ~/~/ 4490 - "serviceName": "string", ~/~/ 4491 - "price": 0, ~/~/ 4492 - "cardName": "string", ~/~/ 4493 - "cardNum": "string", ~/~/ 4494 - "operator": "string", ~/~/ 4495 - "address": "string" ~/~/ 4119 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4120 + "driver": "string", ~/~/Водители, привязанные к ТК 4121 + "object": "string", ~/~/Наименование ТС 4122 + "amount": 0, ~/~/Количество топлива 4123 + "amountDut": 0, ~/~/Количество по ДУТ 4124 + "amountDiff": 0, ~/~/Разница, л 4125 + "amountDiffPerc": 0, ~/~/Разница, % 4126 + "summa": 0, ~/~/Стоимость, руб 4127 + "serviceName": "string", ~/~/Тип топлива 4128 + "price": 0, ~/~/Цена за литр, руб 4129 + "cardName": "string", ~/~/Наименование ТК 4130 + "cardNum": "string", ~/~/Номер ТК 4131 + "operator": "string", ~/~/Оператор ТК 4132 + "address": "string" ~/~/Адрес АЗС 4496 4496 } 4497 4497 4498 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4499 4499 4500 -(% class="box infomessage" %) 4501 -((( 4502 -**GET /api/v3/fuelcards** 4503 -))) 4504 - 4505 -Метод запроса: GET 4506 - 4507 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4508 - 4509 -Ответ: 4510 - 4511 -[ 4512 - { 4513 - "Name": "string", ~/~/ Определяет наименование карты. 4514 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4515 - "Number": "string", ~/~/ Определяет № карты. 4516 - "Enabled": true, ~/~/ Определяет признак активности карты. 4517 - "Description": "string", ~/~/ Определяет описание карты. 4518 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4519 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4520 - "deleted": true ~/~/ Признак удаления 4521 - } 4522 -] 4523 - 4524 4524 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4525 4525 4526 4526 ... ... @@ -4531,28 +4531,28 @@ 4531 4531 **GET ** **/api/v3/retranslations/{id}** 4532 4532 ))) 4533 4533 4534 - id -Идентификаторретранслятора4146 +Идентификатор запроса: ID 4535 4535 4536 4536 4537 4537 Пример ответа: 4538 4538 4539 4539 { 4540 -"description": "", ~/~/ Поле описания ретранслятора4541 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)4542 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4543 -"isEnabled": true, ~/~/ Признак включенияретранслятора, Включен, true - включен, false - отключен4544 -"address": "string", ~/~/ Адрес и портпринимающего сервера4545 -"objects": [ ~/~/ 4152 +"description": "", ~/~/ Определяет описание 4153 +"subscriberId": "", ~/~/ Подписчик 4154 +"protocolType": 0, ~/~/ Тип протокола 4155 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4156 +"address": "string", ~/~/ Адрес события 4157 +"objects": [ ~/~/Объекты для ретрансляции 4546 4546 { 4547 4547 "id": "", ~/~/ Идентификатор объекта ретрансляции 4548 4548 "name": "", ~/~/ Наименование объекта ретрансляции 4549 -"imei": "", ~/~/ IMEI объекта ретрансляции4550 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4161 +"imei": "", ~/~/ IMEI объекта 4162 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4551 4551 } 4552 4552 ], 4553 -"id": "", ~/~/ Идентификаторретранслятора4554 -"parentId": "", ~/~/ Идентификаторродителя(вышестоящего клиента)4555 -"deleted": "" ~/~/ Признак удаления ретранслятора:true - включен, false - отключен4165 +"id": "", ~/~/ идентификатор пользователя 4166 +"parentId": "", ~/~/Guid родителя 4167 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4556 4556 } 4557 4557 4558 4558 ... ... @@ -4563,7 +4563,7 @@ 4563 4563 **DELETE** **/api/v3/retranslations/{id}** 4564 4564 ))) 4565 4565 4566 - id - Идентификаторретранслятора4178 +Параметр запроса: ID 4567 4567 4568 4568 4569 4569 == **Создание ретранслятора** == ... ... @@ -4576,16 +4576,16 @@ 4576 4576 Запрос: 4577 4577 4578 4578 { 4579 -"description": "", ~/~/ Поле описания ретранслятора4580 -"subscriberId": "", ~/~/ Идентификатор подписчика4581 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4582 -"address": "", ~/~/ Адрес и портпринимающегосервера4583 -"isEnabled": "", ~/~/ Признакретранслятора, true - включен, false - отключен4191 +"description": "", ~/~/ Описание 4192 +"subscriberId": "", ~/~/ Подписчик 4193 +"protocolType": 0, ~/~/ Тип протокола 4194 +"address": "", ~/~/ Адрес ретрансляции 4195 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4584 4584 "objects": [ ~/~/Объекты для ретрансляции 4585 4585 { 4586 -"id": "", ~/~/ Идентификаторретранслятора4587 -"imei": "", ~/~/ ретрансляции4588 -"isEnabled": "" ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4198 +"id": "", ~/~/ идентификатор пользователя 4199 +"imei": "", ~/~/IMEI объекта 4200 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4589 4589 } 4590 4590 ] 4591 4591 } ... ... @@ -4594,22 +4594,22 @@ 4594 4594 Ответ: 4595 4595 4596 4596 { 4597 -"description": "", ~/~/ Поле описания ретранслятора4598 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4599 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4600 -"isEnabled": true, ~/~/Признакретранслятора:true - включен, false - отключен4601 -"address": " string", ~/~/ Адреси портпринимающего сервера4602 -"objects": [ 4209 +"description": "string", ~/~/ Определяет описание 4210 +"subscriberId": "", ~/~/ идентификатор запроса 4211 +"protocolType": 0, ~/~/ Тип протокола 4212 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4213 +"address": "", ~/~/ Адрес события 4214 +"objects": [ ~/~/Объекты для ретрансляции 4603 4603 { 4604 -"id": "", ~/~/ Идентификатор объектаретрансляции4605 -"name": "string", ~/~/ На именование объекта ретрансляции4606 -"imei": "", ретрансляции4607 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4216 +"id": "", ~/~/ идентификатор пользователя 4217 +"name": "string", ~/~/ Название уведомления 4218 +"imei": "string", ~/~/IMEI объекта 4219 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4608 4608 } 4609 - ], 4610 -"id": "", ~/~/ Идентификаторретранслятора4611 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4612 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4221 + ], 4222 +"id": "", ~/~/ идентификатор пользователя 4223 +"parentId": "", ~/~/ Guid идентификатор родителя 4224 +"deleted": true ~/~/ Признак удаления 4613 4613 } 4614 4614 4615 4615 ... ... @@ -4623,18 +4623,18 @@ 4623 4623 Пример запроса: 4624 4624 4625 4625 { 4626 -"id": "", ~/~/ Идентификаторретранслятора4627 -"description": "string", ~/~/ Поле описания ретранслятора4628 -"subscriberId": "", ~/~/ Идентификатор подписчика4629 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4630 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4631 -"address": "string", ~/~/ Адрес и портпринимающего сервера4632 -"objects": ~/~/ 4238 +"id": "", ~/~/ идентификатор пользователя 4239 +"description": "string", ~/~/ Определяет описание 4240 +"subscriberId": "", ~/~/ идентификатор запроса 4241 +"protocolType": 0, ~/~/ Тип протокола 4242 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4243 +"address": "string", ~/~/ Адрес события 4244 +"objects": ~/~/Объекты для ретрансляции 4633 4633 [ 4634 4634 { 4635 -"id": "", ~/~/ Идентификатор объектаретрансляции4636 -"imei": "", ~/~/ ретрансляции4637 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4247 +"id": "", ~/~/ идентификатор пользователя 4248 +"imei": "", ~/~/IMEI объекта 4249 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4638 4638 } 4639 4639 ] 4640 4640 } ... ... @@ -4643,22 +4643,22 @@ 4643 4643 Пример ответа: 4644 4644 4645 4645 { 4646 -"description": "", ~/~/ Поле описания ретранслятора4647 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4648 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4649 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4650 -"address": "string", ~/~/ Адрес и портпринимающего сервера4651 -"objects": [ ~/~/ 4258 +"description": "", ~/~/ Определяет описание 4259 +"subscriberId": "", ~/~/ идентификатор запроса 4260 +"protocolType": 0, ~/~/ Тип протокола 4261 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4262 +"address": "string", ~/~/ Адрес события 4263 +"objects": [ ~/~/Объекты для ретрансляции 4652 4652 { 4653 -"id": "", ~/~/ Идентификатор объектаретрансляции4654 -"name": "string", ~/~/ На именование объекта ретрансляции4655 -"imei": "", ~/~/ ретрансляции4656 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4265 +"id": "", ~/~/ идентификатор пользователя 4266 +"name": "string", ~/~/ Название уведомления 4267 +"imei": "", ~/~/IMEI объекта 4268 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4657 4657 } 4658 4658 ], 4659 -"id": "", ~/~/ Идентификаторретранслятора4660 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4661 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4271 +"id": "", ~/~/ идентификатор пользователя 4272 +"parentId": "", ~/~/ Guid идентификатор родителя 4273 +"deleted": true ~/~/ Признак удаления 4662 4662 } 4663 4663 4664 4664 ... ... @@ -4672,34 +4672,34 @@ 4672 4672 Пример запроса: 4673 4673 4674 4674 { 4675 -"id": "", ~/~/ Идентификаторретранслятора4676 -"search": "string", ~/~/ 4677 -"parentId": "" ~/~/ Идентификатор родительскогоагента, для которого надо получить данные(обязательный параметр).4287 +"id": "", ~/~/ идентификатор пользователя 4288 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4289 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4678 4678 } 4679 4679 4680 -Ответ :4292 +Ответ 4681 4681 4682 4682 [ 4683 4683 { 4684 -"description": "", ~/~/ Поле описания ретранслятора4685 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4686 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4687 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4688 -"address": "string", ~/~/ Адрес и портпринимающего сервера4689 -"id": "", ~/~/ Идентификаторретранслятора4690 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4691 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4296 +"description": "", ~/~/ Определяет описание 4297 +"subscriberId": "", ~/~/ идентификатор запроса 4298 +"protocolType": 0, ~/~/ Тип протокола 4299 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4300 +"address": "string", ~/~/ Адрес события 4301 +"id": "", ~/~/ идентификатор пользователя 4302 +"parentId": "", ~/~/ Guid идентификатор родителя 4303 +"deleted": true ~/~/ Признак удаления 4692 4692 } 4693 4693 ] 4694 4694 4695 4695 4696 -= (% style="color:#000000; font-size:18.6667px" %) **Раздел: Отчеты**(%%) =4308 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Отчеты**(%%) = 4697 4697 4698 4698 == **API для отчета по выгрузке комбайнов** == 4699 4699 4700 4700 (% class="box infomessage" %) 4701 4701 ((( 4702 - **POST /api/v3/Reports/harvesterUnloading**4314 +POST **/api/v3/Reports/harvesterUnloading** 4703 4703 ))) 4704 4704 4705 4705 Пример запроса: ... ... @@ -4771,631 +4771,7 @@ 4771 4771 ] 4772 4772 4773 4773 4774 -== **Отчет трек-датчики** == 4775 - 4776 -(% class="box infomessage" %) 4777 -((( 4778 -**POST /api/v3/Reports/sensorsWorks** 4779 -))) 4780 - 4781 -**Пример запроса:** 4782 - 4783 -{ 4784 - "vehicleIds": [ ~/~/ Список ID объектов 4785 - 0 4786 - ], 4787 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4788 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4789 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4790 -} 4791 - 4792 -**Пример ответа:** 4793 - 4794 -((( 4795 -{ 4796 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4797 - { 4798 - "vehicleId": 0, ~/~/ Идентификатор ТС 4799 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4800 - { 4801 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4802 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4803 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4804 - "name": "string", ~/~/ Наименование оборудования. 4805 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4806 - "totalMileage": 0, ~/~/ Общий пробег. 4807 - "avgSpeed": 0 ~/~/ Средняя скорость. 4808 - } 4809 - ] 4810 - } 4811 - ] 4812 -} 4813 -))) 4814 - 4815 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4816 - 4817 - 4818 -== **Запрос списка полей** == 4819 - 4820 -(% class="box successmessage" %) 4821 -((( 4822 -**POST /api/v3/agroLands/find** 4823 -))) 4824 - 4825 -Пример запроса: 4826 - 4827 -((( 4828 -((( 4829 -((( 4830 -{ 4831 - "year": 0, ~/~/ Фильтр по году 4832 - "name": "string", ~/~/ Фильтр по названию 4833 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 4834 -} 4835 -))) 4836 -))) 4837 - 4838 - 4839 -))) 4840 - 4841 -Пример ответа: 4842 - 4843 -((( 4844 -[ 4845 - { 4846 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4847 - "year": 0, ~/~/ Год поля 4848 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 4849 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 4850 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 4851 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4852 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4853 - "counts": { ~/~/ Счётчики с/х поля 4854 - "fieldOperations": 0, ~/~/ Количество операций на поле 4855 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4856 - "facts": 0 ~/~/ Счётчик факта 4857 - }, 4858 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4859 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4860 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4861 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4862 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4863 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4864 - "planComment": "string", ~/~/ Комментарий к полю 4865 - "productivity": 0, ~/~/ Урожайность. 4866 - "id": 0, ~/~/ Идентификатор объекта геозоны 4867 - "name": "string", ~/~/ Название объекта геозоны 4868 - "type": 0, ~/~/ Тип объекта геозоны 4869 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4870 - "fname": "string", ~/~/ Имя файла 4871 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4872 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 4873 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 4874 - "description": "string", ~/~/ Описание объекта геозоны 4875 - "area": 0, ~/~/ Площадь, м2 4876 - "perimetr": 0, ~/~/ Периметр, м 4877 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 4878 - } 4879 -] 4880 - 4881 - 4882 -== **Создание нового поля ** == 4883 - 4884 -(% class="box successmessage" %) 4885 -((( 4886 -**POST /api/v3/agroLands** 4887 -))) 4888 - 4889 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 4890 -X-agent - ID клиента 4891 - 4892 -Пример запроса: 4893 - 4894 -((( 4895 -{ 4896 - "extId": "string", 4897 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля 4898 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля 4899 - "display": "string", ~/~/ Настройки отображения 4900 - "year": 0, ~/~/ Год поля 4901 - "name": "string", ~/~/ Наименование 4902 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4903 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая 4904 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая 4905 - "planComment": "string", ~/~/ Комментарий к полю 4906 - "cropRotations": [ ~/~/ Данные по севообороту 4907 - { 4908 - "landId": 0, ~/~/ ID поля 4909 - "landName": "string", ~/~/ Название поля 4910 - "year": 0, ~/~/ Год урожая 4911 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4912 - "cultureName": "string", ~/~/ Название культуры 4913 - "productivity": 0, ~/~/ Урожайность 4914 - "area": 0, ~/~/ Площадь поля, Га 4915 - "total": 0, ~/~/ Валовый сбор 4916 - "productivityFact": 0, ~/~/ Фактическая урожайность 4917 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4918 - "totalFact": 0, ~/~/ Фактический валовый сбор 4919 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ 4920 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева 4921 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая 4922 - "isyearplan": true, ~/~/ Годовой план 4923 - "comment": "string" ~/~/ Комментарий 4924 - } 4925 - ] 4926 -} 4927 -))) 4928 - 4929 -((( 4930 - 4931 -))) 4932 - 4933 -Пример ответа: 4934 - 4935 -((( 4936 -((( 4937 -{ 4938 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4939 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4940 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4941 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4942 - "cropRotations": [ ~/~/ Данные по севообороту 4943 - { 4944 - "landId": 0, ~/~/ ID поля 4945 - "landName": "string", ~/~/ Название поля 4946 - "year": 0, ~/~/ Год урожая 4947 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4948 - "cultureName": "string", ~/~/ Название культуры 4949 - "productivity": 0, ~/~/ Урожайность 4950 - "area": 0, ~/~/ Площадь поля, Га. 4951 - "total": 0, ~/~/ Валовый сбор 4952 - "productivityFact": 0, ~/~/ Фактическая урожайность 4953 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4954 - "totalFact": 0, ~/~/ Фактический валовый сбор 4955 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ 4956 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева 4957 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая 4958 - "isyearplan": true, ~/~/ годовой план 4959 - "comment": "string" ~/~/ Комментарий 4960 - } 4961 - ], 4962 - "cropVegetation": [ ~/~/ История вегетации поля 4963 - { 4964 - "values": [ ~/~/ Данные вегетации и состояния посева 4965 - { 4966 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 4967 - "ndvi": 0 ~/~/ Индекс вегетации 4968 - } 4969 - ], 4970 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 4971 - { 4972 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 4973 - "type": "string", ~/~/ Тип 4974 - "pictureid": "string" ~/~/ Идентификатор ресурса 4975 - } 4976 - ], 4977 - "states": [ ~/~/ Ключевые даты развития поля 4978 - { 4979 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 4980 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 4981 - } 4982 - ] 4983 - } 4984 - ], 4985 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая 4986 - "counts": { 4987 - "fieldOperations": 0, ~/~/ Количество операций на поле 4988 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4989 - "facts": 0 ~/~/ Счётчик факта 4990 - }, 4991 - "planComment": "string", ~/~/ Комментарий к полю 4992 -))) 4993 - 4994 -((( 4995 - "productivity": 0, ~/~/ Урожайность. 4996 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4997 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая 4998 - "year": 0, ~/~/ Год поля 4999 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5000 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5001 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5002 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5003 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто 5004 - "id": 0, ~/~/ Идентификатор объекта геозоны 5005 - "name": "string", ~/~/ Название объекта геозоны 5006 - "type": 0, ~/~/ Тип объекта геозоны 5007 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5008 - "fname": "string", ~/~/ Имя файла 5009 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5010 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны 5011 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны 5012 - "description": "string", ~/~/ Описание объекта геозоны 5013 - "area": 0, ~/~/ Площадь, м2 5014 - "perimetr": 0, ~/~/ Периметр, м 5015 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5016 -} 5017 - 5018 - 5019 -))) 5020 -))) 5021 -))) 5022 - 5023 -== **Получение поля по id** == 5024 - 5025 -(% class="box infomessage" %) 5026 -((( 5027 -**GET /api/v3/agroLands/{id}** 5028 -))) 5029 - 5030 -Пример запроса: 5031 -id ~/~/ Идентификатор поля 5032 - 5033 -Пример ответа: 5034 - 5035 -((( 5036 -{ 5037 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5038 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5039 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5040 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5041 - "cropRotations": [ ~/~/ Данные по севообороту 5042 - { 5043 - "landId": 0, ~/~/ ID поля 5044 - "landName": "string", ~/~/ Название поля 5045 - "year": 0, ~/~/ Год урожая 5046 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5047 - "cultureName": "string", ~/~/ Название культуры 5048 - "productivity": 0, ~/~/ Урожайность 5049 - "area": 0, ~/~/ Площадь поля, Га 5050 - "total": 0, ~/~/ Валовый сбор 5051 - "productivityFact": 0, ~/~/ Фактическая урожайность 5052 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5053 - "totalFact": 0, ~/~/ Фактический валовый сбор 5054 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5055 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5056 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5057 - "isyearplan": true, ~/~/ План года 5058 - "comment": "string" ~/~/ Комментарий 5059 - } 5060 - ], 5061 - "cropVegetation": [ ~/~/ История вегетации поля 5062 - { 5063 - "values": [ ~/~/ Данные вегетации и состояния посева 5064 - { 5065 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5066 - "ndvi": 0 ~/~/ Индекс вегетации 5067 - } 5068 - ], 5069 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5070 - { 5071 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5072 - "type": "string", ~/~/ Тип 5073 - "pictureid": "string" ~/~/ Идентификатор ресурса 5074 - } 5075 - ], 5076 - "states": [ ~/~/ Ключевые даты развития поля 5077 - { 5078 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5079 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5080 - } 5081 - ] 5082 - } 5083 - ], 5084 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5085 - "counts": { 5086 - "fieldOperations": 0, ~/~/ Количество операций на поле 5087 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5088 - "facts": 0 ~/~/ Счётчик факта 5089 - }, 5090 - "planComment": "string", ~/~/ Комментарий к полю 5091 - "productivity": 0, ~/~/ Урожайность. 5092 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5093 -))) 5094 - 5095 -((( 5096 -((( 5097 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5098 - "year": 0, ~/~/ Год поля 5099 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5100 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5101 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5102 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5103 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5104 - "id": 0, ~/~/ Идентификатор объекта геозоны 5105 - "name": "string", ~/~/ Название объекта геозоны 5106 - "type": 0, ~/~/ Тип объекта геозоны 5107 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5108 - "fname": "string", ~/~/ Имя файла 5109 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5110 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5111 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5112 - "description": "string", ~/~/ Описание объекта геозоны 5113 - "area": 0, ~/~/ Площадь, м2 5114 - "perimetr": 0, ~/~/ Периметр, м 5115 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5116 -} 5117 -))) 5118 - 5119 - 5120 -== **Удаление существующего поля** == 5121 - 5122 -(% class="box errormessage" %) 5123 -((( 5124 -**DELETE /api/v3/agroLands/{id}** 5125 -))) 5126 - 5127 -Пример запроса: 5128 -id ~/~/ Идентификатор поля 5129 - 5130 -Пример ответа: 5131 - 5132 -((( 5133 -200 ~/~/ Успех 5134 -))) 5135 - 5136 -((( 5137 - 5138 -))) 5139 - 5140 -((( 5141 -((( 5142 -((( 5143 - 5144 -))) 5145 - 5146 -((( 5147 -== **Изменение поля** == 5148 - 5149 -(% class="box infomessage" %) 5150 -((( 5151 -**PUT /api/v3/agroLands** 5152 -))) 5153 - 5154 -Пример запроса: 5155 - 5156 -((( 5157 -((( 5158 -{ 5159 - "id": 0, ~/~/ Идентификатор поля 5160 - "extId": "string", ~/~/ ExtId 5161 - "shape": "string", ~/~/ Форма поля 5162 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5163 - "display": "string", ~/~/ Настройки отображения 5164 - "year": 0, ~/~/ Год поля 5165 - "name": "string", ~/~/ Наименование 5166 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5167 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая 5168 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая 5169 - "planComment": "string", ~/~/Комментарий к полю 5170 - "cropRotations": [ ~/~/ Данные по севообороту 5171 - { 5172 - "landId": 0, ~/~/ ID поля 5173 - "landName": "string", ~/~/ Название поля 5174 - "year": 0, ~/~/ Год урожая 5175 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5176 - "cultureName": "string", ~/~/ Название культуры 5177 - "productivity": 0, ~/~/ Урожайность 5178 - "area": 0, ~/~/ Площадь поля, Га. 5179 - "total": 0, ~/~/ Валовый сбор 5180 - "productivityFact": 0, ~/~/ Фактическая урожайность 5181 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5182 - "totalFact": 0, ~/~/ Фактический валовый сбор 5183 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ 5184 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева 5185 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая 5186 - "isyearplan": true, 5187 - "comment": "string" ~/~/ Комментарий 5188 - } 5189 - ], 5190 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику 5191 -} 5192 -))) 5193 -))) 5194 - 5195 -((( 5196 - 5197 -))) 5198 - 5199 -Пример ответа: 5200 - 5201 -((( 5202 -((( 5203 -((( 5204 -{ 5205 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5206 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5207 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5208 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5209 - "cropRotations": [ ~/~/ Данные по севообороту 5210 - { 5211 - "landId": 0, ~/~/ ID поля 5212 - "landName": "string", ~/~/ Название поля 5213 - "year": 0, ~/~/ Год урожая 5214 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5215 - "cultureName": "string", ~/~/ Название культуры 5216 - "productivity": 0, ~/~/ Урожайность 5217 - "area": 0, ~/~/ Площадь поля, Га 5218 - "total": 0, ~/~/ Валовый сбор 5219 - "productivityFact": 0, ~/~/ Фактическая урожайность 5220 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5221 - "totalFact": 0, ~/~/ Фактический валовый сбор 5222 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ 5223 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева 5224 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая 5225 - "isyearplan": true, ~/~/ 5226 - "comment": "string" ~/~/ Комментарий 5227 - } 5228 - ], 5229 - "cropVegetation": [ ~/~/ История вегетации поля 5230 - { 5231 - "values": [ ~/~/ Данные вегетации и состояния посева 5232 - { 5233 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5234 - "ndvi": 0 ~/~/ Индекс вегетации 5235 - } 5236 - ], 5237 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5238 - { 5239 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5240 - "type": "string", ~/~/ Тип 5241 - "pictureid": "string" ~/~/ Идентификатор ресурса 5242 - } 5243 - ], 5244 - "states": [ ~/~/ Ключевые даты развития поля 5245 - { 5246 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5247 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5248 - } 5249 - ] 5250 - } 5251 - ], 5252 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая 5253 - "counts": { 5254 - "fieldOperations": 0, ~/~/ Количество операций на поле 5255 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5256 - "facts": 0 ~/~/ Счётчик факта 5257 - }, 5258 - "planComment": "string", ~/~/ Комментарий к полю 5259 - "productivity": 0, ~/~/ Урожайность. 5260 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5261 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая 5262 - "year": 0, ~/~/ Год поля 5263 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5264 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5265 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5266 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5267 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5268 - "id": 0, ~/~/ Идентификатор объекта геозоны 5269 - "name": "string", ~/~/ Название объекта геозоны 5270 - "type": 0, ~/~/ Тип объекта геозоны 5271 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5272 - "fname": "string", ~/~/ Имя файла 5273 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5274 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны 5275 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны 5276 - "description": "string", ~/~/ Описание объекта геозоны 5277 - "area": 0, ~/~/ Площадь, м2 5278 - "perimetr": 0, ~/~/ Периметр, м 5279 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд 5280 -} 5281 -))) 5282 -))) 5283 -))) 5284 -))) 5285 -))) 5286 - 5287 - 5288 -== **Редактирование года урожая ** == 5289 - 5290 -(% class="box successmessage" %) 5291 -((( 5292 -**POST /api/v3/agroLands/updateOpenCloseYear** 5293 -))) 5294 - 5295 -Пример запроса: 5296 - 5297 -((( 5298 -((( 5299 -{ 5300 - "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5301 - 0 5302 - ], 5303 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5304 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5305 -} 5306 -))) 5307 - 5308 - 5309 -))) 5310 - 5311 -Пример ответа: 5312 - 5313 -((( 5314 -((( 5315 -{ 5316 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5317 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5318 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5319 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5320 - "cropRotations": [ ~/~/ Данные по севообороту 5321 - { 5322 - "landId": 0, ~/~/ ID поля 5323 - "landName": "string", ~/~/ Название поля 5324 - "year": 0, ~/~/ Год урожая 5325 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5326 - "cultureName": "string", ~/~/ Название культуры 5327 - "productivity": 0, ~/~/ Урожайность 5328 - "area": 0, ~/~/ Площадь поля, Га. 5329 - "total": 0, ~/~/ Валовый сбор 5330 - "productivityFact": 0, ~/~/ Фактическая урожайность 5331 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5332 - "totalFact": 0, ~/~/ Фактический валовый сбор 5333 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5334 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5335 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5336 - "isyearplan": true, ~/~/ 5337 - "comment": "string" ~/~/ Комментарий 5338 - } 5339 - ], 5340 - "cropVegetation": [ ~/~/ История вегетации поля 5341 - { 5342 - "values": [ ~/~/ Данные вегетации и состояния посева 5343 - { 5344 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5345 - "ndvi": 0 ~/~/ Индекс вегетации 5346 - } 5347 - ], 5348 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5349 - { 5350 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5351 - "type": "string", ~/~/ Тип 5352 - "pictureid": "string" ~/~/ Идентификатор ресурса 5353 - } 5354 - ], 5355 - "states": [ ~/~/ Ключевые даты развития поля 5356 - { 5357 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5358 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5359 - } 5360 - ] 5361 - } 5362 - ], 5363 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5364 - "counts": { 5365 - "fieldOperations": 0, ~/~/ Количество операций на поле 5366 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5367 - "facts": 0 ~/~/ Счётчик факта 5368 - }, 5369 - "planComment": "string", ~/~/ Комментарий к полю 5370 - "productivity": 0, ~/~/ Урожайность. 5371 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5372 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5373 - "year": 0, ~/~/ Год поля 5374 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5375 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5376 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5377 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5378 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5379 - "id": 0, ~/~/ Идентификатор объекта геозоны 5380 - "name": "string", ~/~/ Название объекта геозоны 5381 - "type": 0, ~/~/ Тип объекта геозоны 5382 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5383 - "fname": "string", ~/~/ Имя файла 5384 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5385 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5386 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5387 - "description": "string", ~/~/ Описание объекта геозоны 5388 - "area": 0, ~/~/ Площадь, м2 5389 - "perimetr": 0, ~/~/ ериметр, м 5390 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5391 -} 5392 -))) 5393 - 5394 - 5395 5395 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5396 -))) 5397 -))) 5398 -))) 5399 5399 5400 5400 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5401 5401 ... ... @@ -5402,7 +5402,7 @@ 5402 5402 5403 5403 (% class="box infomessage" %) 5404 5404 ((( 5405 - **GET api/v3/Vehicles/recyclebin/all**4393 +GET api/v3/Vehicles/recyclebin/all 5406 5406 ))) 5407 5407 5408 5408 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5437,11 +5437,11 @@ 5437 5437 ] 5438 5438 5439 5439 5440 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==4428 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5441 5441 5442 5442 (% class="box infomessage" %) 5443 5443 ((( 5444 - **POST**4432 +POST/api/v3/Vehicles/recyclebin/erase 5445 5445 ))) 5446 5446 5447 5447 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5483,7 +5483,7 @@ 5483 5483 5484 5484 (% class="box infomessage" %) 5485 5485 ((( 5486 - **POST**4474 +POST/api/v3/Vehicles/recyclebin/restore 5487 5487 ))) 5488 5488 5489 5489 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5535,409 +5535,7 @@ 5535 5535 ] 5536 5536 5537 5537 5538 -= **Раздел: Журнал заданий ** = 5539 5539 5540 - 5541 -== **Создание задания в Журнале заданий** == 5542 - 5543 -(% class="box infomessage" %) 5544 -((( 5545 -**POST /api/v3/vehicletasks** 5546 -))) 5547 - 5548 -Пример запроса: 5549 - 5550 -((( 5551 -{ 5552 - "vehicleId": 0, ~/~/ Идентификатор ТС 5553 - "description": "string", ~/~/ Описание 5554 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5555 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5556 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5557 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5558 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5559 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5560 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5561 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5562 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5563 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5564 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5565 - "cost": { 5566 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5567 - "Name": "string", ~/~/ Наименование 5568 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5569 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5570 - "Norm": 0 ~/~/ Норма внесения 5571 - }, 5572 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5573 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5574 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5575 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5576 - "deleted": true, ~/~/ Признак удаления 5577 - "extId": "string", 5578 - "GeoIds": [ ~/~/ Cвязанные поля 5579 - 0 5580 - ] 5581 -} 5582 -))) 5583 - 5584 - 5585 -Пример ответа: 5586 - 5587 -{ 5588 - "vehicleId": 0, ~/~/ Идентификатор ТС 5589 - "description": "string", ~/~/ Описание 5590 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5591 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5592 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5593 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5594 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5595 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5596 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5597 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5598 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5599 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5600 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5601 - "cost": { 5602 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5603 - "Name": "string", ~/~/ Наименование 5604 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5605 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5606 - "Norm": 0 ~/~/ Норма внесения 5607 - }, 5608 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5609 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5610 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5611 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5612 - "deleted": true, ~/~/ Признак удаления 5613 - "extId": "string", ~/~/ ExtId 5614 - "GeoIds": [ ~/~/ Связанные поля 5615 - 0 5616 - ] 5617 -} 5618 - 5619 - 5620 -== **Редактирование задания в Журнале заданий** == 5621 - 5622 -(% class="box successmessage" %) 5623 -((( 5624 -**PUT /api/v3/vehicletasks** 5625 -))) 5626 - 5627 -Пример запроса: 5628 - 5629 -((( 5630 -{ 5631 - "vehicleId": 0, ~/~/ Идентификатор ТС 5632 - "description": "string", ~/~/ Описание 5633 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5634 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5635 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5636 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5637 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5638 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5639 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5640 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5641 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5642 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5643 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5644 - "cost": { 5645 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5646 - "Name": "string", ~/~/ Наименование 5647 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5648 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5649 - "Norm": 0 ~/~/ Норма внесения 5650 - }, 5651 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5652 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5653 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5654 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5655 - "deleted": true, ~/~/ Признак удаления 5656 - "extId": "string", ~/~/ ExtId 5657 - "GeoIds": [ ~/~/ Связанные поля 5658 - 0 5659 - ] 5660 -} 5661 -))) 5662 - 5663 - 5664 -Пример ответа: 5665 - 5666 -{ 5667 - "vehicleId": 0, ~/~/ Идентификатор ТС 5668 - "description": "string", ~/~/ Описание 5669 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5670 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5671 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5672 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5673 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5674 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5675 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5676 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5677 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5678 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5679 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5680 - "cost": { 5681 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5682 - "Name": "string", ~/~/ Наименование 5683 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5684 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5685 - "Norm": 0 ~/~/ Норма внесения 5686 - }, 5687 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5688 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5689 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5690 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5691 - "deleted": true, ~/~/ Признак удаления 5692 - "extId": "string", ~/~/ ExtId 5693 - "GeoIds": [ ~/~/ Связанные поля 5694 - 0 5695 - ] 5696 -} 5697 - 5698 - 5699 -== **Удаление задания в Журнале заданий** == 5700 - 5701 -(% class="box warningmessage" %) 5702 -((( 5703 -**DELETE /api/v3/vehicletasks** 5704 -))) 5705 - 5706 -Пример запроса: 5707 - 5708 -((( 5709 -[ 5710 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5711 -] 5712 -))) 5713 - 5714 -((( 5715 - 5716 -))) 5717 - 5718 -Пример ответа: 5719 - 5720 -{ 5721 - "vehicleId": 0, ~/~/ Идентификатор ТС 5722 - "description": "string", ~/~/ Описание 5723 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5724 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5725 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5726 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5727 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5728 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5729 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5730 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5731 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5732 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5733 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5734 - "cost": { 5735 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5736 - "Name": "string", ~/~/ Наименование 5737 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5738 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5739 - "Norm": 0 ~/~/ Норма внесения 5740 - }, 5741 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5742 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5743 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5744 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5745 - "deleted": true, ~/~/ Признак удаления 5746 - "extId": "string", ~/~/ ExtId 5747 - "GeoIds": [ ~/~/ Связанные поля 5748 - 0 5749 - ] 5750 -} 5751 - 5752 - 5753 -== **Получение списка Журнала заданий** == 5754 - 5755 -(% class="box infomessage" %) 5756 -((( 5757 -**POST /api/v3/vehicletasks/getbyperiod** 5758 -))) 5759 - 5760 -Пример запроса: 5761 - 5762 -((( 5763 -{ 5764 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 5765 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 5766 - "TimeZone": 0, ~/~/ Часовой пояс. 5767 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 5768 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 5769 - ], 5770 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 5771 - 0 5772 - ], 5773 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 5774 - 0 5775 - ], 5776 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 5777 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 5778 -} 5779 -))) 5780 - 5781 - 5782 -Пример ответа: 5783 - 5784 -((( 5785 -{ 5786 - "total": 0, ~/~/ Общее количество записей 5787 - "pages": 0, ~/~/ Общее количество страниц 5788 - "currentPage": 0, ~/~/ Текущая страница 5789 - "items": [ ~/~/ Записи 5790 - { 5791 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5792 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 5793 - "name": "string", ~/~/ Название задания. 5794 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 5795 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 5796 - "workKind": "string", ~/~/ Вид работ 5797 - "techOp": "string", ~/~/ Тех. операция 5798 - "trailerModel": "string", ~/~/ Модель агрегата 5799 - "width": "string", ~/~/ Ширина, м 5800 - "speed": "string", ~/~/ Тех. скорость 5801 - "fields": "string", ~/~/ Поля 5802 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 5803 - "vehicles": "string", ~/~/ Объект-модель 5804 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 5805 - "drivers": "string", ~/~/ Водители 5806 - "tmc": "string", ~/~/ ТМЦ 5807 - "client": "string", ~/~/ Клиент 5808 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5809 - "dep": "string", ~/~/ Подразделение 5810 - "geoIds": [ ~/~/ Связанные поля 5811 - 0 5812 - ] 5813 - } 5814 - ] 5815 -} 5816 -))) 5817 - 5818 - 5819 -= **Раздел: Локатор ** = 5820 - 5821 - 5822 -== **Получение списка локаторов, доступных пользователю ** == 5823 - 5824 -(% class="box infomessage" %) 5825 -((( 5826 -**GET /api/v3/locators** 5827 -))) 5828 - 5829 -В заголовках запроса: X-Auth: Токен авторизации 5830 - 5831 - 5832 -Пример ответа: 5833 - 5834 -((( 5835 -[ 5836 - { 5837 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5838 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5839 - "agentName": "string", ~/~/ Наименование агента. 5840 - "isEnabled": true, ~/~/ Активен 5841 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5842 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5843 - "name": "string", ~/~/ Наименование 5844 - "status": 0, ~/~/ 5845 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5846 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5847 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5848 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5849 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5850 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5851 - "url": "string", ~/~/ Ссылка 5852 - "language": 0, ~/~/ Язык. 5853 - "vehiclesCount": 0, ~/~/ Количество объектов. 5854 - "geozonesCount": 0, ~/~/ Количество геозон. 5855 - "fieldsCount": 0 ~/~/ Количество полей. 5856 - } 5857 -] 5858 -))) 5859 - 5860 - 5861 - 5862 -== **Создание локатора** == 5863 - 5864 -(% class="box successmessage" %) 5865 -((( 5866 -**POST /api/v3/locators** 5867 -))) 5868 - 5869 -Пример запроса: 5870 - 5871 -((( 5872 -{ 5873 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5874 - "isEnabled": true, ~/~/ Активность 5875 - "name": "string", ~/~/ Наименование локатора 5876 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 5877 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 5878 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5879 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5880 - "url": "string", ~/~/ Ссылка 5881 - "language": 0 ~/~/ Язык 5882 -} 5883 -))) 5884 - 5885 - 5886 -Пример ответа: 5887 - 5888 -((( 5889 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 5890 -))) 5891 - 5892 - 5893 - 5894 -== **Изменение локатора** == 5895 - 5896 -(% class="box infomessage" %) 5897 -((( 5898 -**PUT /api/v3/locators** 5899 -))) 5900 - 5901 -Пример запроса: 5902 - 5903 -((( 5904 -{ 5905 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5906 - "isEnabled": true, ~/~/ Активность 5907 - "name": "string", ~/~/ Наименование 5908 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 5909 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 5910 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5911 - "autoProlongation": true, ~/~/ Автопродление срока действия 5912 - "url": "string", ~/~/ Ссылка 5913 - "language": 0 ~/~/ Язык 5914 -} 5915 -))) 5916 - 5917 - 5918 -Пример ответа: 5919 - 5920 -200 ~/~/ Success 5921 - 5922 - 5923 -== **Удалить локатор** == 5924 - 5925 -(% class="box warningmessage" %) 5926 -((( 5927 -**DELETE /api/v3/locators** 5928 -))) 5929 - 5930 -Пример запроса: 5931 - 5932 -((( 5933 -[ 5934 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 5935 -] 5936 -))) 5937 - 5938 - 5939 - 5940 - 5941 5941 (% class="box" lang="en-US" style="text-align: center;" %) 5942 5942 ((( 5943 5943 (% 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]] **