Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/11/22 14:54
on 2024/11/22 14:54
edited by Андрей Калиновский
on 2024/07/19 14:25
on 2024/07/19 14:25
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,16 +1,5 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -(% class="box warningmessage" %) 4 -((( 5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно просим вас соблюдать несколько простых правил при использовании API-команд:## 6 -))) 7 - 8 -* Формировать не более 3 отчётов одновременно. 9 -* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 10 - 11 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить работу команд. 12 - 13 - 14 14 **Содержание страницы:** 15 15 ))) 16 16 ... ... @@ -25,20 +25,11 @@ 25 25 26 26 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 27 27 28 -(% style="color:#000000" %)− (%%)При **редактировании** любойзаписи (пользователь, объект и т.д)необходимо передавать все параметры записив теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 29 29 30 - 31 -(% style="color:#000000; font-size:16px" %)**Рекомендации** 32 - 33 -- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 34 - 35 35 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 36 36 37 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 38 -((( 39 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 40 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 41 -))) 21 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 42 42 43 43 (% class="box successmessage" %) 44 44 ((( ... ... @@ -64,8 +64,12 @@ 64 64 65 65 (% lang="en-US" %) 66 66 (% style="color:#000000" %){ 67 - "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации 68 - "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" %) 69 69 } 70 70 71 71 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. ... ... @@ -245,6 +245,7 @@ 245 245 "bankKS": "string" ~/~/ корр. счёт 246 246 } 247 247 232 + 248 248 Ответ: 249 249 250 250 { ... ... @@ -438,6 +438,7 @@ 438 438 ], 439 439 "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 440 440 } 426 + 441 441 { 442 442 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 443 443 "lastName": "string", ... ... @@ -451,8 +451,12 @@ 451 451 452 452 (% style="text-align:left" %) 453 453 (% style="color:#000000; font-weight:normal" %)Ответ: 454 -{ 455 - "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 пользователя 456 456 "lastName": "" , ~/~/ Фамилия , 457 457 "firstName": "" , ~/~/ Имя 458 458 "position": "" , ~/~/ Должность ... ... @@ -469,9 +469,11 @@ 469 469 "kind": "" , ~/~/ тип аутентификации 470 470 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 471 471 "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя 472 -} 473 473 463 +(% style="text-align:left" %) 464 +(% style="color:#000000; font-weight:normal" %)} 474 474 466 + 475 475 == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) == 476 476 477 477 (% class="box infomessage" %) ... ... @@ -491,16 +491,19 @@ 491 491 492 492 (% style="color:#000000" %)Параметры в теле запроса (JSON): 493 493 494 -(% style="color:#000000" %){(%%) 486 +(% style="color:#000000" %){ 487 + 495 495 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента 496 496 "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно 497 497 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 498 498 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 492 + 499 499 (% style="color:#000000" %)} 500 500 501 501 (% style="color:#000000" %)Ответ: 502 502 503 503 (% style="color:#000000" %){ (%%) 498 + 504 504 "id": "" , ~/~/ идентификатор пользователя 505 505 "lastName": "" , ~/~/ фамилия 506 506 "firstName": "" , ~/~/ имя ... ... @@ -514,6 +514,7 @@ 514 514 "sessionDuration":"", ~/~/ длительность сессии в минутах 515 515 "status": "1", ~/~/ статус пользователя 516 516 "lastLogged": "", ~/~/ дата/время последней авторизации 512 + 517 517 (% style="color:#000000" %)} 518 518 519 519 == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) == ... ... @@ -587,8 +587,10 @@ 587 587 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 588 588 589 589 (% lang="en-US" style="text-align:left" %) 590 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 591 - "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 пользователя 592 592 "lastName": "" , ~/~/ фамилия 593 593 "firstName": "" , ~/~/ имя 594 594 "position": "" , ~/~/ должность ... ... @@ -610,7 +610,9 @@ 610 610 "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации 611 611 }, 612 612 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 613 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя(%%) 611 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 612 + 613 +(% lang="en-US" style="text-align:left" %) 614 614 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 615 615 616 616 (% lang="en-US" style="text-align:left" %) ... ... @@ -617,8 +617,10 @@ 617 617 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 618 618 619 619 (% lang="en-US" style="text-align:left" %) 620 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 621 - "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": "" , ~/~/ идентификатор пользователя 622 622 "lastName": "" , ~/~/ фамилия 623 623 "firstName": "" , ~/~/ имя 624 624 "position": "" , ~/~/ должность ... ... @@ -639,8 +639,10 @@ 639 639 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 640 640 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 641 641 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 642 -} 643 643 645 +(% lang="en-US" style="text-align:left" %) 646 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 647 + 644 644 == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) == 645 645 646 646 (% class="box warningmessage" %) ... ... @@ -660,10 +660,12 @@ 660 660 661 661 (% style="color:#000000" %)Параметры в теле запроса (JSON): 662 662 663 -(% style="color:#000000" %){(%%) 667 +(% style="color:#000000" %){ 668 + 664 664 "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 665 665 "description": "" , ~/~/ описание 666 666 "data": "" , ~/~/ данные, связанные со сменой статуса 672 + 667 667 (% style="color:#000000" %)} 668 668 669 669 (% style="text-align:left" %) ... ... @@ -685,7 +685,7 @@ 685 685 (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 686 686 687 687 [ 688 - "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 694 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 689 689 "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 690 690 ] 691 691 ... ... @@ -991,7 +991,7 @@ 991 991 992 992 Ответ: В случае успеха **Success 200** 993 993 994 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =1000 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 995 995 996 996 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 997 997 ... ... @@ -1027,15 +1027,19 @@ 1027 1027 "deviceTypeName": "", ~/~/ Название типа устройства 1028 1028 "sim1": "", ~/~/ Номер SIM1 1029 1029 "sim2": "", ~/~/ Номер SIM2 1036 + 1030 1030 "parentId": "", ~/~/ ID клиента-родителя 1031 1031 "parentName": "", ~/~/ Наименование клиента-родителя 1032 1032 "modelId": "", ~/~/ ID модели объекта 1033 1033 "modelName": "", ~/~/ Имя модели объекта 1041 + 1034 1034 "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1035 1035 "unitName": "string", ~/~/ Наименование подразделения 1036 1036 "status": 0, ~/~/ Статус объекта 1045 + 1037 1037 "createdAt": "", ~/~/ Дата создания объекта 1038 1038 }, 1048 + 1039 1039 "customFields": [ ~/~/ Произвольные поля 1040 1040 { 1041 1041 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля ... ... @@ -1058,7 +1058,8 @@ 1058 1058 "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1059 1059 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1060 1060 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1061 - "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1071 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1072 + 1062 1062 "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания 1063 1063 "mileageCoeff": 0, ~/~/ коэффициент пробега 1064 1064 "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна ... ... @@ -1088,6 +1088,7 @@ 1088 1088 "retries": 0 ~/~/ Количество попыток 1089 1089 } 1090 1090 ], 1102 + 1091 1091 "sensors": [ ~/~/ Датчики 1092 1092 { 1093 1093 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика ... ... @@ -1128,19 +1128,31 @@ 1128 1128 }, 1129 1129 1130 1130 ~/~/ Характерные для произвольного: 1143 + 1131 1131 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1145 + 1132 1132 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1147 + 1133 1133 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1149 + 1134 1134 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1151 + 1135 1135 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1153 + 1136 1136 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1155 + 1137 1137 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1157 + 1138 1138 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1159 + 1139 1139 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1161 + 1140 1140 ~/~/ "ValueOn": "Вкл.", 1163 + 1141 1141 ~/~/ "ValueOff": "Выкл." 1142 1142 "summaryMaxValue": 0 ~/~/ Макс. значение 1143 1143 } 1167 + 1144 1144 "drivers": [ ~/~/ Водители 1145 1145 { 1146 1146 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1149,6 +1149,7 @@ 1149 1149 "isDefault": true ~/~/ По умолчанию 1150 1150 } 1151 1151 ], 1176 + 1152 1152 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1153 1153 { 1154 1154 "id": "", ~/~/ ID задания ... ... @@ -1165,7 +1165,8 @@ 1165 1165 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1166 1166 } 1167 1167 ], 1168 -"statusHistory": [ ~/~/ История статусов 1193 + 1194 + "statusHistory": [ ~/~/ История статусов 1169 1169 { 1170 1170 "status": 0, 1171 1171 "date": "2023-05-22T09:57:39.562Z", ... ... @@ -1173,6 +1173,7 @@ 1173 1173 "additionalInfo": "string" 1174 1174 } 1175 1175 ] 1202 + 1176 1176 } 1177 1177 ))) 1178 1178 ... ... @@ -1183,23 +1183,6 @@ 1183 1183 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1184 1184 1185 1185 1186 -== **Отправить команду на терминал** == 1187 - 1188 -(% class="box successmessage" %) 1189 -((( 1190 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1191 -))) 1192 - 1193 -Команда для отправки на тс. 1194 - 1195 -{ 1196 -"id": "", ~/~/идентификатор произвольного поля 1197 -"command": "", ~/~/ Текст команды 1198 -"retries": "", ~/~/ Количество попыток 1199 -"idTemplate": "" ~/~/ ID шаблона команды 1200 -} 1201 - 1202 - 1203 1203 == **Получить ответ на отправленную на ТС команду** == 1204 1204 1205 1205 (% class="box infomessage" %) ... ... @@ -1209,19 +1209,31 @@ 1209 1209 1210 1210 Идентификатор команды: cmdid 1211 1211 1222 + 1212 1212 Запрос от терминала на ответ команды 1213 1213 1225 + 1214 1214 Пример ответ от терминала: 1215 1215 1228 + 1216 1216 ID= "" ~/~/ идентификатор произвольного поля 1230 + 1217 1217 Soft="" ~/~/ версия софта 1232 + 1218 1218 GPS=4 ~/~/ тип трекера 1234 + 1219 1219 Time=11:05:43 28.06.24 ~/~/ время запроса 1236 + 1220 1220 Lat=45.056221 ~/~/ широта 1238 + 1221 1221 Lon=39.035938 ~/~/ долгота 1240 + 1222 1222 Speed=0.0 ~/~/ скорость 1242 + 1223 1223 Course=181.4 ~/~/направление 1224 1224 1245 + 1246 + 1225 1225 ((( 1226 1226 == **Список отправленных объекту команд с ответами** == 1227 1227 ... ... @@ -1232,21 +1232,36 @@ 1232 1232 1233 1233 Идентификатор ТС: vehicleId 1234 1234 1257 + 1235 1235 В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала. 1236 1236 1260 + 1237 1237 Пример ответа терминала 1238 1238 1239 -[ 1240 -{ 1241 -"id": "", ~/~/ идентификатор пользователя 1263 + 1264 +[ 1265 + 1266 +{ 1267 + 1268 +"id": "", ~/~/ идентификатор пользователя 1269 + 1242 1242 "commandText": "", ~/~/Текст команды. 1271 + 1243 1243 "templateId": "", ~/~/Идентификатор шаблона 1244 -"updated": "", ~/~/ Время отправки 1245 -"tryCount": 0, ~/~/ Количество попыток отправки команды 1273 + 1274 +"updated": "", ~/~/ Время отправки 1275 + 1276 +"tryCount": 0, ~/~/ Количество попыток отправки команды 1277 + 1246 1246 "answer": "", ~/~/ Ответ терминала. 1279 + 1247 1247 "status": "" ~/~/ Статус отправки 1281 + 1248 1248 } 1283 + 1249 1249 ] 1285 + 1286 + 1250 1250 ))) 1251 1251 1252 1252 == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) == ... ... @@ -1266,7 +1266,8 @@ 1266 1266 1267 1267 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1268 1268 1269 -(% style="color:#000000" %){(%%) 1306 +(% style="color:#000000" %){ 1307 + 1270 1270 "parentId": "" , ~/~/ ID клиента 1271 1271 "name": "" , ~/~/ имя ТС 1272 1272 "imei": "" , ~/~/ IMEI ... ... @@ -1287,6 +1287,7 @@ 1287 1287 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1288 1288 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1289 1289 "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1328 + 1290 1290 "mileageCalcMethod": 0, 1291 1291 "mileageCoeff": 0, 1292 1292 "locationByCellId": true, ... ... @@ -1319,6 +1319,7 @@ 1319 1319 "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано) 1320 1320 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1321 1321 } 1361 + 1322 1322 "drivers": [ ~/~/ Водители 1323 1323 { 1324 1324 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1333,7 +1333,8 @@ 1333 1333 "retries": 0 1334 1334 } 1335 1335 ], 1336 -"sensors": [ ~/~/ Датчики 1376 + 1377 + "sensors": [ ~/~/ Датчики 1337 1337 { 1338 1338 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1339 1339 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1371,43 +1371,41 @@ 1371 1371 "additionalProp2": "string", 1372 1372 "additionalProp3": "string" 1373 1373 }, 1415 + 1374 1374 ~/~/ Характерные для произвольного: 1417 + 1375 1375 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1419 + 1376 1376 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1421 + 1377 1377 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1423 + 1378 1378 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1425 + 1379 1379 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1427 + 1380 1380 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1429 + 1381 1381 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1431 + 1382 1382 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1433 + 1383 1383 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1435 + 1384 1384 ~/~/ "ValueOn": "Вкл.", 1385 -~/~/ "ValueOff": "Выкл." 1386 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1387 1387 1388 -((( 1389 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1390 - { 1391 - "from": 0, ~/~/ С какого значения 1392 - "color": "string", ~/~/ Каким цветом 1393 - "text": "string" ~/~/ Текст подписи к этому интервалу 1394 - } 1395 - ] 1438 +~/~/ "ValueOff": "Выкл." 1439 + "summaryMaxValue": 0 ~/~/ Макс. значение 1396 1396 } 1397 1397 ], 1398 -))) 1399 - 1400 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1401 - 1402 - 1403 1403 "customFields": [ ~/~/ Произвольные поля 1404 1404 { 1405 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1406 - "name": "string", ~/~/ Наименование произвольного поля1407 - "value": "string", ~/~/ Значение произвольного поля1408 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1409 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1410 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1444 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1445 + "name": "string", 1446 + "value": "string", 1447 + "forClient": true, 1448 + "forTooltip": true, 1449 + "forReport": true 1411 1411 } 1412 1412 ] 1413 1413 } ... ... @@ -1414,236 +1414,58 @@ 1414 1414 1415 1415 (% style="color:#000000" %)Ответ: 1416 1416 1456 +(% style="color:#000000" %){ 1417 1417 1418 -((( 1419 -((( 1420 -((( 1421 -{ 1422 - "vehicleId": 0, ~/~/ ID ТС 1423 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1424 - "name": "string", ~/~/ Имя объекта 1425 - "imei": "string", ~/~/ IMEI 1426 - "deviceTypeId": 0, ~/~/ ID типа устройства 1427 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1428 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1429 - "sim1": "string", ~/~/ SIM1 1430 - "sim2": "string", ~/~/ SIM2 1431 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1432 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1433 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1434 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1435 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1436 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1437 - "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1438 - "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1439 - "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1440 - "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1441 - "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1442 - "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1443 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1444 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1445 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1446 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1447 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1448 - "counters": { ~/~/ Dto для состояний счётчиков 1449 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1450 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1451 - "mileage": 0, ~/~/ Пробег 1452 - "motohours": 0 ~/~/ Моточасы 1453 - }, 1454 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1455 - "id": "string", ~/~/ CMSV6 Идентификатор 1456 - "enabled": true, ~/~/ Признак включения 1457 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1458 - "login": "string", ~/~/ CMSV6 имя учетной записи 1459 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1460 - }, 1461 - "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1462 - { 1463 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1464 - "enabled": true, ~/~/ Признак включения 1465 - "name": "string", ~/~/ Имя задания 1466 - "description": "string", ~/~/ Описание задания 1467 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1468 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1469 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1470 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1471 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1472 - "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1473 - "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1474 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 1458 + "vehicleId": "", ~/~/ID ТС 1459 + "parentId": "", ~/~/Guid владельца ТС 1460 + "name": "", ~/~/Имя объекта 1461 + "imei": "", ~/~/IMEI 1462 + "deviceTypeId": "", ~/~/ID типа устройства 1463 + "modelId": "", ~/~/ID модели 1464 + "unitId": "", ~/~/ID подразделения 1465 + "sim1": "", ~/~/SIM1 1466 + "sim2": "", ~/~/SIM2 1467 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км 1468 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу 1469 + "counters": { ~/~/Счётчики 1470 + "mileageEnabled": true, 1471 + "motohoursEnabled": true, 1472 + "mileage": "", 1473 + "motohours": 345.0 1474 + }, 1475 + "cmsv6Parameters": { ~/~/Параметры CmsV6 1476 + "id": null, 1477 + "enabled": true, ~/~/флаг включения 1478 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1479 + "login": "", ~/~/ имя учетной записи 1480 + "password": "" ~/~/ пароль учетной записи 1481 + }, 1482 + "inspectionTasks": { ~/~/ задания на ТО 1483 + "id": "", ~/~/ ID задачи 1484 + "enabled": false, ~/~/ Признак включения 1485 + "name": "", ~/~/ Имя задания 1486 + "description": "", ~/~/ Описание задания 1487 + "mileageCondition": "", ~/~/ Условие по пробегу 1488 + "lastMileage": "", ~/~/ Пробег (в метрах) 1489 + "motohoursCondition": "", ~/~/ Условие по моточасам 1490 + "lastMotohours": "", ~/~/ Моточасы 1491 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1492 + "kind": "", ~/~/ Вид периодичности по времени 1493 + "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1475 1475 } 1476 - ], 1477 - "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1478 - { 1479 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1480 - "inputNumber": 0, ~/~/ № входа. 1481 - "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1482 - "comment": "string", ~/~/ Комментарий 1483 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1484 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1485 - "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1486 - "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1487 - } 1488 - ], 1489 - "commandTemplates": [ ~/~/ Список шаблонов команд 1490 - { 1491 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1492 - "name": "string", ~/~/ Название шаблона команд 1493 - "command": "string", ~/~/ Команда на выполнение 1494 - "retries": 0 ~/~/ Лимит попыток отправки 1495 - } 1496 - ], 1497 - "sensors": [ ~/~/ Список датчиков 1498 - { 1499 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1500 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1501 - "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 1502 - "name": "string", ~/~/ Имя датчика 1503 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1504 - "inputNumber": 0, ~/~/ Номер входа 1505 - "pseudonym": "string", ~/~/ Псевдоним 1506 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1507 - "isInverted": true, ~/~/ Признак инверсии 1508 - "disabled": true, ~/~/ Датчик не участвует в обработке 1509 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1510 - "gradesTables": [ ~/~/ Тарировка 1511 - { 1512 - "grades": [ ~/~/ Таблицы тарировки 1513 - { 1514 - "input": 0, ~/~/ Вход 1515 - "output": 0 ~/~/ Выход 1516 - } 1517 - ], 1518 - "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1519 - } 1520 - ], 1521 - "showInTooltip": true, ~/~/ Отображение в подсказке 1522 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 1523 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1524 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1525 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1526 - "expr": "string", ~/~/ Выражение 1527 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1528 - "string" 1529 - ], 1530 - "customParams": { 1531 - "additionalProp1": "string", 1532 - "additionalProp2": "string", 1533 - "additionalProp3": "string" 1534 - }, 1535 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1536 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1537 - { 1538 - "from": 0, ~/~/ С какого значения 1539 - "color": "string", ~/~/ Каким цветом 1540 -))) 1541 1541 1542 -((( 1543 - "text": "string" ~/~/ Текст подписи к этому интервалу 1544 - } 1545 - ] 1546 - } 1547 - ], 1548 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1549 - "customFields": [ ~/~/ Список произвольных полей 1550 - { 1551 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1552 - "name": "string", ~/~/ Наименование произвольного поля 1553 - "value": "string", ~/~/ Значение произвольного поля 1554 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1555 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1556 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1557 - } 1558 - ], 1559 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1560 -} 1561 -))) 1562 -))) 1563 -))) 1496 +(% style="text-align:left" %) 1497 +(% style="color:#000000" %)} 1564 1564 1565 - 1566 1566 **Валидация:** 1567 1567 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1568 1568 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1569 1569 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1570 1570 1504 +== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) == 1571 1571 1572 -== **Импортировать историю ТС (Асинхронный запрос)** == 1573 - 1574 -(% class="box successmessage" %) 1575 -((( 1576 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1577 -))) 1578 - 1579 -Метод запроса: **POST** 1580 - 1581 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1582 - 1583 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1584 - 1585 - 1586 -Ответ: 1587 - 1588 -{ 1589 - 1590 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1591 - 1592 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1593 - 1594 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1595 - 1596 - "Message": "string", ~/~/ Информация о выполнении запроса 1597 - 1598 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1599 - 1600 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1601 - 1602 - "Data": "string" ~/~/ Данные 1603 - 1604 -} 1605 - 1606 - 1607 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 1608 - 1609 1609 (% class="box infomessage" %) 1610 1610 ((( 1611 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1612 -))) 1613 - 1614 -Метод запроса: **GET** 1615 - 1616 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1617 - 1618 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1619 - 1620 - 1621 -Ответ: 1622 - 1623 -{ 1624 - 1625 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1626 - 1627 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 1628 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1629 - 1630 - "Message": "string", ~/~/ Информация о выполнении запроса 1631 - 1632 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1633 - 1634 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1635 - 1636 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1637 - 1638 - "Data": "string" ~/~/ Данные 1639 - 1640 -} 1641 - 1642 - 1643 -== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1644 - 1645 -(% class="box infomessage" %) 1646 -((( 1647 1647 (% lang="en-US" %)**POST /api/v3/vehicles/find** 1648 1648 ))) 1649 1649 ... ... @@ -1681,12 +1681,9 @@ 1681 1681 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1682 1682 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1683 1683 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1684 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1685 - "unitName": "string", ~/~/ Название подразделения (опционально) 1686 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1687 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1688 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1689 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1545 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1546 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1547 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1690 1690 } 1691 1691 1692 1692 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1693,14 +1693,8 @@ 1693 1693 1694 1694 (% style="color:#000000" %)Ответ: 1695 1695 1696 -(% style="color:#000000" %)[ 1697 -{ 1554 +(% style="color:#000000" %){ 1698 1698 1699 -((( 1700 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1701 -))) 1702 - 1703 -((( 1704 1704 (% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1705 1705 "name": "" ~/~/ наименование объекта 1706 1706 "imei": "" ~/~/ IMEI объекта ... ... @@ -1726,21 +1726,9 @@ 1726 1726 "forClient": true, ~/~/ право на отображение у клиента 1727 1727 "forTooltip": false, ~/~/ право на отображение в подсказке 1728 1728 "forReport": false ~/~/ право на отображение в отчетах 1729 -))) 1581 + }(%%) 1582 +(% style="color:#000000" %)} 1730 1730 1731 -((( 1732 - } 1733 - ], 1734 - "vehicleGroups": [ ~/~/ Группы ТС 1735 - { 1736 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1737 - "name": "string" ~/~/ Наименование группы ТС 1738 - } 1739 - ] 1740 - } 1741 -] 1742 -))) 1743 - 1744 1744 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1745 1745 1746 1746 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1772,11 +1772,13 @@ 1772 1772 "data": "", ~/~/ Данные 1773 1773 "overwrite": false, ~/~/ Флаг перезаписи 1774 1774 "stage": "", ~/~/ Состояние, может быть null 1615 + 1775 1775 (% style="color:#000000" %)} 1776 1776 1777 1777 (% style="color:#000000" %)Ответ: 1778 1778 1779 -(% style="color:#000000" %){(%%) 1620 +(% style="color:#000000" %){ 1621 + 1780 1780 "status": "", ~/~/ значение статуса 1781 1781 "date": "", ~/~/ Дата смены статуса 1782 1782 "description": "", ~/~/ Описание ... ... @@ -1783,10 +1783,34 @@ 1783 1783 "data": "", ~/~/ Данные 1784 1784 "overwrite": false, ~/~/ Флаг перезаписи 1785 1785 "stage": "", ~/~/ Состояние 1628 + 1629 +(% style="text-align:left" %) 1786 1786 (% style="color:#000000" %) } 1787 1787 1788 -== == 1632 +(% class="wikigeneratedid" id="H41843743C43543D43543D43843544144243044244344143043E43144A43543A442430" %) 1633 +**Отправить команду на терминал** 1789 1789 1635 +(% class="box successmessage" %) 1636 +((( 1637 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1638 +))) 1639 + 1640 +Команда для отправки на тс. 1641 + 1642 + 1643 +{ 1644 + 1645 +"id": "", ~/~/идентификатор произвольного поля 1646 + 1647 +"command": "", ~/~/ Текст команды 1648 + 1649 +"retries": "", ~/~/ Количество попыток 1650 + 1651 +"idTemplate": "" ~/~/ ID шаблона команды 1652 + 1653 +} 1654 + 1655 + 1790 1790 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1791 1791 1792 1792 (% class="box warningmessage" %) ... ... @@ -1874,7 +1874,8 @@ 1874 1874 "retries": 0 1875 1875 } 1876 1876 ], 1877 -"sensors": [ ~/~/ Датчики 1743 + 1744 + "sensors": [ ~/~/ Датчики 1878 1878 { 1879 1879 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1880 1880 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1912,215 +1912,95 @@ 1912 1912 "additionalProp2": "string", 1913 1913 "additionalProp3": "string" 1914 1914 }, 1782 + 1915 1915 ~/~/ Характерные для произвольного: 1784 + 1916 1916 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1786 + 1917 1917 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1788 + 1918 1918 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1790 + 1919 1919 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1792 + 1920 1920 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1794 + 1921 1921 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1796 + 1922 1922 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1798 + 1923 1923 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1800 + 1924 1924 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1802 + 1925 1925 ~/~/ "ValueOn": "Вкл.", 1804 + 1926 1926 ~/~/ "ValueOff": "Выкл." 1927 1927 "summaryMaxValue": 0 ~/~/ Макс. значение 1928 - 1929 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1930 - { 1931 - "from": 0, ~/~/ С какого значения 1932 - "color": "string", ~/~/ Каким цветом 1933 - "text": "string" ~/~/ Текст подписи к этому интервалу 1934 - } 1935 - ] 1936 1936 } 1937 1937 ], 1938 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1939 - 1940 1940 "customFields": [ ~/~/ Произвольные поля 1941 - { 1942 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1943 - "name": "string", ~/~/ Наименование произвольного поля1944 - "value": "string", ~/~/ Значение произвольного поля1945 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1946 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1947 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1810 + { 1811 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1812 + "name": "string", 1813 + "value": "string", 1814 + "forClient": true, 1815 + "forTooltip": true, 1816 + "forReport": true 1948 1948 } 1949 1949 ] 1950 1950 } 1951 1951 1952 - 1953 1953 (% style="color:#000000" %)Ответ: 1954 1954 1955 -((( 1956 -{ 1957 - "vehicleId": 0, ~/~/ ID ТС 1958 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1959 - "name": "string", ~/~/ Имя объекта 1960 - "imei": "string", ~/~/ IMEI 1961 - "deviceTypeId": 0, ~/~/ ID типа устройства 1962 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1963 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1964 - "sim1": "string", ~/~/ SIM1 1965 - "sim2": "string", ~/~/ SIM2 1966 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1967 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1968 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1969 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1970 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1971 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1972 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1973 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1974 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1975 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1976 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1977 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1978 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 1979 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1980 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1981 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1982 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1983 - "counters": { ~/~/ состояний счётчиков 1984 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1985 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1986 - "mileage": 0, ~/~/ Пробег 1987 - "motohours": 0 ~/~/ Моточасы 1988 - }, 1989 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1990 - "id": "string", ~/~/ CMSV6 Идентификатор 1991 - "enabled": true, ~/~/ Признак включения 1992 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1993 -))) 1823 +(% lang="en-US" style="text-align:left" %) 1824 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 1994 1994 1995 - 1996 -((( 1997 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1998 - "login": "string", ~/~/ CMSV6 имя учетной записи 1999 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 2000 - }, 2001 - "inspectionTasks": [ ~/~/ Задания на ТО 2002 - { 2003 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 2004 - "enabled": true, ~/~/ Признак включения 2005 - "name": "string", ~/~/ Имя задания 2006 - "description": "string", ~/~/ Описание задания 2007 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 2008 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 2009 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 2010 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 2011 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 2012 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 2013 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 2014 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 2015 - } 2016 - ], 2017 - "drivers": [ ~/~/ Список водителей 2018 - { 2019 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 2020 - "inputNumber": 0, ~/~/ № входа. 2021 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 2022 - "comment": "string", ~/~/ Комментарий. 2023 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 2024 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 2025 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 2026 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 2027 - } 2028 - ], 2029 - "commandTemplates": [ ~/~/ Список шаблонов команд 2030 - { 2031 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 2032 - "name": "string", ~/~/ Название шаблона команд 2033 - "command": "string", ~/~/ Команда на выполнение 2034 - "retries": 0 ~/~/ Лимит попыток отправки 2035 - } 2036 - ], 2037 - "sensors": [ ~/~/ Список датчиков 2038 - { 2039 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 2040 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 2041 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 2042 -))) 2043 - 2044 -((( 2045 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 2046 -))) 2047 - 2048 -((( 2049 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 2050 -))) 2051 - 2052 -((( 2053 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 2054 -))) 2055 - 2056 -((( 2057 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 2058 -))) 2059 - 2060 -((( 2061 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 2062 - "name": "string", ~/~/ Имя датчика 2063 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 2064 -))) 2065 - 2066 -((( 2067 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 2068 - "inputNumber": 0, ~/~/ Номер входа 2069 - "pseudonym": "string", ~/~/ Псевдоним 2070 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 2071 - "isInverted": true, ~/~/ Признак инверсии 2072 - "disabled": true, ~/~/ Датчик не участвует в обработке 2073 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 2074 - "gradesTables": [ ~/~/ Тарировка 1826 +(% lang="en-US" style="text-align:left" %) 1827 + "vehicleId": "", ~/~/ ID ТС 1828 + "parentId": "", ~/~/ ID клиента 1829 + "name": "", ~/~/ имя ТС 1830 + "imei": "", ~/~/ IMEI 1831 + "deviceTypeId": "", ~/~/ типа устройства 1832 + "modelId": "", ~/~/ ID модели 1833 + "unitId": "", ~/~/ ID подразделения 1834 + "sim1": "", ~/~/ SIM 1 1835 + "sim2": "", ~/~/ SIM2 1836 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 1837 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 1838 + "counters": 1839 + { 1840 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 1841 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 1842 + "mileage": "", ~/~/ пробег 1843 + "motohours": "", ~/~/ моточасы 1844 + } 1845 + "cmsv6Parameters": ~/~/ параметры CMSv6 2075 2075 { 2076 - "grades": [ ~/~/ Таблицы тарировки 2077 - { 2078 - "input": 0, ~/~/ Вход 2079 - "output": 0 ~/~/ Выход 2080 - } 2081 - ], 2082 - "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2083 - } 2084 - ], 2085 - "showInTooltip": true, ~/~/ Отображение в подсказке 2086 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 2087 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2088 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2089 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2090 - "expr": "string", ~/~/ Выражение 2091 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2092 - "string" 2093 - ], 2094 - "customParams": { ~/~/ Дополнительные настройки 2095 - "additionalProp1": "string", 2096 - "additionalProp2": "string", 2097 - "additionalProp3": "string" 2098 - }, 2099 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2100 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1847 + "id": ~/~/ идентификатор 1848 + "enabled": true, ~/~/ флаг включения 1849 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1850 + "login": "", ~/~/ имя учетной записи 1851 + "password": "", ~/~/ пароль учетной записи 1852 + } 1853 + "inspectionTasks": ~/~/ задания на ТО 2101 2101 { 2102 - "from": 0, ~/~/ С какого значения 2103 - "color": "string", ~/~/ Каким цветом 2104 - "text": "string" ~/~/ Текст подписи к этому интервалу 1855 + "id": "", ~/~/ ID задания 1856 + "enabled": false, ~/~/ Признак включения 1857 + "name": "", ~/~/ Имя задания 1858 + "description": "", ~/~/ Описание задания 1859 + "mileageCondition": "", ~/~/ Условие по пробегу 1860 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 1861 + "motohoursCondition": "", ~/~/ Условие по моточасам 1862 + "lastMotohours": "", ~/~/ Моточасы 1863 + "periodicCondition": "", ~/~/ Условие периодичности по времени 1864 + "kind": "", ~/~/ Вид периодичности по времени 1865 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 2105 2105 } 2106 - ] 2107 - } 2108 - ], 2109 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2110 - "customFields": [ ~/~/ Список произвольных полей 2111 - { 2112 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2113 - "name": "string", ~/~/ Наименование произвольного поля 2114 - "value": "string", ~/~/ Значение произвольного поля 2115 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2116 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2117 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 2118 - } 2119 - ], 2120 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2121 -} 2122 -))) 2123 2123 1868 +(% lang="en-US" style="text-align:left" %) 1869 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1870 + 2124 2124 **Валидация:** 2125 2125 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 2126 2126 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; ... ... @@ -2165,9 +2165,12 @@ 2165 2165 2166 2166 (% style="color:#000000" %)Ответ: 2167 2167 2168 -(% style="color:#000000" %){(%%) 1915 +(% style="color:#000000" %){ 1916 + 2169 2169 "deviceTypeId" : "", ~/~/ ID типа устройства 2170 2170 "deviceTypeName" : "" ~/~/ Название типа устройства 1919 + 1920 +(% style="text-align:left" %) 2171 2171 (% style="color:#000000" %)} 2172 2172 2173 2173 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = ... ... @@ -2189,10 +2189,13 @@ 2189 2189 2190 2190 (% style="color:#000000" %)Ответ: 2191 2191 2192 -(% style="color:#000000" %){(%%) 1942 +(% style="color:#000000" %){ 1943 + 2193 2193 "id": "", ~/~/ ID типа датчика 2194 2194 "name": "", ~/~/ Название 2195 2195 "description": "", ~/~/ Описание 1947 + 1948 +(% style="text-align:left" %) 2196 2196 (% style="color:#000000" %)} 2197 2197 2198 2198 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = ... ... @@ -2394,12 +2394,10 @@ 2394 2394 { 2395 2395 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2396 2396 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2397 - "mileage": 0, ~/~/ Пробег за период, километры 2398 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2399 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2400 - "motohours": 0, ~/~/ Моточасы за период, секунды 2401 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2402 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2150 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2151 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2152 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2153 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2403 2403 } 2404 2404 ] 2405 2405 } ... ... @@ -2448,12 +2448,6 @@ 2448 2448 } 2449 2449 ] 2450 2450 2451 -(% class="box warningmessage" %) 2452 -((( 2453 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2454 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2455 -))) 2456 - 2457 2457 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2458 2458 2459 2459 (% class="box infomessage" %) ... ... @@ -2517,42 +2517,74 @@ 2517 2517 Тело запроса: 2518 2518 2519 2519 { 2265 + 2520 2520 "vehicleIds": [ ], ~/~/ Список ID объектов 2267 + 2521 2521 "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2269 + 2522 2522 "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2271 + 2523 2523 "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2273 + 2524 2524 } 2525 2525 2526 2526 Ответ: 2527 2527 2528 -[ 2278 +[ 2279 + 2529 2529 { 2281 + 2530 2530 "vehicleId": 0, ~/~/ ID объекта 2283 + 2531 2531 "vehicleName": "string", ~/~/ Имя объекта 2285 + 2532 2532 "moves": [ ~/~/ Событие движения 2287 + 2533 2533 { 2289 + 2534 2534 "mileage": 0, ~/~/ Пробег, км 2291 + 2535 2535 "eventId": 0, ~/~/ Идентификатор события 2293 + 2536 2536 "eventName": "string", ~/~/ Название события 2295 + 2537 2537 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2297 + 2538 2538 "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2299 + 2539 2539 "duration": 0 ~/~/ Продолжительность события, секунд 2301 + 2540 2540 } 2303 + 2541 2541 ], 2305 + 2542 2542 "stops": [ ~/~/ События стоянок 2307 + 2543 2543 { 2544 - "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты 2309 + 2310 + "address": "string", ~/~/ Адрес события 2311 + 2545 2545 "eventId": 0, ~/~/ Идентификатор события 2313 + 2546 2546 "eventName": "string", ~/~/ Название события 2315 + 2547 2547 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2317 + 2548 2548 "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2319 + 2549 2549 "duration": 0 ~/~/ Продолжительность события, секунд 2321 + 2322 + 2550 2550 } 2324 + 2551 2551 ] 2326 + 2552 2552 } 2328 + 2553 2553 ] 2554 2554 2555 2555 2332 + 2556 2556 == (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) == 2557 2557 2558 2558 (% class="box infomessage" %) ... ... @@ -2589,6 +2589,7 @@ 2589 2589 } 2590 2590 2591 2591 2369 + 2592 2592 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2593 2593 2594 2594 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -2896,32 +2896,6 @@ 2896 2896 2897 2897 Success 2898 2898 2899 - 2900 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2901 - 2902 -(% class="box warningmessage" %) 2903 -((( 2904 -**PUT** /api/v3/notifications/prolongation 2905 -))) 2906 - 2907 -Метод позволяет продлить уведомления. 2908 - 2909 -Метод запроса **PUT** 2910 - 2911 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2912 - 2913 -В заголовках запроса: X-Auth: Токен авторизации. 2914 - 2915 -Тело запроса: 2916 - 2917 -[ 2918 - 2919 -0 2920 - 2921 -] 2922 - 2923 -где 0 идентификатор ids. 2924 - 2925 2925 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2926 2926 2927 2927 (% class="box errormessage" %) ... ... @@ -4112,7 +4112,7 @@ 4112 4112 **POST /api/v3/vehicles/import/{agentId}** 4113 4113 ))) 4114 4114 4115 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение*.xls)**или **wlp. **Также они могут находится в** zip-архиве(один файл - один архив).**3867 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 4116 4116 4117 4117 В пути указывается **agentId** - id клиента. 4118 4118 ... ... @@ -4124,7 +4124,7 @@ 4124 4124 4125 4125 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4126 4126 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 4127 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace- Замена,Merge- Слияние,Add- Добавление3879 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 4128 4128 4129 4129 В теле использовать тип **form-data,** тип значения** file** 4130 4130 ... ... @@ -4303,67 +4303,64 @@ 4303 4303 Тело запроса: 4304 4304 4305 4305 { 4306 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4307 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4308 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса4058 + "vehicleIds": [vehicleId], 4059 + "from": "2023-11-22T09:29:48.051Z", 4060 + "to": "2023-11-22T09:29:48.051Z" 4309 4309 } 4310 4310 4063 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4064 +|vehicleIds|Массив ID объектов 4065 +|from|Дата начала запроса 4066 +|to|Дата окончания запроса 4067 + 4311 4311 Ответ: 4312 4312 4313 4313 { 4314 - "items": [ ~/~/ Список в разрезе ТС4071 + "items": [ 4315 4315 { 4316 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4317 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4318 - "vehicleId": 0, ~/~/ ID ТС4319 - "vehicleName": "string", ~/~/ Название ТС4320 - "vehicleModel": "string", ~/~/ Модель ТС4321 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4322 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4323 - "totalViolations": 0, ~/~/ Нарушений всего4324 - "violationsByType": { ~/~/ Информация о нарушениях по типу4325 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4326 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4327 - "brakingViolations": 0, ~/~/ Нарушений торможения4328 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4329 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4330 - "sensorViolations": 0 ~/~/ Нарушений по датчику4073 + "from": "2023-11-22T09:29:48.052Z", 4074 + "to": "2023-11-22T09:29:48.052Z", 4075 + "vehicleId": 0, 4076 + "vehicleName": "string", 4077 + "vehicleModel": "string", 4078 + "penalty": 0, 4079 + "score": 0, 4080 + "totalViolations": 0, 4081 + "violationsByType": { 4082 + "overspeedingViolations": 0, 4083 + "accelerationViolations": 0, 4084 + "brakingViolations": 0, 4085 + "turningViolations": 0, 4086 + "dangerousDrivingViolations": 0, 4087 + "sensorViolations": 0 4331 4331 }, 4332 - 4333 -((( 4334 - 4335 -))) 4336 - 4337 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4338 - "mileage": 0, ~/~/ Пробег, м 4339 - "tripsCount": 0, ~/~/ Кол-во рейсов 4340 - "trips": [ ~/~/ Информация по рейсу 4089 + "moveTime": 0, 4090 + "mileage": 0, 4091 + "tripsCount": 0, 4092 + "trips": [ 4341 4341 { 4342 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4343 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4344 - "violationsCount": 0, ~/~/ Всего нарушений4345 - "violationsByType": { ~/~/ Информация о нарушениях по типу4346 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4347 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4348 - "brakingViolations": 0, ~/~/ Нарушений торможения4349 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4350 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4351 - "sensorViolations": 0 ~/~/ Нарушений по датчику4094 + "penalty": 0, 4095 + "score": 0, 4096 + "violationsCount": 0, 4097 + "violationsByType": { 4098 + "overspeedingViolations": 0, 4099 + "accelerationViolations": 0, 4100 + "brakingViolations": 0, 4101 + "turningViolations": 0, 4102 + "dangerousDrivingViolations": 0, 4103 + "sensorViolations": 0 4352 4352 }, 4353 - 4354 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4355 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4356 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4357 - "mileage": 0, ~/~/ Пробег, м 4358 - "motohours": 0, ~/~/ Моточасы, секунды 4359 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4360 - "startAddress": "string", ~/~/ Адрес начала рейса 4361 - "endAddress": "string", ~/~/ Адрес конца рейса 4362 - "drivers": [ ~/~/ Список водителей 4105 + "moveTime": 0, 4106 + "mileage": 0, 4107 + "motohours": 0, 4108 + "maxSpeed": 0, 4109 + "startAddress": "string", 4110 + "endAddress": "string", 4111 + "drivers": [ 4363 4363 { 4364 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4365 - "driverName": "string", ~/~/ФИО водителя4366 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки4113 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4114 + "driverName": "string", 4115 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4367 4367 } 4368 4368 ] 4369 4369 } ... ... @@ -4372,6 +4372,34 @@ 4372 4372 ] 4373 4373 } 4374 4374 4124 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4125 +|from|Дата начала запроса 4126 +|to|Дата окончания 4127 +|vehicleId|ID объекта 4128 +|vehicleName|Имя объекта 4129 +|vehicleModel|Модель объекта 4130 +|penalty|Сумма штрафных баллов 4131 +|score|Оценка 4132 +|totalViolations|Суммарное количество нарушений 4133 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа 4134 +|overspeedingViolations|Превышение скорости 4135 +|accelerationViolations|Ускорение 4136 +|brakingViolations|Торможение 4137 +|turningViolations|Резкий поворот 4138 +|dangerousDrivingViolations|Резкое вождение 4139 +|sensorViolations|Нарушение по датчику 4140 +|moveTime|Время в движении 4141 +|mileage|Пробег 4142 +|tripsCount|Количество рейсов 4143 +|motohours|Моточасы 4144 +|maxSpeed|Максимальная скорость 4145 +|startAddress|Адрес начала рейса 4146 +|endAddress|Адрес окончания рейса 4147 +|drivers|Список водителей, которые были на объекте в течениии рейса 4148 +|driverGuid|Guid водителя 4149 +|driverName|Имя водителя 4150 +|driverRfid|Номер Карты-метки 4151 + 4375 4375 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4376 4376 4377 4377 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == ... ... @@ -4391,38 +4391,60 @@ 4391 4391 Параметры в теле запроса (JSON): 4392 4392 4393 4393 { 4171 + 4394 4394 "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4173 + 4395 4395 "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4396 - "ids": [ 4175 + 4176 + "ids": [ 4177 + 4397 4397 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4179 + 4398 4398 ], 4181 + 4399 4399 "timezone": 0 ~/~/Таймзона 4183 + 4400 4400 } 4401 4401 4402 - 4403 4403 Ответ: 4187 + 4404 4404 { 4189 + 4405 4405 "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4191 + 4406 4406 "driver": "string", ~/~/Водители, привязанные к ТК 4193 + 4407 4407 "object": "string", ~/~/Наименование ТС 4195 + 4408 4408 "amount": 0, ~/~/Количество топлива 4197 + 4409 4409 "amountDut": 0, ~/~/Количество по ДУТ 4199 + 4410 4410 "amountDiff": 0, ~/~/Разница, л 4201 + 4411 4411 "amountDiffPerc": 0, ~/~/Разница, % 4203 + 4412 4412 "summa": 0, ~/~/Стоимость, руб 4205 + 4413 4413 "serviceName": "string", ~/~/Тип топлива 4207 + 4414 4414 "price": 0, ~/~/Цена за литр, руб 4209 + 4415 4415 "cardName": "string", ~/~/Наименование ТК 4211 + 4416 4416 "cardNum": "string", ~/~/Номер ТК 4213 + 4417 4417 "operator": "string", ~/~/Оператор ТК 4215 + 4418 4418 "address": "string" ~/~/Адрес АЗС 4217 + 4419 4419 } 4420 4420 4421 4421 4422 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4221 +==== (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** ==== 4423 4423 4424 4424 4425 -== **Получение полных данных о ретрансляторе** == 4224 +==== **Получение полных данных о ретрансляторе** ==== 4426 4426 4427 4427 (% class="box infomessage" %) 4428 4428 ((( ... ... @@ -4434,27 +4434,44 @@ 4434 4434 4435 4435 Пример ответа: 4436 4436 4437 -{ 4236 +{ 4237 + 4438 4438 "description": "", ~/~/ Определяет описание 4239 + 4439 4439 "subscriberId": "", ~/~/ Подписчик 4241 + 4440 4440 "protocolType": 0, ~/~/ Тип протокола 4243 + 4441 4441 "isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4245 + 4442 4442 "address": "string", ~/~/ Адрес события 4247 + 4443 4443 "objects": [ ~/~/Объекты для ретрансляции 4444 -{ 4445 -"id": "", ~/~/ Идентификатор объекта ретрансляции 4446 -"name": "", ~/~/ Наименование объекта ретрансляции 4447 -"imei": "", ~/~/ IMEI объекта 4249 + 4250 +{ 4251 + 4252 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4253 + 4254 +"name": "", ~/~/ Наименование объекта ретрансляции 4255 + 4256 +"imei": "", ~/~/ IMEI объекта 4257 + 4448 4448 "isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4259 + 4449 4449 } 4450 - ], 4451 -"id": "", ~/~/ идентификатор пользователя 4261 + 4262 + ], 4263 + 4264 +"id": "", ~/~/ идентификатор пользователя 4265 + 4452 4452 "parentId": "", ~/~/Guid родителя 4267 + 4453 4453 "deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4269 + 4454 4454 } 4455 4455 4456 4456 4457 -== **Удаление данных ретранслятора** == 4273 +==== **Удаление данных ретранслятора** ==== 4458 4458 4459 4459 (% class="box infomessage" %) 4460 4460 ((( ... ... @@ -4464,7 +4464,7 @@ 4464 4464 Параметр запроса: ID 4465 4465 4466 4466 4467 -== **Создание ретранслятора** == 4283 +==== **Создание ретранслятора** ==== 4468 4468 4469 4469 (% class="box infomessage" %) 4470 4470 ((( ... ... @@ -4473,45 +4473,77 @@ 4473 4473 4474 4474 Запрос: 4475 4475 4476 -{ 4292 + 4293 +{ 4294 + 4477 4477 "description": "", ~/~/ Описание 4296 + 4478 4478 "subscriberId": "", ~/~/ Подписчик 4298 + 4479 4479 "protocolType": 0, ~/~/ Тип протокола 4300 + 4480 4480 "address": "", ~/~/ Адрес ретрансляции 4302 + 4481 4481 "isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4304 + 4482 4482 "objects": [ ~/~/Объекты для ретрансляции 4483 -{ 4484 -"id": "", ~/~/ идентификатор пользователя 4306 + 4307 +{ 4308 + 4309 +"id": "", ~/~/ идентификатор пользователя 4310 + 4485 4485 "imei": "", ~/~/IMEI объекта 4486 -"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4312 + 4313 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4314 + 4487 4487 } 4316 + 4488 4488 ] 4318 + 4489 4489 } 4490 4490 4491 4491 4492 -Ответ: 4493 4493 4494 -{ 4323 +Ответ 4324 + 4325 +{ 4326 + 4495 4495 "description": "string", ~/~/ Определяет описание 4328 + 4496 4496 "subscriberId": "", ~/~/ идентификатор запроса 4330 + 4497 4497 "protocolType": 0, ~/~/ Тип протокола 4332 + 4498 4498 "isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4334 + 4499 4499 "address": "", ~/~/ Адрес события 4336 + 4500 4500 "objects": [ ~/~/Объекты для ретрансляции 4501 -{ 4502 -"id": "", ~/~/ идентификатор пользователя 4503 -"name": "string", ~/~/ Название уведомления 4504 -"imei": "string", ~/~/IMEI объекта 4505 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4338 + 4339 +{ 4340 + 4341 +"id": "", ~/~/ идентификатор пользователя 4342 + 4343 +"name": "string", ~/~/ Название уведомления 4344 + 4345 +"imei": "string", ~/~/IMEI объекта 4346 + 4347 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4348 + 4506 4506 } 4507 - ], 4508 -"id": "", ~/~/ идентификатор пользователя 4350 + 4351 + ], 4352 + 4353 +"id": "", ~/~/ идентификатор пользователя 4354 + 4509 4509 "parentId": "", ~/~/ Guid идентификатор родителя 4356 + 4510 4510 "deleted": true ~/~/ Признак удаления 4358 + 4511 4511 } 4512 4512 4513 4513 4514 -== **Редактирование ретранслятора** == 4362 +==== **Редактирование ретранслятора** ==== 4515 4515 4516 4516 (% class="box infomessage" %) 4517 4517 ((( ... ... @@ -4520,48 +4520,81 @@ 4520 4520 4521 4521 Пример запроса: 4522 4522 4523 -{ 4524 -"id": "", ~/~/ идентификатор пользователя 4371 +{ 4372 + 4373 +"id": "", ~/~/ идентификатор пользователя 4374 + 4525 4525 "description": "string", ~/~/ Определяет описание 4376 + 4526 4526 "subscriberId": "", ~/~/ идентификатор запроса 4378 + 4527 4527 "protocolType": 0, ~/~/ Тип протокола 4528 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4380 + 4381 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4382 + 4529 4529 "address": "string", ~/~/ Адрес события 4384 + 4530 4530 "objects": ~/~/Объекты для ретрансляции 4531 -[ 4532 -{ 4533 -"id": "", ~/~/ идентификатор пользователя 4386 + 4387 +[ 4388 + 4389 +{ 4390 + 4391 +"id": "", ~/~/ идентификатор пользователя 4392 + 4534 4534 "imei": "", ~/~/IMEI объекта 4535 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4394 + 4395 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4396 + 4536 4536 } 4398 + 4537 4537 ] 4400 + 4538 4538 } 4539 4539 4540 4540 4541 4541 Пример ответа: 4542 4542 4543 -{ 4406 +{ 4407 + 4544 4544 "description": "", ~/~/ Определяет описание 4409 + 4545 4545 "subscriberId": "", ~/~/ идентификатор запроса 4411 + 4546 4546 "protocolType": 0, ~/~/ Тип протокола 4547 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4413 + 4414 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4415 + 4548 4548 "address": "string", ~/~/ Адрес события 4417 + 4549 4549 "objects": [ ~/~/Объекты для ретрансляции 4550 -{ 4551 -"id": "", ~/~/ идентификатор пользователя 4552 -"name": "string", ~/~/ Название уведомления 4419 + 4420 +{ 4421 + 4422 +"id": "", ~/~/ идентификатор пользователя 4423 + 4424 +"name": "string", ~/~/ Название уведомления 4425 + 4553 4553 "imei": "", ~/~/IMEI объекта 4554 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4427 + 4428 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4429 + 4555 4555 } 4431 + 4556 4556 ], 4557 -"id": "", ~/~/ идентификатор пользователя 4433 + 4434 +"id": "", ~/~/ идентификатор пользователя 4435 + 4558 4558 "parentId": "", ~/~/ Guid идентификатор родителя 4437 + 4559 4559 "deleted": true ~/~/ Признак удаления 4439 + 4560 4560 } 4561 4561 4562 4562 4563 -== **Получение списка ретранслятора клиента** == 4564 4564 4444 +==== **Получение списка ретранслятора клиента** ==== 4445 + 4565 4565 (% class="box infomessage" %) 4566 4566 ((( 4567 4567 **POST /api/v3/retranslations/find** ... ... @@ -4569,32 +4569,53 @@ 4569 4569 4570 4570 Пример запроса: 4571 4571 4572 -{ 4573 -"id": "", ~/~/ идентификатор пользователя 4453 + 4454 +{ 4455 + 4456 +"id": "", ~/~/ идентификатор пользователя 4457 + 4574 4574 "search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4459 + 4575 4575 "parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4461 + 4576 4576 } 4577 4577 4578 -Ответ: 4579 4579 4580 -[ 4581 -{ 4465 + 4466 +Ответ 4467 + 4468 + 4469 +[ 4470 + 4471 +{ 4472 + 4582 4582 "description": "", ~/~/ Определяет описание 4474 + 4583 4583 "subscriberId": "", ~/~/ идентификатор запроса 4476 + 4584 4584 "protocolType": 0, ~/~/ Тип протокола 4585 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4478 + 4479 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4480 + 4586 4586 "address": "string", ~/~/ Адрес события 4587 -"id": "", ~/~/ идентификатор пользователя 4482 + 4483 +"id": "", ~/~/ идентификатор пользователя 4484 + 4588 4588 "parentId": "", ~/~/ Guid идентификатор родителя 4486 + 4589 4589 "deleted": true ~/~/ Признак удаления 4488 + 4590 4590 } 4490 + 4591 4591 ] 4592 4592 4593 4593 4594 -= (% style="color:#000000; font-size:18.6667px" %) **Раздел: Отчеты**(%%) =4494 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Отчеты**(%%) = 4595 4595 4596 -== **API для отчета по выгрузке комбайнов** == 4597 4597 4497 +==== **API для отчета по выгрузке комбайнов** ==== 4498 + 4499 + 4598 4598 (% class="box infomessage" %) 4599 4599 ((( 4600 4600 POST **/api/v3/Reports/harvesterUnloading** ... ... @@ -4602,70 +4602,134 @@ 4602 4602 4603 4603 Пример запроса: 4604 4604 4507 + 4605 4605 { 4509 + 4606 4606 "byTime": 0, ~/~/ Объединение событий по времени 4511 + 4607 4607 "byDist": 0, ~/~/ Объединение событий по расстоянию 4513 + 4608 4608 "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 4515 + 4609 4609 "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 4517 + 4610 4610 "showNearestObjects": true, ~/~/Показывать объекты рядом? 4519 + 4611 4611 "vehicleIds": [ ~/~/ Список id объектов для анализа 4521 + 4612 4612 0 4523 + 4613 4613 ], 4525 + 4614 4614 "from": "", ~/~/ Дата и время начало запроса 4527 + 4615 4615 "to": "", ~/~/ Дата и время окончания запроса 4529 + 4616 4616 "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 4531 + 4617 4617 } 4618 4618 4534 + 4535 + 4619 4619 Пример ответа: 4620 4620 4621 -[ 4538 + 4539 +[ 4540 + 4622 4622 { 4542 + 4623 4623 "harvesterName": "", ~/~/Комбайн, номер 4544 + 4624 4624 "harvesterId": 0, ~/~/Комбайн, id 4546 + 4625 4625 "harvesterModel": "", ~/~/ Модель комбайна 4626 -"hopperCapacity": 0, ~/~/ Объем бункера м3 4548 + 4549 + "hopperCapacity": 0, ~/~/ Объем бункера м3 4550 + 4627 4627 "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек 4552 + 4628 4628 "events": [ ~/~/Список событий в разрезе комбайна 4554 + 4629 4629 { 4556 + 4630 4630 "driverId": "", ~/~/Идентификатор водителя 4558 + 4631 4631 "driverName": "", ~/~/Водитель комбайна, ФИО 4560 + 4632 4632 "RFID": "", ~/~/ идентификатор карты-метки 4562 + 4633 4633 "rfidName": "", ~/~/Водитель комбайна, имя метки 4564 + 4634 4634 "vehicleId": 0, ~/~/идентификатор объекта 4566 + 4635 4635 "vehicleName": "string", ~/~/ Имя объекта 4568 + 4636 4636 "modelName": "string", ~/~/ Имя модели объекта 4570 + 4637 4637 "nearestVehicles": [ ~/~/Объекты рядом 4572 + 4638 4638 { 4574 + 4639 4639 "vehicleId": 0, ~/~/идентификатор объекта 4576 + 4640 4640 "vehicleName": "string" ~/~/ Имя объекта 4578 + 4641 4641 } 4580 + 4642 4642 ], 4582 + 4643 4643 "fields": [ ~/~/Поля, где происходила выгрузка 4584 + 4644 4644 { 4645 - "id": 0, ~/~/ идентификатор пользователя 4646 - "name": "string" ~/~/ имя пользователя 4586 + 4587 + "id": 0, ~/~/ идентификатор пользователя 4588 + 4589 + "name": "string" ~/~/ имя пользователя 4590 + 4647 4647 } 4592 + 4648 4648 ], 4594 + 4649 4649 "event": "string", ~/~/Событие 4596 + 4650 4650 "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода 4598 + 4651 4651 "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода 4600 + 4652 4652 "durationSeconds": 0, ~/~/Продолжительность события, в секундах 4602 + 4653 4653 "cultureName": "string", ~/~/ название культуры 4604 + 4654 4654 "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события) 4606 + 4655 4655 "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события) 4608 + 4656 4656 "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события) 4610 + 4657 4657 "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события) 4612 + 4658 4658 "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события) 4614 + 4659 4659 "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события) 4616 + 4660 4660 "issued": 0, ~/~/Выдано, бункеров 4618 + 4661 4661 "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера) 4620 + 4662 4662 "latitude": 0, ~/~/Широта 4622 + 4663 4663 "longitude": 0, ~/~/ Долгота 4624 + 4664 4664 "litresAway": 0, ~/~/Отдано, л 4626 + 4665 4665 "m3Away": 0 ~/~/Отдано, м3 4628 + 4666 4666 } 4630 + 4667 4667 ] 4632 + 4668 4668 } 4634 + 4669 4669 ] 4670 4670 4671 4671 ... ... @@ -4687,27 +4687,48 @@ 4687 4687 4688 4688 Ответ: 4689 4689 4690 -[ 4656 +[ 4657 + 4691 4691 { 4659 + 4692 4692 "recordTime": "", ~/~/Время записи 4661 + 4693 4693 "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4663 + 4694 4694 "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4665 + 4695 4695 "objectId": 0, ~/~/ID объекта, помещённого в корзину 4667 + 4696 4696 "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4669 + 4697 4697 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4671 + 4698 4698 "details": { ~/~/Список деталей объекта, помещённого в корзину 4699 - "items": [ ~/~/ 4673 + 4674 + "items": [ ~/~/ [ 4675 + 4700 4700 nullable: true ~/~/Детали 4677 + 4701 4701 { 4679 + 4702 4702 "name": "string", ~/~/наименование столбца 4681 + 4703 4703 "value": "string" ~/~/содержание столбца 4683 + 4704 4704 } 4685 + 4705 4705 ] 4687 + 4706 4706 }, 4707 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4689 + 4690 + "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4691 + 4708 4708 "string" 4693 + 4709 4709 ] 4695 + 4710 4710 } 4697 + 4711 4711 ] 4712 4712 4713 4713 ... ... @@ -4722,33 +4722,56 @@ 4722 4722 4723 4723 Пример запроса: 4724 4724 4712 + 4725 4725 [ 4726 -0 4714 + 4715 + 0 4716 + 4727 4727 ] 4728 - 4729 4729 4719 + 4730 4730 Пример ответа: 4731 4731 4732 -[ 4733 -{ 4722 +[ 4723 + 4724 + { 4725 + 4734 4734 "recordTime": "", ~/~/Время записи 4727 + 4735 4735 "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4729 + 4736 4736 "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4731 + 4737 4737 "objectId": 0, ~/~/ID объекта, помещённого в корзин 4733 + 4738 4738 "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4735 + 4739 4739 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4737 + 4740 4740 "details": { ~/~/Список деталей объекта, помещённого в корзину 4739 + 4741 4741 "items": [ ~/~/Детали 4741 + 4742 4742 { 4743 + 4743 4743 "name": "", ~/~/Имя свойства 4745 + 4744 4744 "value": "" ~/~/Значение свойства 4747 + 4745 4745 } 4749 + 4746 4746 ] 4751 + 4747 4747 }, 4753 + 4748 4748 "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4755 + 4749 4749 "" 4757 + 4750 4750 ] 4759 + 4751 4751 } 4761 + 4752 4752 ] 4753 4753 4754 4754 Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». ... ... @@ -4771,41 +4771,55 @@ 4771 4771 4772 4772 Пример запроса: 4773 4773 4774 -((( 4775 4775 [ 4776 -))) 4777 4777 4778 -((( 4779 4779 0 4780 -))) 4781 4781 4782 -((( 4783 4783 ] 4784 -))) 4785 4785 4786 4786 4787 4787 Пример ответа: 4788 4788 4789 4789 [ 4790 -{ 4794 + 4795 + { 4796 + 4791 4791 "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи 4798 + 4792 4792 "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину 4800 + 4793 4793 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину 4802 + 4794 4794 "objectId": 0, ~/~/ID объекта, помещённого в корзину 4804 + 4795 4795 "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину 4806 + 4796 4796 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4808 + 4797 4797 "details": { ~/~/Список деталей объекта, помещённого в корзину 4810 + 4798 4798 "items": [ ~/~/Детали 4812 + 4799 4799 { 4814 + 4800 4800 "name": "string", ~/~/Имя свойства 4816 + 4801 4801 "value": "string" ~/~/Значение свойства 4818 + 4802 4802 } 4820 + 4803 4803 ] 4822 + 4804 4804 }, 4824 + 4805 4805 "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4826 + 4806 4806 "string" 4828 + 4807 4807 ] 4830 + 4808 4808 } 4832 + 4809 4809 ] 4810 4810 4811 4811