Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/10/07 14:54
on 2024/10/07 14:54
edited by Андрей Калиновский
on 2024/07/19 14:24
on 2024/07/19 14:24
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -16,11 +16,6 @@ 16 16 17 17 (% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 18 18 19 - 20 -(% style="color:#000000; font-size:16px" %)**Рекомендации** 21 - 22 -- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 23 - 24 24 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 25 25 26 26 == (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == ... ... @@ -49,8 +49,12 @@ 49 49 50 50 (% lang="en-US" %) 51 51 (% style="color:#000000" %){ 52 - "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации 53 - "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" %) 54 54 } 55 55 56 56 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. ... ... @@ -230,6 +230,7 @@ 230 230 "bankKS": "string" ~/~/ корр. счёт 231 231 } 232 232 232 + 233 233 Ответ: 234 234 235 235 { ... ... @@ -423,6 +423,7 @@ 423 423 ], 424 424 "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 425 425 } 426 + 426 426 { 427 427 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 428 428 "lastName": "string", ... ... @@ -436,8 +436,12 @@ 436 436 437 437 (% style="text-align:left" %) 438 438 (% style="color:#000000; font-weight:normal" %)Ответ: 439 -{ 440 - "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 пользователя 441 441 "lastName": "" , ~/~/ Фамилия , 442 442 "firstName": "" , ~/~/ Имя 443 443 "position": "" , ~/~/ Должность ... ... @@ -454,9 +454,11 @@ 454 454 "kind": "" , ~/~/ тип аутентификации 455 455 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 456 456 "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя 457 -} 458 458 463 +(% style="text-align:left" %) 464 +(% style="color:#000000; font-weight:normal" %)} 459 459 466 + 460 460 == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) == 461 461 462 462 (% class="box infomessage" %) ... ... @@ -476,16 +476,19 @@ 476 476 477 477 (% style="color:#000000" %)Параметры в теле запроса (JSON): 478 478 479 -(% style="color:#000000" %){(%%) 486 +(% style="color:#000000" %){ 487 + 480 480 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента 481 481 "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно 482 482 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 483 483 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 492 + 484 484 (% style="color:#000000" %)} 485 485 486 486 (% style="color:#000000" %)Ответ: 487 487 488 488 (% style="color:#000000" %){ (%%) 498 + 489 489 "id": "" , ~/~/ идентификатор пользователя 490 490 "lastName": "" , ~/~/ фамилия 491 491 "firstName": "" , ~/~/ имя ... ... @@ -499,6 +499,7 @@ 499 499 "sessionDuration":"", ~/~/ длительность сессии в минутах 500 500 "status": "1", ~/~/ статус пользователя 501 501 "lastLogged": "", ~/~/ дата/время последней авторизации 512 + 502 502 (% style="color:#000000" %)} 503 503 504 504 == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) == ... ... @@ -572,8 +572,10 @@ 572 572 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 573 573 574 574 (% lang="en-US" style="text-align:left" %) 575 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 576 - "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 пользователя 577 577 "lastName": "" , ~/~/ фамилия 578 578 "firstName": "" , ~/~/ имя 579 579 "position": "" , ~/~/ должность ... ... @@ -595,7 +595,9 @@ 595 595 "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации 596 596 }, 597 597 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 598 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя(%%) 611 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 612 + 613 +(% lang="en-US" style="text-align:left" %) 599 599 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 600 600 601 601 (% lang="en-US" style="text-align:left" %) ... ... @@ -602,8 +602,10 @@ 602 602 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 603 603 604 604 (% lang="en-US" style="text-align:left" %) 605 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 606 - "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": "" , ~/~/ идентификатор пользователя 607 607 "lastName": "" , ~/~/ фамилия 608 608 "firstName": "" , ~/~/ имя 609 609 "position": "" , ~/~/ должность ... ... @@ -624,8 +624,10 @@ 624 624 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 625 625 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 626 626 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 627 -} 628 628 645 +(% lang="en-US" style="text-align:left" %) 646 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 647 + 629 629 == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) == 630 630 631 631 (% class="box warningmessage" %) ... ... @@ -645,10 +645,12 @@ 645 645 646 646 (% style="color:#000000" %)Параметры в теле запроса (JSON): 647 647 648 -(% style="color:#000000" %){(%%) 667 +(% style="color:#000000" %){ 668 + 649 649 "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 650 650 "description": "" , ~/~/ описание 651 651 "data": "" , ~/~/ данные, связанные со сменой статуса 672 + 652 652 (% style="color:#000000" %)} 653 653 654 654 (% style="text-align:left" %) ... ... @@ -670,7 +670,7 @@ 670 670 (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 671 671 672 672 [ 673 - "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 694 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 674 674 "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 675 675 ] 676 676 ... ... @@ -1012,15 +1012,19 @@ 1012 1012 "deviceTypeName": "", ~/~/ Название типа устройства 1013 1013 "sim1": "", ~/~/ Номер SIM1 1014 1014 "sim2": "", ~/~/ Номер SIM2 1036 + 1015 1015 "parentId": "", ~/~/ ID клиента-родителя 1016 1016 "parentName": "", ~/~/ Наименование клиента-родителя 1017 1017 "modelId": "", ~/~/ ID модели объекта 1018 1018 "modelName": "", ~/~/ Имя модели объекта 1041 + 1019 1019 "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1020 1020 "unitName": "string", ~/~/ Наименование подразделения 1021 1021 "status": 0, ~/~/ Статус объекта 1045 + 1022 1022 "createdAt": "", ~/~/ Дата создания объекта 1023 1023 }, 1048 + 1024 1024 "customFields": [ ~/~/ Произвольные поля 1025 1025 { 1026 1026 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля ... ... @@ -1043,7 +1043,8 @@ 1043 1043 "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1044 1044 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1045 1045 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1046 - "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1071 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1072 + 1047 1047 "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания 1048 1048 "mileageCoeff": 0, ~/~/ коэффициент пробега 1049 1049 "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна ... ... @@ -1073,6 +1073,7 @@ 1073 1073 "retries": 0 ~/~/ Количество попыток 1074 1074 } 1075 1075 ], 1102 + 1076 1076 "sensors": [ ~/~/ Датчики 1077 1077 { 1078 1078 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика ... ... @@ -1113,19 +1113,31 @@ 1113 1113 }, 1114 1114 1115 1115 ~/~/ Характерные для произвольного: 1143 + 1116 1116 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1145 + 1117 1117 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1147 + 1118 1118 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1149 + 1119 1119 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1151 + 1120 1120 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1153 + 1121 1121 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1155 + 1122 1122 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1157 + 1123 1123 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1159 + 1124 1124 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1161 + 1125 1125 ~/~/ "ValueOn": "Вкл.", 1163 + 1126 1126 ~/~/ "ValueOff": "Выкл." 1127 1127 "summaryMaxValue": 0 ~/~/ Макс. значение 1128 1128 } 1167 + 1129 1129 "drivers": [ ~/~/ Водители 1130 1130 { 1131 1131 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1134,6 +1134,7 @@ 1134 1134 "isDefault": true ~/~/ По умолчанию 1135 1135 } 1136 1136 ], 1176 + 1137 1137 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1138 1138 { 1139 1139 "id": "", ~/~/ ID задания ... ... @@ -1150,7 +1150,8 @@ 1150 1150 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1151 1151 } 1152 1152 ], 1153 -"statusHistory": [ ~/~/ История статусов 1193 + 1194 + "statusHistory": [ ~/~/ История статусов 1154 1154 { 1155 1155 "status": 0, 1156 1156 "date": "2023-05-22T09:57:39.562Z", ... ... @@ -1158,6 +1158,7 @@ 1158 1158 "additionalInfo": "string" 1159 1159 } 1160 1160 ] 1202 + 1161 1161 } 1162 1162 ))) 1163 1163 ... ... @@ -1167,24 +1167,8 @@ 1167 1167 (% style="text-align:left" %) 1168 1168 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1169 1169 1212 +===== ===== 1170 1170 1171 -== **Отправить команду на терминал** == 1172 - 1173 -(% class="box successmessage" %) 1174 -((( 1175 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1176 -))) 1177 - 1178 -Команда для отправки на тс. 1179 - 1180 -{ 1181 -"id": "", ~/~/идентификатор произвольного поля 1182 -"command": "", ~/~/ Текст команды 1183 -"retries": "", ~/~/ Количество попыток 1184 -"idTemplate": "" ~/~/ ID шаблона команды 1185 -} 1186 - 1187 - 1188 1188 == **Получить ответ на отправленную на ТС команду** == 1189 1189 1190 1190 (% class="box infomessage" %) ... ... @@ -1194,19 +1194,31 @@ 1194 1194 1195 1195 Идентификатор команды: cmdid 1196 1196 1223 + 1197 1197 Запрос от терминала на ответ команды 1198 1198 1226 + 1199 1199 Пример ответ от терминала: 1200 1200 1229 + 1201 1201 ID= "" ~/~/ идентификатор произвольного поля 1231 + 1202 1202 Soft="" ~/~/ версия софта 1233 + 1203 1203 GPS=4 ~/~/ тип трекера 1235 + 1204 1204 Time=11:05:43 28.06.24 ~/~/ время запроса 1237 + 1205 1205 Lat=45.056221 ~/~/ широта 1239 + 1206 1206 Lon=39.035938 ~/~/ долгота 1241 + 1207 1207 Speed=0.0 ~/~/ скорость 1243 + 1208 1208 Course=181.4 ~/~/направление 1209 1209 1246 + 1247 + 1210 1210 ((( 1211 1211 == **Список отправленных объекту команд с ответами** == 1212 1212 ... ... @@ -1217,21 +1217,36 @@ 1217 1217 1218 1218 Идентификатор ТС: vehicleId 1219 1219 1258 + 1220 1220 В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала. 1221 1221 1261 + 1222 1222 Пример ответа терминала 1223 1223 1224 -[ 1225 -{ 1226 -"id": "", ~/~/ идентификатор пользователя 1264 + 1265 +[ 1266 + 1267 +{ 1268 + 1269 +"id": "", ~/~/ идентификатор пользователя 1270 + 1227 1227 "commandText": "", ~/~/Текст команды. 1272 + 1228 1228 "templateId": "", ~/~/Идентификатор шаблона 1229 -"updated": "", ~/~/ Время отправки 1230 -"tryCount": 0, ~/~/ Количество попыток отправки команды 1274 + 1275 +"updated": "", ~/~/ Время отправки 1276 + 1277 +"tryCount": 0, ~/~/ Количество попыток отправки команды 1278 + 1231 1231 "answer": "", ~/~/ Ответ терминала. 1280 + 1232 1232 "status": "" ~/~/ Статус отправки 1282 + 1233 1233 } 1284 + 1234 1234 ] 1286 + 1287 + 1235 1235 ))) 1236 1236 1237 1237 == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) == ... ... @@ -1251,7 +1251,8 @@ 1251 1251 1252 1252 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1253 1253 1254 -(% style="color:#000000" %){(%%) 1307 +(% style="color:#000000" %){ 1308 + 1255 1255 "parentId": "" , ~/~/ ID клиента 1256 1256 "name": "" , ~/~/ имя ТС 1257 1257 "imei": "" , ~/~/ IMEI ... ... @@ -1272,6 +1272,7 @@ 1272 1272 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1273 1273 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1274 1274 "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1329 + 1275 1275 "mileageCalcMethod": 0, 1276 1276 "mileageCoeff": 0, 1277 1277 "locationByCellId": true, ... ... @@ -1304,6 +1304,7 @@ 1304 1304 "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано) 1305 1305 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1306 1306 } 1362 + 1307 1307 "drivers": [ ~/~/ Водители 1308 1308 { 1309 1309 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1318,7 +1318,8 @@ 1318 1318 "retries": 0 1319 1319 } 1320 1320 ], 1321 -"sensors": [ ~/~/ Датчики 1377 + 1378 + "sensors": [ ~/~/ Датчики 1322 1322 { 1323 1323 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1324 1324 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1356,17 +1356,29 @@ 1356 1356 "additionalProp2": "string", 1357 1357 "additionalProp3": "string" 1358 1358 }, 1416 + 1359 1359 ~/~/ Характерные для произвольного: 1418 + 1360 1360 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1420 + 1361 1361 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1422 + 1362 1362 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1424 + 1363 1363 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1426 + 1364 1364 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1428 + 1365 1365 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1430 + 1366 1366 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1432 + 1367 1367 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1434 + 1368 1368 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1436 + 1369 1369 ~/~/ "ValueOn": "Вкл.", 1438 + 1370 1370 ~/~/ "ValueOff": "Выкл." 1371 1371 "summaryMaxValue": 0 ~/~/ Макс. значение 1372 1372 } ... ... @@ -1385,7 +1385,8 @@ 1385 1385 1386 1386 (% style="color:#000000" %)Ответ: 1387 1387 1388 -(% style="color:#000000" %){(%%) 1457 +(% style="color:#000000" %){ 1458 + 1389 1389 "vehicleId": "", ~/~/ID ТС 1390 1390 "parentId": "", ~/~/Guid владельца ТС 1391 1391 "name": "", ~/~/Имя объекта ... ... @@ -1423,6 +1423,8 @@ 1423 1423 "kind": "", ~/~/ Вид периодичности по времени 1424 1424 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1425 1425 } 1496 + 1497 +(% style="text-align:left" %) 1426 1426 (% style="color:#000000" %)} 1427 1427 1428 1428 **Валидация:** ... ... @@ -1481,7 +1481,8 @@ 1481 1481 (% style="color:#000000" %)Ответ: 1482 1482 1483 1483 (% style="color:#000000" %){ 1484 - "vehicleId": "" ~/~/ идентификатор объекта 1556 + 1557 +(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1485 1485 "name": "" ~/~/ наименование объекта 1486 1486 "imei": "" ~/~/ IMEI объекта 1487 1487 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1540,11 +1540,13 @@ 1540 1540 "data": "", ~/~/ Данные 1541 1541 "overwrite": false, ~/~/ Флаг перезаписи 1542 1542 "stage": "", ~/~/ Состояние, может быть null 1616 + 1543 1543 (% style="color:#000000" %)} 1544 1544 1545 1545 (% style="color:#000000" %)Ответ: 1546 1546 1547 -(% style="color:#000000" %){(%%) 1621 +(% style="color:#000000" %){ 1622 + 1548 1548 "status": "", ~/~/ значение статуса 1549 1549 "date": "", ~/~/ Дата смены статуса 1550 1550 "description": "", ~/~/ Описание ... ... @@ -1551,10 +1551,34 @@ 1551 1551 "data": "", ~/~/ Данные 1552 1552 "overwrite": false, ~/~/ Флаг перезаписи 1553 1553 "stage": "", ~/~/ Состояние 1629 + 1630 +(% style="text-align:left" %) 1554 1554 (% style="color:#000000" %) } 1555 1555 1556 -== == 1633 +(% class="wikigeneratedid" id="H41843743C43543D43543D43843544144243044244344143043E43144A43543A442430" %) 1634 +**Отправить команду на терминал** 1557 1557 1636 +(% class="box successmessage" %) 1637 +((( 1638 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1639 +))) 1640 + 1641 +Команда для отправки на тс. 1642 + 1643 + 1644 +{ 1645 + 1646 +"id": "", ~/~/идентификатор произвольного поля 1647 + 1648 +"command": "", ~/~/ Текст команды 1649 + 1650 +"retries": "", ~/~/ Количество попыток 1651 + 1652 +"idTemplate": "" ~/~/ ID шаблона команды 1653 + 1654 +} 1655 + 1656 + 1558 1558 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1559 1559 1560 1560 (% class="box warningmessage" %) ... ... @@ -1642,7 +1642,8 @@ 1642 1642 "retries": 0 1643 1643 } 1644 1644 ], 1645 -"sensors": [ ~/~/ Датчики 1744 + 1745 + "sensors": [ ~/~/ Датчики 1646 1646 { 1647 1647 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1648 1648 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1680,17 +1680,29 @@ 1680 1680 "additionalProp2": "string", 1681 1681 "additionalProp3": "string" 1682 1682 }, 1783 + 1683 1683 ~/~/ Характерные для произвольного: 1785 + 1684 1684 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1787 + 1685 1685 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1789 + 1686 1686 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1791 + 1687 1687 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1793 + 1688 1688 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1795 + 1689 1689 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1797 + 1690 1690 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1799 + 1691 1691 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1801 + 1692 1692 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1803 + 1693 1693 ~/~/ "ValueOn": "Вкл.", 1805 + 1694 1694 ~/~/ "ValueOff": "Выкл." 1695 1695 "summaryMaxValue": 0 ~/~/ Макс. значение 1696 1696 } ... ... @@ -1710,7 +1710,9 @@ 1710 1710 (% style="color:#000000" %)Ответ: 1711 1711 1712 1712 (% lang="en-US" style="text-align:left" %) 1713 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1825 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 1826 + 1827 +(% lang="en-US" style="text-align:left" %) 1714 1714 "vehicleId": "", ~/~/ ID ТС 1715 1715 "parentId": "", ~/~/ ID клиента 1716 1716 "name": "", ~/~/ имя ТС ... ... @@ -1751,6 +1751,8 @@ 1751 1751 "kind": "", ~/~/ Вид периодичности по времени 1752 1752 "maxQuantity": "", ~/~/ Сколько раз выполнить задание 1753 1753 } 1868 + 1869 +(% lang="en-US" style="text-align:left" %) 1754 1754 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1755 1755 1756 1756 **Валидация:** ... ... @@ -1797,9 +1797,12 @@ 1797 1797 1798 1798 (% style="color:#000000" %)Ответ: 1799 1799 1800 -(% style="color:#000000" %){(%%) 1916 +(% style="color:#000000" %){ 1917 + 1801 1801 "deviceTypeId" : "", ~/~/ ID типа устройства 1802 1802 "deviceTypeName" : "" ~/~/ Название типа устройства 1920 + 1921 +(% style="text-align:left" %) 1803 1803 (% style="color:#000000" %)} 1804 1804 1805 1805 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = ... ... @@ -1821,10 +1821,13 @@ 1821 1821 1822 1822 (% style="color:#000000" %)Ответ: 1823 1823 1824 -(% style="color:#000000" %){(%%) 1943 +(% style="color:#000000" %){ 1944 + 1825 1825 "id": "", ~/~/ ID типа датчика 1826 1826 "name": "", ~/~/ Название 1827 1827 "description": "", ~/~/ Описание 1948 + 1949 +(% style="text-align:left" %) 1828 1828 (% style="color:#000000" %)} 1829 1829 1830 1830 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = ... ... @@ -2026,12 +2026,10 @@ 2026 2026 { 2027 2027 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2028 2028 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2029 - "mileage": 0, ~/~/ Пробег за период, километры 2030 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2031 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2032 - "motohours": 0, ~/~/ Моточасы за период, секунды 2033 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2034 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2151 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2152 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2153 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2154 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2035 2035 } 2036 2036 ] 2037 2037 } ... ... @@ -2143,42 +2143,74 @@ 2143 2143 Тело запроса: 2144 2144 2145 2145 { 2266 + 2146 2146 "vehicleIds": [ ], ~/~/ Список ID объектов 2268 + 2147 2147 "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2270 + 2148 2148 "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2272 + 2149 2149 "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2274 + 2150 2150 } 2151 2151 2152 2152 Ответ: 2153 2153 2154 -[ 2279 +[ 2280 + 2155 2155 { 2282 + 2156 2156 "vehicleId": 0, ~/~/ ID объекта 2284 + 2157 2157 "vehicleName": "string", ~/~/ Имя объекта 2286 + 2158 2158 "moves": [ ~/~/ Событие движения 2288 + 2159 2159 { 2290 + 2160 2160 "mileage": 0, ~/~/ Пробег, км 2292 + 2161 2161 "eventId": 0, ~/~/ Идентификатор события 2294 + 2162 2162 "eventName": "string", ~/~/ Название события 2296 + 2163 2163 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2298 + 2164 2164 "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2300 + 2165 2165 "duration": 0 ~/~/ Продолжительность события, секунд 2302 + 2166 2166 } 2304 + 2167 2167 ], 2306 + 2168 2168 "stops": [ ~/~/ События стоянок 2308 + 2169 2169 { 2310 + 2170 2170 "address": "string", ~/~/ Адрес события 2312 + 2171 2171 "eventId": 0, ~/~/ Идентификатор события 2314 + 2172 2172 "eventName": "string", ~/~/ Название события 2316 + 2173 2173 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2318 + 2174 2174 "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2320 + 2175 2175 "duration": 0 ~/~/ Продолжительность события, секунд 2322 + 2323 + 2176 2176 } 2325 + 2177 2177 ] 2327 + 2178 2178 } 2329 + 2179 2179 ] 2180 2180 2181 2181 2333 + 2182 2182 == (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) == 2183 2183 2184 2184 (% class="box infomessage" %) ... ... @@ -2215,6 +2215,7 @@ 2215 2215 } 2216 2216 2217 2217 2370 + 2218 2218 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2219 2219 2220 2220 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -2522,32 +2522,6 @@ 2522 2522 2523 2523 Success 2524 2524 2525 - 2526 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2527 - 2528 -(% class="box warningmessage" %) 2529 -((( 2530 -**PUT** /api/v3/notifications/prolongation 2531 -))) 2532 - 2533 -Метод позволяет продлить уведомления. 2534 - 2535 -Метод запроса **PUT** 2536 - 2537 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2538 - 2539 -В заголовках запроса: X-Auth: Токен авторизации. 2540 - 2541 -Тело запроса: 2542 - 2543 -[ 2544 - 2545 -0 2546 - 2547 -] 2548 - 2549 -где 0 идентификатор ids. 2550 - 2551 2551 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2552 2552 2553 2553 (% class="box errormessage" %) ... ... @@ -3738,7 +3738,7 @@ 3738 3738 **POST /api/v3/vehicles/import/{agentId}** 3739 3739 ))) 3740 3740 3741 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение*.xls)**или **wlp. **Также они могут находится в** zip-архиве(один файл - один архив).**3868 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 3742 3742 3743 3743 В пути указывается **agentId** - id клиента. 3744 3744 ... ... @@ -3750,7 +3750,7 @@ 3750 3750 3751 3751 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3752 3752 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3753 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace- Замена,Merge- Слияние,Add- Добавление3880 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 3754 3754 3755 3755 В теле использовать тип **form-data,** тип значения** file** 3756 3756 ... ... @@ -4012,7 +4012,7 @@ 4012 4012 |dangerousDrivingViolations|Резкое вождение 4013 4013 |sensorViolations|Нарушение по датчику 4014 4014 |moveTime|Время в движении 4015 -|mileage|Пробег (км)4142 +|mileage|Пробег 4016 4016 |tripsCount|Количество рейсов 4017 4017 |motohours|Моточасы 4018 4018 |maxSpeed|Максимальная скорость ... ... @@ -4042,38 +4042,60 @@ 4042 4042 Параметры в теле запроса (JSON): 4043 4043 4044 4044 { 4172 + 4045 4045 "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4174 + 4046 4046 "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4047 - "ids": [ 4176 + 4177 + "ids": [ 4178 + 4048 4048 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4180 + 4049 4049 ], 4182 + 4050 4050 "timezone": 0 ~/~/Таймзона 4184 + 4051 4051 } 4052 4052 4053 - 4054 4054 Ответ: 4188 + 4055 4055 { 4190 + 4056 4056 "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4192 + 4057 4057 "driver": "string", ~/~/Водители, привязанные к ТК 4194 + 4058 4058 "object": "string", ~/~/Наименование ТС 4196 + 4059 4059 "amount": 0, ~/~/Количество топлива 4198 + 4060 4060 "amountDut": 0, ~/~/Количество по ДУТ 4200 + 4061 4061 "amountDiff": 0, ~/~/Разница, л 4202 + 4062 4062 "amountDiffPerc": 0, ~/~/Разница, % 4204 + 4063 4063 "summa": 0, ~/~/Стоимость, руб 4206 + 4064 4064 "serviceName": "string", ~/~/Тип топлива 4208 + 4065 4065 "price": 0, ~/~/Цена за литр, руб 4210 + 4066 4066 "cardName": "string", ~/~/Наименование ТК 4212 + 4067 4067 "cardNum": "string", ~/~/Номер ТК 4214 + 4068 4068 "operator": "string", ~/~/Оператор ТК 4216 + 4069 4069 "address": "string" ~/~/Адрес АЗС 4218 + 4070 4070 } 4071 4071 4072 4072 4073 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4222 +==== (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** ==== 4074 4074 4075 4075 4076 -== **Получение полных данных о ретрансляторе** == 4225 +==== **Получение полных данных о ретрансляторе** ==== 4077 4077 4078 4078 (% class="box infomessage" %) 4079 4079 ((( ... ... @@ -4085,27 +4085,44 @@ 4085 4085 4086 4086 Пример ответа: 4087 4087 4088 -{ 4237 +{ 4238 + 4089 4089 "description": "", ~/~/ Определяет описание 4240 + 4090 4090 "subscriberId": "", ~/~/ Подписчик 4242 + 4091 4091 "protocolType": 0, ~/~/ Тип протокола 4244 + 4092 4092 "isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4246 + 4093 4093 "address": "string", ~/~/ Адрес события 4248 + 4094 4094 "objects": [ ~/~/Объекты для ретрансляции 4095 -{ 4096 -"id": "", ~/~/ Идентификатор объекта ретрансляции 4097 -"name": "", ~/~/ Наименование объекта ретрансляции 4098 -"imei": "", ~/~/ IMEI объекта 4250 + 4251 +{ 4252 + 4253 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4254 + 4255 +"name": "", ~/~/ Наименование объекта ретрансляции 4256 + 4257 +"imei": "", ~/~/ IMEI объекта 4258 + 4099 4099 "isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4260 + 4100 4100 } 4101 - ], 4102 -"id": "", ~/~/ идентификатор пользователя 4262 + 4263 + ], 4264 + 4265 +"id": "", ~/~/ идентификатор пользователя 4266 + 4103 4103 "parentId": "", ~/~/Guid родителя 4268 + 4104 4104 "deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4270 + 4105 4105 } 4106 4106 4107 4107 4108 -== **Удаление данных ретранслятора** == 4274 +==== **Удаление данных ретранслятора** ==== 4109 4109 4110 4110 (% class="box infomessage" %) 4111 4111 ((( ... ... @@ -4115,7 +4115,7 @@ 4115 4115 Параметр запроса: ID 4116 4116 4117 4117 4118 -== **Создание ретранслятора** == 4284 +==== **Создание ретранслятора** ==== 4119 4119 4120 4120 (% class="box infomessage" %) 4121 4121 ((( ... ... @@ -4124,45 +4124,77 @@ 4124 4124 4125 4125 Запрос: 4126 4126 4127 -{ 4293 + 4294 +{ 4295 + 4128 4128 "description": "", ~/~/ Описание 4297 + 4129 4129 "subscriberId": "", ~/~/ Подписчик 4299 + 4130 4130 "protocolType": 0, ~/~/ Тип протокола 4301 + 4131 4131 "address": "", ~/~/ Адрес ретрансляции 4303 + 4132 4132 "isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4305 + 4133 4133 "objects": [ ~/~/Объекты для ретрансляции 4134 -{ 4135 -"id": "", ~/~/ идентификатор пользователя 4307 + 4308 +{ 4309 + 4310 +"id": "", ~/~/ идентификатор пользователя 4311 + 4136 4136 "imei": "", ~/~/IMEI объекта 4137 -"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4313 + 4314 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4315 + 4138 4138 } 4317 + 4139 4139 ] 4319 + 4140 4140 } 4141 4141 4142 4142 4143 -Ответ: 4144 4144 4145 -{ 4324 +Ответ 4325 + 4326 +{ 4327 + 4146 4146 "description": "string", ~/~/ Определяет описание 4329 + 4147 4147 "subscriberId": "", ~/~/ идентификатор запроса 4331 + 4148 4148 "protocolType": 0, ~/~/ Тип протокола 4333 + 4149 4149 "isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4335 + 4150 4150 "address": "", ~/~/ Адрес события 4337 + 4151 4151 "objects": [ ~/~/Объекты для ретрансляции 4152 -{ 4153 -"id": "", ~/~/ идентификатор пользователя 4154 -"name": "string", ~/~/ Название уведомления 4155 -"imei": "string", ~/~/IMEI объекта 4156 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4339 + 4340 +{ 4341 + 4342 +"id": "", ~/~/ идентификатор пользователя 4343 + 4344 +"name": "string", ~/~/ Название уведомления 4345 + 4346 +"imei": "string", ~/~/IMEI объекта 4347 + 4348 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4349 + 4157 4157 } 4158 - ], 4159 -"id": "", ~/~/ идентификатор пользователя 4351 + 4352 + ], 4353 + 4354 +"id": "", ~/~/ идентификатор пользователя 4355 + 4160 4160 "parentId": "", ~/~/ Guid идентификатор родителя 4357 + 4161 4161 "deleted": true ~/~/ Признак удаления 4359 + 4162 4162 } 4163 4163 4164 4164 4165 -== **Редактирование ретранслятора** == 4363 +==== **Редактирование ретранслятора** ==== 4166 4166 4167 4167 (% class="box infomessage" %) 4168 4168 ((( ... ... @@ -4171,48 +4171,81 @@ 4171 4171 4172 4172 Пример запроса: 4173 4173 4174 -{ 4175 -"id": "", ~/~/ идентификатор пользователя 4372 +{ 4373 + 4374 +"id": "", ~/~/ идентификатор пользователя 4375 + 4176 4176 "description": "string", ~/~/ Определяет описание 4377 + 4177 4177 "subscriberId": "", ~/~/ идентификатор запроса 4379 + 4178 4178 "protocolType": 0, ~/~/ Тип протокола 4179 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4381 + 4382 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4383 + 4180 4180 "address": "string", ~/~/ Адрес события 4385 + 4181 4181 "objects": ~/~/Объекты для ретрансляции 4182 -[ 4183 -{ 4184 -"id": "", ~/~/ идентификатор пользователя 4387 + 4388 +[ 4389 + 4390 +{ 4391 + 4392 +"id": "", ~/~/ идентификатор пользователя 4393 + 4185 4185 "imei": "", ~/~/IMEI объекта 4186 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4395 + 4396 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4397 + 4187 4187 } 4399 + 4188 4188 ] 4401 + 4189 4189 } 4190 4190 4191 4191 4192 4192 Пример ответа: 4193 4193 4194 -{ 4407 +{ 4408 + 4195 4195 "description": "", ~/~/ Определяет описание 4410 + 4196 4196 "subscriberId": "", ~/~/ идентификатор запроса 4412 + 4197 4197 "protocolType": 0, ~/~/ Тип протокола 4198 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4414 + 4415 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4416 + 4199 4199 "address": "string", ~/~/ Адрес события 4418 + 4200 4200 "objects": [ ~/~/Объекты для ретрансляции 4201 -{ 4202 -"id": "", ~/~/ идентификатор пользователя 4203 -"name": "string", ~/~/ Название уведомления 4420 + 4421 +{ 4422 + 4423 +"id": "", ~/~/ идентификатор пользователя 4424 + 4425 +"name": "string", ~/~/ Название уведомления 4426 + 4204 4204 "imei": "", ~/~/IMEI объекта 4205 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4428 + 4429 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4430 + 4206 4206 } 4432 + 4207 4207 ], 4208 -"id": "", ~/~/ идентификатор пользователя 4434 + 4435 +"id": "", ~/~/ идентификатор пользователя 4436 + 4209 4209 "parentId": "", ~/~/ Guid идентификатор родителя 4438 + 4210 4210 "deleted": true ~/~/ Признак удаления 4440 + 4211 4211 } 4212 4212 4213 4213 4214 -== **Получение списка ретранслятора клиента** == 4215 4215 4445 +==== **Получение списка ретранслятора клиента** ==== 4446 + 4216 4216 (% class="box infomessage" %) 4217 4217 ((( 4218 4218 **POST /api/v3/retranslations/find** ... ... @@ -4220,32 +4220,53 @@ 4220 4220 4221 4221 Пример запроса: 4222 4222 4223 -{ 4224 -"id": "", ~/~/ идентификатор пользователя 4454 + 4455 +{ 4456 + 4457 +"id": "", ~/~/ идентификатор пользователя 4458 + 4225 4225 "search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4460 + 4226 4226 "parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4462 + 4227 4227 } 4228 4228 4229 -Ответ: 4230 4230 4231 -[ 4232 -{ 4466 + 4467 +Ответ 4468 + 4469 + 4470 +[ 4471 + 4472 +{ 4473 + 4233 4233 "description": "", ~/~/ Определяет описание 4475 + 4234 4234 "subscriberId": "", ~/~/ идентификатор запроса 4477 + 4235 4235 "protocolType": 0, ~/~/ Тип протокола 4236 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4479 + 4480 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4481 + 4237 4237 "address": "string", ~/~/ Адрес события 4238 -"id": "", ~/~/ идентификатор пользователя 4483 + 4484 +"id": "", ~/~/ идентификатор пользователя 4485 + 4239 4239 "parentId": "", ~/~/ Guid идентификатор родителя 4487 + 4240 4240 "deleted": true ~/~/ Признак удаления 4489 + 4241 4241 } 4491 + 4242 4242 ] 4243 4243 4244 4244 4245 -= (% style="color:#000000; font-size:18.6667px" %) **Раздел: Отчеты**(%%) =4495 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Отчеты**(%%) = 4246 4246 4247 -== **API для отчета по выгрузке комбайнов** == 4248 4248 4498 +==== **API для отчета по выгрузке комбайнов** ==== 4499 + 4500 + 4249 4249 (% class="box infomessage" %) 4250 4250 ((( 4251 4251 POST **/api/v3/Reports/harvesterUnloading** ... ... @@ -4253,70 +4253,134 @@ 4253 4253 4254 4254 Пример запроса: 4255 4255 4508 + 4256 4256 { 4510 + 4257 4257 "byTime": 0, ~/~/ Объединение событий по времени 4512 + 4258 4258 "byDist": 0, ~/~/ Объединение событий по расстоянию 4514 + 4259 4259 "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 4516 + 4260 4260 "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 4518 + 4261 4261 "showNearestObjects": true, ~/~/Показывать объекты рядом? 4520 + 4262 4262 "vehicleIds": [ ~/~/ Список id объектов для анализа 4522 + 4263 4263 0 4524 + 4264 4264 ], 4526 + 4265 4265 "from": "", ~/~/ Дата и время начало запроса 4528 + 4266 4266 "to": "", ~/~/ Дата и время окончания запроса 4530 + 4267 4267 "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 4532 + 4268 4268 } 4269 4269 4535 + 4536 + 4270 4270 Пример ответа: 4271 4271 4272 -[ 4539 + 4540 +[ 4541 + 4273 4273 { 4543 + 4274 4274 "harvesterName": "", ~/~/Комбайн, номер 4545 + 4275 4275 "harvesterId": 0, ~/~/Комбайн, id 4547 + 4276 4276 "harvesterModel": "", ~/~/ Модель комбайна 4277 -"hopperCapacity": 0, ~/~/ Объем бункера м3 4549 + 4550 + "hopperCapacity": 0, ~/~/ Объем бункера м3 4551 + 4278 4278 "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек 4553 + 4279 4279 "events": [ ~/~/Список событий в разрезе комбайна 4555 + 4280 4280 { 4557 + 4281 4281 "driverId": "", ~/~/Идентификатор водителя 4559 + 4282 4282 "driverName": "", ~/~/Водитель комбайна, ФИО 4561 + 4283 4283 "RFID": "", ~/~/ идентификатор карты-метки 4563 + 4284 4284 "rfidName": "", ~/~/Водитель комбайна, имя метки 4565 + 4285 4285 "vehicleId": 0, ~/~/идентификатор объекта 4567 + 4286 4286 "vehicleName": "string", ~/~/ Имя объекта 4569 + 4287 4287 "modelName": "string", ~/~/ Имя модели объекта 4571 + 4288 4288 "nearestVehicles": [ ~/~/Объекты рядом 4573 + 4289 4289 { 4575 + 4290 4290 "vehicleId": 0, ~/~/идентификатор объекта 4577 + 4291 4291 "vehicleName": "string" ~/~/ Имя объекта 4579 + 4292 4292 } 4581 + 4293 4293 ], 4583 + 4294 4294 "fields": [ ~/~/Поля, где происходила выгрузка 4585 + 4295 4295 { 4296 - "id": 0, ~/~/ идентификатор пользователя 4297 - "name": "string" ~/~/ имя пользователя 4587 + 4588 + "id": 0, ~/~/ идентификатор пользователя 4589 + 4590 + "name": "string" ~/~/ имя пользователя 4591 + 4298 4298 } 4593 + 4299 4299 ], 4595 + 4300 4300 "event": "string", ~/~/Событие 4597 + 4301 4301 "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода 4599 + 4302 4302 "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода 4601 + 4303 4303 "durationSeconds": 0, ~/~/Продолжительность события, в секундах 4603 + 4304 4304 "cultureName": "string", ~/~/ название культуры 4605 + 4305 4305 "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события) 4607 + 4306 4306 "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события) 4609 + 4307 4307 "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события) 4611 + 4308 4308 "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события) 4613 + 4309 4309 "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события) 4615 + 4310 4310 "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события) 4617 + 4311 4311 "issued": 0, ~/~/Выдано, бункеров 4619 + 4312 4312 "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера) 4621 + 4313 4313 "latitude": 0, ~/~/Широта 4623 + 4314 4314 "longitude": 0, ~/~/ Долгота 4625 + 4315 4315 "litresAway": 0, ~/~/Отдано, л 4627 + 4316 4316 "m3Away": 0 ~/~/Отдано, м3 4629 + 4317 4317 } 4631 + 4318 4318 ] 4633 + 4319 4319 } 4635 + 4320 4320 ] 4321 4321 4322 4322 ... ... @@ -4338,27 +4338,48 @@ 4338 4338 4339 4339 Ответ: 4340 4340 4341 -[ 4657 +[ 4658 + 4342 4342 { 4660 + 4343 4343 "recordTime": "", ~/~/Время записи 4662 + 4344 4344 "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4664 + 4345 4345 "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4666 + 4346 4346 "objectId": 0, ~/~/ID объекта, помещённого в корзину 4668 + 4347 4347 "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4670 + 4348 4348 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4672 + 4349 4349 "details": { ~/~/Список деталей объекта, помещённого в корзину 4350 - "items": [ ~/~/ 4674 + 4675 + "items": [ ~/~/ [ 4676 + 4351 4351 nullable: true ~/~/Детали 4678 + 4352 4352 { 4680 + 4353 4353 "name": "string", ~/~/наименование столбца 4682 + 4354 4354 "value": "string" ~/~/содержание столбца 4684 + 4355 4355 } 4686 + 4356 4356 ] 4688 + 4357 4357 }, 4358 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4690 + 4691 + "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4692 + 4359 4359 "string" 4694 + 4360 4360 ] 4696 + 4361 4361 } 4698 + 4362 4362 ] 4363 4363 4364 4364 ... ... @@ -4373,33 +4373,56 @@ 4373 4373 4374 4374 Пример запроса: 4375 4375 4713 + 4376 4376 [ 4377 -0 4715 + 4716 + 0 4717 + 4378 4378 ] 4379 - 4380 4380 4720 + 4381 4381 Пример ответа: 4382 4382 4383 -[ 4384 -{ 4723 +[ 4724 + 4725 + { 4726 + 4385 4385 "recordTime": "", ~/~/Время записи 4728 + 4386 4386 "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4730 + 4387 4387 "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4732 + 4388 4388 "objectId": 0, ~/~/ID объекта, помещённого в корзин 4734 + 4389 4389 "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4736 + 4390 4390 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4738 + 4391 4391 "details": { ~/~/Список деталей объекта, помещённого в корзину 4740 + 4392 4392 "items": [ ~/~/Детали 4742 + 4393 4393 { 4744 + 4394 4394 "name": "", ~/~/Имя свойства 4746 + 4395 4395 "value": "" ~/~/Значение свойства 4748 + 4396 4396 } 4750 + 4397 4397 ] 4752 + 4398 4398 }, 4754 + 4399 4399 "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4756 + 4400 4400 "" 4758 + 4401 4401 ] 4760 + 4402 4402 } 4762 + 4403 4403 ] 4404 4404 4405 4405 Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». ... ... @@ -4422,41 +4422,55 @@ 4422 4422 4423 4423 Пример запроса: 4424 4424 4425 -((( 4426 4426 [ 4427 -))) 4428 4428 4429 -((( 4430 4430 0 4431 -))) 4432 4432 4433 -((( 4434 4434 ] 4435 -))) 4436 4436 4437 4437 4438 4438 Пример ответа: 4439 4439 4440 4440 [ 4441 -{ 4795 + 4796 + { 4797 + 4442 4442 "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи 4799 + 4443 4443 "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину 4801 + 4444 4444 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину 4803 + 4445 4445 "objectId": 0, ~/~/ID объекта, помещённого в корзину 4805 + 4446 4446 "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину 4807 + 4447 4447 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4809 + 4448 4448 "details": { ~/~/Список деталей объекта, помещённого в корзину 4811 + 4449 4449 "items": [ ~/~/Детали 4813 + 4450 4450 { 4815 + 4451 4451 "name": "string", ~/~/Имя свойства 4817 + 4452 4452 "value": "string" ~/~/Значение свойства 4819 + 4453 4453 } 4821 + 4454 4454 ] 4823 + 4455 4455 }, 4825 + 4456 4456 "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4827 + 4457 4457 "string" 4829 + 4458 4458 ] 4831 + 4459 4459 } 4833 + 4460 4460 ] 4461 4461 4462 4462