Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. krainovim1 +XWiki.Gadmin - Content
-
... ... @@ -44,12 +44,8 @@ 44 44 45 45 (% lang="en-US" %) 46 46 (% style="color:#000000" %){ 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" %) 47 + "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации 48 + "User": "testuser" , ~/~/ имя пользователя(%%) 53 53 } 54 54 55 55 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. ... ... @@ -60,6 +60,9 @@ 60 60 |(% style="width:215px" %)(% style="color:#000000" %)AuthId|(% style="width:861px" %)Токен авторизации 61 61 |(% style="width:215px" %)(% style="color:#000000" %)User|(% style="width:861px" %)Логин пользователя 62 62 59 +(% class="wikigeneratedid" %) 60 +Также имеется возможность сквозной (/бесшовной) авторизации. Для этого к ссылке ( [[https:~~/~~/hosting.glonasssoft.ru>>url:https://hosting.glonasssoft.ru/login?authId={AuthId}]] / [[https:~~/~~/regions.glonasssoft.ru>>url:https://hosting.glonasssoft.ru/login?authId={AuthId}]]) добавьте токен авторизации - {AuthId}, чтобы попасть сразу в клиента ([[https:~~/~~/hosting.glonasssoft.ru/login?authId={AUTH_ID}>>https://hosting.glonasssoft.ru/login?authId={AUTH_ID}]]) 61 + 63 63 == (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) == 64 64 65 65 (% class="box infomessage" %) ... ... @@ -173,7 +173,6 @@ 173 173 { 174 174 "agentId": "",(% style="color:#000000" %) (%%) 175 175 "parentId": "", 176 - "parentName": "string", 177 177 "name": "string", 178 178 "fullName": "string", 179 179 "agentInfoType": 0, ... ... @@ -184,7 +184,6 @@ 184 184 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 185 185 |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 186 186 |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 187 -|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 188 188 |(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 189 189 |(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 190 190 |(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) ... ... @@ -228,7 +228,6 @@ 228 228 "bankKS": "string" ~/~/ корр. счёт 229 229 } 230 230 231 - 232 232 Ответ: 233 233 234 234 { ... ... @@ -422,7 +422,6 @@ 422 422 ], 423 423 "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 424 424 } 425 - 426 426 { 427 427 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 428 428 "lastName": "string", ... ... @@ -436,12 +436,8 @@ 436 436 437 437 (% style="text-align:left" %) 438 438 (% style="color:#000000; font-weight:normal" %)Ответ: 439 - 440 -(% style="text-align:left" %) 441 -(% style="color:#000000; font-weight:normal" %){ 442 - 443 -(% style="text-align:left" %) 444 -(% style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 434 +{ 435 + "id": "" , ~/~/ ID пользователя 445 445 "lastName": "" , ~/~/ Фамилия , 446 446 "firstName": "" , ~/~/ Имя 447 447 "position": "" , ~/~/ Должность ... ... @@ -458,11 +458,9 @@ 458 458 "kind": "" , ~/~/ тип аутентификации 459 459 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 460 460 "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя 452 +} 461 461 462 -(% style="text-align:left" %) 463 -(% style="color:#000000; font-weight:normal" %)} 464 464 465 - 466 466 == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) == 467 467 468 468 (% class="box infomessage" %) ... ... @@ -482,19 +482,16 @@ 482 482 483 483 (% style="color:#000000" %)Параметры в теле запроса (JSON): 484 484 485 -(% style="color:#000000" %){ 486 - 474 +(% style="color:#000000" %){(%%) 487 487 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента 488 488 "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно 489 489 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 490 490 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 491 - 492 492 (% style="color:#000000" %)} 493 493 494 494 (% style="color:#000000" %)Ответ: 495 495 496 496 (% style="color:#000000" %){ (%%) 497 - 498 498 "id": "" , ~/~/ идентификатор пользователя 499 499 "lastName": "" , ~/~/ фамилия 500 500 "firstName": "" , ~/~/ имя ... ... @@ -508,7 +508,6 @@ 508 508 "sessionDuration":"", ~/~/ длительность сессии в минутах 509 509 "status": "1", ~/~/ статус пользователя 510 510 "lastLogged": "", ~/~/ дата/время последней авторизации 511 - 512 512 (% style="color:#000000" %)} 513 513 514 514 == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) == ... ... @@ -582,10 +582,8 @@ 582 582 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 583 583 584 584 (% lang="en-US" style="text-align:left" %) 585 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 586 - 587 -(% lang="en-US" style="text-align:left" %) 588 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 570 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 571 + "id": "" , ~/~/ ID пользователя 589 589 "lastName": "" , ~/~/ фамилия 590 590 "firstName": "" , ~/~/ имя 591 591 "position": "" , ~/~/ должность ... ... @@ -607,9 +607,7 @@ 607 607 "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации 608 608 }, 609 609 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 610 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 611 - 612 -(% lang="en-US" style="text-align:left" %) 593 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя(%%) 613 613 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 614 614 615 615 (% lang="en-US" style="text-align:left" %) ... ... @@ -616,10 +616,8 @@ 616 616 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 617 617 618 618 (% lang="en-US" style="text-align:left" %) 619 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 620 - 621 -(% lang="en-US" style="text-align:left" %) 622 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя 600 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 601 + "id": "" , ~/~/ идентификатор пользователя 623 623 "lastName": "" , ~/~/ фамилия 624 624 "firstName": "" , ~/~/ имя 625 625 "position": "" , ~/~/ должность ... ... @@ -640,10 +640,8 @@ 640 640 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 641 641 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 642 642 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 622 +} 643 643 644 -(% lang="en-US" style="text-align:left" %) 645 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 646 - 647 647 == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) == 648 648 649 649 (% class="box warningmessage" %) ... ... @@ -663,12 +663,10 @@ 663 663 664 664 (% style="color:#000000" %)Параметры в теле запроса (JSON): 665 665 666 -(% style="color:#000000" %){ 667 - 643 +(% style="color:#000000" %){(%%) 668 668 "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 669 669 "description": "" , ~/~/ описание 670 670 "data": "" , ~/~/ данные, связанные со сменой статуса 671 - 672 672 (% style="color:#000000" %)} 673 673 674 674 (% style="text-align:left" %) ... ... @@ -690,7 +690,7 @@ 690 690 (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 691 691 692 692 [ 693 - 668 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 694 694 "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 695 695 ] 696 696 ... ... @@ -1032,19 +1032,15 @@ 1032 1032 "deviceTypeName": "", ~/~/ Название типа устройства 1033 1033 "sim1": "", ~/~/ Номер SIM1 1034 1034 "sim2": "", ~/~/ Номер SIM2 1035 - 1036 1036 "parentId": "", ~/~/ ID клиента-родителя 1037 1037 "parentName": "", ~/~/ Наименование клиента-родителя 1038 1038 "modelId": "", ~/~/ ID модели объекта 1039 1039 "modelName": "", ~/~/ Имя модели объекта 1040 - 1041 1041 "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1042 1042 "unitName": "string", ~/~/ Наименование подразделения 1043 1043 "status": 0, ~/~/ Статус объекта 1044 - 1045 1045 "createdAt": "", ~/~/ Дата создания объекта 1046 1046 }, 1047 - 1048 1048 "customFields": [ ~/~/ Произвольные поля 1049 1049 { 1050 1050 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля ... ... @@ -1067,8 +1067,7 @@ 1067 1067 "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1068 1068 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1069 1069 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1070 - "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1071 - 1041 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1072 1072 "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания 1073 1073 "mileageCoeff": 0, ~/~/ коэффициент пробега 1074 1074 "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна ... ... @@ -1098,7 +1098,6 @@ 1098 1098 "retries": 0 ~/~/ Количество попыток 1099 1099 } 1100 1100 ], 1101 - 1102 1102 "sensors": [ ~/~/ Датчики 1103 1103 { 1104 1104 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика ... ... @@ -1139,31 +1139,19 @@ 1139 1139 }, 1140 1140 1141 1141 ~/~/ Характерные для произвольного: 1142 - 1143 1143 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1144 - 1145 1145 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1146 - 1147 1147 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1148 - 1149 1149 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1150 - 1151 1151 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1152 - 1153 1153 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1154 - 1155 1155 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1156 - 1157 1157 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1158 - 1159 1159 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1160 - 1161 1161 ~/~/ "ValueOn": "Вкл.", 1162 - 1163 1163 ~/~/ "ValueOff": "Выкл." 1164 1164 "summaryMaxValue": 0 ~/~/ Макс. значение 1165 1165 } 1166 - 1167 1167 "drivers": [ ~/~/ Водители 1168 1168 { 1169 1169 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1172,7 +1172,6 @@ 1172 1172 "isDefault": true ~/~/ По умолчанию 1173 1173 } 1174 1174 ], 1175 - 1176 1176 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1177 1177 { 1178 1178 "id": "", ~/~/ ID задания ... ... @@ -1189,8 +1189,7 @@ 1189 1189 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1190 1190 } 1191 1191 ], 1192 - 1193 - "statusHistory": [ ~/~/ История статусов 1148 +"statusHistory": [ ~/~/ История статусов 1194 1194 { 1195 1195 "status": 0, 1196 1196 "date": "2023-05-22T09:57:39.562Z", ... ... @@ -1198,7 +1198,6 @@ 1198 1198 "additionalInfo": "string" 1199 1199 } 1200 1200 ] 1201 - 1202 1202 } 1203 1203 ))) 1204 1204 ... ... @@ -1208,6 +1208,75 @@ 1208 1208 (% style="text-align:left" %) 1209 1209 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1210 1210 1165 + 1166 +== **Отправить команду на терминал** == 1167 + 1168 +(% class="box successmessage" %) 1169 +((( 1170 +(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1171 +))) 1172 + 1173 +Команда для отправки на тс. 1174 + 1175 +{ 1176 +"id": "", ~/~/идентификатор произвольного поля 1177 +"command": "", ~/~/ Текст команды 1178 +"retries": "", ~/~/ Количество попыток 1179 +"idTemplate": "" ~/~/ ID шаблона команды 1180 +} 1181 + 1182 +(% class="wikigeneratedid" %) 1183 +== == 1184 + 1185 +== **Получить ответ на отправленную на ТС команду** == 1186 + 1187 +(% class="box infomessage" %) 1188 +((( 1189 +(% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1190 +))) 1191 + 1192 +Идентификатор команды: cmdid 1193 + 1194 +Запрос от терминала на ответ команды 1195 + 1196 +Пример ответ от терминала: 1197 + 1198 +ID= "" ~/~/ идентификатор произвольного поля 1199 +Soft="" ~/~/ версия софта 1200 +GPS=4 ~/~/ тип трекера 1201 +Time=11:05:43 28.06.24 ~/~/ время запроса 1202 +Lat=45.056221 ~/~/ широта 1203 +Lon=39.035938 ~/~/ долгота 1204 +Speed=0.0 ~/~/ скорость 1205 +Course=181.4 ~/~/направление 1206 + 1207 +((( 1208 +== **Список отправленных объекту команд с ответами** == 1209 + 1210 +(% class="box infomessage" %) 1211 +((( 1212 +(% lang="en-US" %)**GET**(%%)**/api/v3/Vehicles/cmd/{vehicleId}/history** 1213 +))) 1214 + 1215 +Идентификатор ТС: vehicleId 1216 + 1217 +В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала. 1218 + 1219 +Пример ответа терминала 1220 + 1221 +[ 1222 +{ 1223 +"id": "", ~/~/ идентификатор пользователя 1224 +"commandText": "", ~/~/Текст команды. 1225 +"templateId": "", ~/~/Идентификатор шаблона 1226 +"updated": "", ~/~/ Время отправки 1227 +"tryCount": 0, ~/~/ Количество попыток отправки команды 1228 +"answer": "", ~/~/ Ответ терминала. 1229 +"status": "" ~/~/ Статус отправки 1230 +} 1231 +] 1232 +))) 1233 + 1211 1211 == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) == 1212 1212 1213 1213 (% class="box successmessage" %) ... ... @@ -1225,8 +1225,7 @@ 1225 1225 1226 1226 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1227 1227 1228 -(% style="color:#000000" %){ 1229 - 1251 +(% style="color:#000000" %){(%%) 1230 1230 "parentId": "" , ~/~/ ID клиента 1231 1231 "name": "" , ~/~/ имя ТС 1232 1232 "imei": "" , ~/~/ IMEI ... ... @@ -1247,7 +1247,6 @@ 1247 1247 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1248 1248 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1249 1249 "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1250 - 1251 1251 "mileageCalcMethod": 0, 1252 1252 "mileageCoeff": 0, 1253 1253 "locationByCellId": true, ... ... @@ -1280,7 +1280,6 @@ 1280 1280 "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано) 1281 1281 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1282 1282 } 1283 - 1284 1284 "drivers": [ ~/~/ Водители 1285 1285 { 1286 1286 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1295,8 +1295,7 @@ 1295 1295 "retries": 0 1296 1296 } 1297 1297 ], 1298 - 1299 - "sensors": [ ~/~/ Датчики 1318 +"sensors": [ ~/~/ Датчики 1300 1300 { 1301 1301 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1302 1302 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1334,29 +1334,17 @@ 1334 1334 "additionalProp2": "string", 1335 1335 "additionalProp3": "string" 1336 1336 }, 1337 - 1338 1338 ~/~/ Характерные для произвольного: 1339 - 1340 1340 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1341 - 1342 1342 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1343 - 1344 1344 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1345 - 1346 1346 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1347 - 1348 1348 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1349 - 1350 1350 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1351 - 1352 1352 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1353 - 1354 1354 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1355 - 1356 1356 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1357 - 1358 1358 ~/~/ "ValueOn": "Вкл.", 1359 - 1360 1360 ~/~/ "ValueOff": "Выкл." 1361 1361 "summaryMaxValue": 0 ~/~/ Макс. значение 1362 1362 } ... ... @@ -1375,8 +1375,7 @@ 1375 1375 1376 1376 (% style="color:#000000" %)Ответ: 1377 1377 1378 -(% style="color:#000000" %){ 1379 - 1385 +(% style="color:#000000" %){(%%) 1380 1380 "vehicleId": "", ~/~/ID ТС 1381 1381 "parentId": "", ~/~/Guid владельца ТС 1382 1382 "name": "", ~/~/Имя объекта ... ... @@ -1414,8 +1414,6 @@ 1414 1414 "kind": "", ~/~/ Вид периодичности по времени 1415 1415 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1416 1416 } 1417 - 1418 -(% style="text-align:left" %) 1419 1419 (% style="color:#000000" %)} 1420 1420 1421 1421 **Валидация:** ... ... @@ -1430,7 +1430,7 @@ 1430 1430 (% lang="en-US" %)**POST /api/v3/vehicles/find** 1431 1431 ))) 1432 1432 1433 -(% style="color:#000000" %)Метод позволяет получить основные параметр ы объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).1437 +(% style="color:#000000" %)Метод позволяет получить список доступных объектов мониторинга (транспортных средств) с их основными параметрами: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 1434 1434 1435 1435 (% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе: 1436 1436 ... ... @@ -1474,8 +1474,7 @@ 1474 1474 (% style="color:#000000" %)Ответ: 1475 1475 1476 1476 (% style="color:#000000" %){ 1477 - 1478 -(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1481 + "vehicleId": "" ~/~/ идентификатор объекта 1479 1479 "name": "" ~/~/ наименование объекта 1480 1480 "imei": "" ~/~/ IMEI объекта 1481 1481 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1534,13 +1534,11 @@ 1534 1534 "data": "", ~/~/ Данные 1535 1535 "overwrite": false, ~/~/ Флаг перезаписи 1536 1536 "stage": "", ~/~/ Состояние, может быть null 1537 - 1538 1538 (% style="color:#000000" %)} 1539 1539 1540 1540 (% style="color:#000000" %)Ответ: 1541 1541 1542 -(% style="color:#000000" %){ 1543 - 1544 +(% style="color:#000000" %){(%%) 1544 1544 "status": "", ~/~/ значение статуса 1545 1545 "date": "", ~/~/ Дата смены статуса 1546 1546 "description": "", ~/~/ Описание ... ... @@ -1547,10 +1547,10 @@ 1547 1547 "data": "", ~/~/ Данные 1548 1548 "overwrite": false, ~/~/ Флаг перезаписи 1549 1549 "stage": "", ~/~/ Состояние 1550 - 1551 -(% style="text-align:left" %) 1552 1552 (% style="color:#000000" %) } 1553 1553 1553 +== == 1554 + 1554 1554 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1555 1555 1556 1556 (% class="box warningmessage" %) ... ... @@ -1638,8 +1638,7 @@ 1638 1638 "retries": 0 1639 1639 } 1640 1640 ], 1641 - 1642 - "sensors": [ ~/~/ Датчики 1642 +"sensors": [ ~/~/ Датчики 1643 1643 { 1644 1644 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1645 1645 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1677,29 +1677,17 @@ 1677 1677 "additionalProp2": "string", 1678 1678 "additionalProp3": "string" 1679 1679 }, 1680 - 1681 1681 ~/~/ Характерные для произвольного: 1682 - 1683 1683 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1684 - 1685 1685 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1686 - 1687 1687 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1688 - 1689 1689 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1690 - 1691 1691 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1692 - 1693 1693 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1694 - 1695 1695 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1696 - 1697 1697 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1698 - 1699 1699 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1700 - 1701 1701 ~/~/ "ValueOn": "Вкл.", 1702 - 1703 1703 ~/~/ "ValueOff": "Выкл." 1704 1704 "summaryMaxValue": 0 ~/~/ Макс. значение 1705 1705 } ... ... @@ -1719,9 +1719,7 @@ 1719 1719 (% style="color:#000000" %)Ответ: 1720 1720 1721 1721 (% lang="en-US" style="text-align:left" %) 1722 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 1723 - 1724 -(% lang="en-US" style="text-align:left" %) 1710 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ (%%) 1725 1725 "vehicleId": "", ~/~/ ID ТС 1726 1726 "parentId": "", ~/~/ ID клиента 1727 1727 "name": "", ~/~/ имя ТС ... ... @@ -1762,8 +1762,6 @@ 1762 1762 "kind": "", ~/~/ Вид периодичности по времени 1763 1763 "maxQuantity": "", ~/~/ Сколько раз выполнить задание 1764 1764 } 1765 - 1766 -(% lang="en-US" style="text-align:left" %) 1767 1767 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1768 1768 1769 1769 **Валидация:** ... ... @@ -1804,18 +1804,15 @@ 1804 1804 1805 1805 (% style="color:#000000" %)Метод запроса: **GET** 1806 1806 1807 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/ users/api/v3/devices/types>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]]1791 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/devices/types>>https://hosting.glonasssoft.ru/api/v3/devices/types]] 1808 1808 1809 1809 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1810 1810 1811 1811 (% style="color:#000000" %)Ответ: 1812 1812 1813 -(% style="color:#000000" %){ 1814 - 1797 +(% style="color:#000000" %){(%%) 1815 1815 "deviceTypeId" : "", ~/~/ ID типа устройства 1816 1816 "deviceTypeName" : "" ~/~/ Название типа устройства 1817 - 1818 -(% style="text-align:left" %) 1819 1819 (% style="color:#000000" %)} 1820 1820 1821 1821 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = ... ... @@ -1837,13 +1837,10 @@ 1837 1837 1838 1838 (% style="color:#000000" %)Ответ: 1839 1839 1840 -(% style="color:#000000" %){ 1841 - 1821 +(% style="color:#000000" %){(%%) 1842 1842 "id": "", ~/~/ ID типа датчика 1843 1843 "name": "", ~/~/ Название 1844 1844 "description": "", ~/~/ Описание 1845 - 1846 -(% style="text-align:left" %) 1847 1847 (% style="color:#000000" %)} 1848 1848 1849 1849 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = ... ... @@ -1930,8 +1930,13 @@ 1930 1930 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1931 1931 |protocolType|Тип протокола 1932 1932 |inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный 1933 -|inputNumber|Номер входа 1911 +|inputNumber|((( 1912 +Номер входа 1913 +))) 1934 1934 1915 +(% class="wikigeneratedid" %) 1916 +Перечень ID протоколов в статье - [[ID протоколов для получения типов и номеров входа сырого параметра.>>https://wiki.glonasssoft.ru/bin/view/API/ID%20%D0%BF%D1%80%D0%BE%D1%82%D0%BE%D0%BA%D0%BE%D0%BB%D1%8B%20%D0%B4%D0%BB%D1%8F%20%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20%D1%82%D0%B8%D0%BF%D0%B0%20%D0%B8%20%D0%BD%D0%BE%D0%BC%D0%B5%D1%80%D0%B0%20%D0%B2%D1%85%D0%BE%D0%B4%D0%B0%20%D1%81%D1%8B%D1%80%D0%BE%D0%B3%D0%BE%20%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0/]] 1917 + 1935 1935 == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1936 1936 1937 1937 (% class="box infomessage" %) ... ... @@ -2137,6 +2137,96 @@ 2137 2137 } 2138 2138 ] 2139 2139 2123 + 2124 +== (% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов**(%%) == 2125 + 2126 +(% class="box infomessage" %) 2127 +((( 2128 +**POST /api/v3/vehicles/moveStop** 2129 +))) 2130 + 2131 +Метод запроса: **POST** 2132 + 2133 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/moveStop 2134 + 2135 +В заголовках запроса: X-Auth: Токен авторизации 2136 + 2137 + 2138 +Тело запроса: 2139 + 2140 +{ 2141 + "vehicleIds": [ ], ~/~/ Список ID объектов 2142 + "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2143 + "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2144 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2145 +} 2146 + 2147 +Ответ: 2148 + 2149 +[ 2150 + { 2151 + "vehicleId": 0, ~/~/ ID объекта 2152 + "vehicleName": "string", ~/~/ Имя объекта 2153 + "moves": [ ~/~/ Событие движения 2154 + { 2155 + "mileage": 0, ~/~/ Пробег, км 2156 + "eventId": 0, ~/~/ Идентификатор события 2157 + "eventName": "string", ~/~/ Название события 2158 + "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2159 + "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2160 + "duration": 0 ~/~/ Продолжительность события, секунд 2161 + } 2162 + ], 2163 + "stops": [ ~/~/ События стоянок 2164 + { 2165 + "address": "string", ~/~/ Адрес события 2166 + "eventId": 0, ~/~/ Идентификатор события 2167 + "eventName": "string", ~/~/ Название события 2168 + "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2169 + "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2170 + "duration": 0 ~/~/ Продолжительность события, секунд 2171 + } 2172 + ] 2173 + } 2174 +] 2175 + 2176 + 2177 +== (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) == 2178 + 2179 +(% class="box infomessage" %) 2180 +((( 2181 +**POST /api/v3/vehicles/getlastdata** 2182 +))) 2183 + 2184 +Метод запроса: **POST** 2185 + 2186 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/getlastdata 2187 + 2188 +В заголовках запроса: X-Auth: Токен авторизации 2189 + 2190 + 2191 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2192 + 2193 +Ответ: 2194 + { 2195 + "vehicleId": 0, ~/~/Идентификатор объекта. 2196 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2197 + "vehicleNumber": "string",~/~/Номер объекта. 2198 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2199 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2200 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2201 + "speed": 0,~/~/Скорость объекта. 2202 + "course": 0,~/~/Курс движения [0;360] 2203 + "latitude": 0,~/~/Широта [-90°;90°]. 2204 + "longitude": 0,~/~/Долгота [-180°;180°]. 2205 + "address": "string",~/~/Адрес. 2206 + "geozones": [ ~/~/Сведения по геозонам. 2207 + { 2208 + "id": 0, 2209 + "name": "string" 2210 + } 2211 + 2212 + 2140 2140 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2141 2141 2142 2142 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -3813,7 +3813,7 @@ 3813 3813 3814 3814 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Экодрайвинг**(%%) = 3815 3815 3816 -== (% style="color:#000000; font-size:16px" %)**Запрос рейтин ша качества вождения**(%%) ==3889 +== (% style="color:#000000; font-size:16px" %)**Запрос рейтинга качества вождения**(%%) == 3817 3817 3818 3818 (% class="box infomessage" %) 3819 3819 ((( ... ... @@ -3919,6 +3919,444 @@ 3919 3919 |driverName|Имя водителя 3920 3920 |driverRfid|Номер Карты-метки 3921 3921 3995 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 3996 + 3997 +== (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == 3998 + 3999 +Транзакции по топливным картам можно получить при наличии права «Транзакции ТК». Метод позволяет получить транзакции по нескольким топливным картам. 4000 + 4001 +(% class="box infomessage" %) 4002 +((( 4003 +POST /api/v3/fuelcards/transactions 4004 +))) 4005 + 4006 +Метод запроса: POST 4007 + 4008 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards/transactions 4009 +\\В заголовках запроса: X-Auth: Токен авторизации 4010 + 4011 +Параметры в теле запроса (JSON): 4012 + 4013 +{ 4014 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4015 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4016 + "ids": [ 4017 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4018 + ], 4019 + "timezone": 0 ~/~/Таймзона 4020 +} 4021 + 4022 + 4023 +Ответ: 4024 + { 4025 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4026 + "driver": "string", ~/~/Водители, привязанные к ТК 4027 + "object": "string", ~/~/Наименование ТС 4028 + "amount": 0, ~/~/Количество топлива 4029 + "amountDut": 0, ~/~/Количество по ДУТ 4030 + "amountDiff": 0, ~/~/Разница, л 4031 + "amountDiffPerc": 0, ~/~/Разница, % 4032 + "summa": 0, ~/~/Стоимость, руб 4033 + "serviceName": "string", ~/~/Тип топлива 4034 + "price": 0, ~/~/Цена за литр, руб 4035 + "cardName": "string", ~/~/Наименование ТК 4036 + "cardNum": "string", ~/~/Номер ТК 4037 + "operator": "string", ~/~/Оператор ТК 4038 + "address": "string" ~/~/Адрес АЗС 4039 + } 4040 + 4041 + 4042 += (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4043 + 4044 + 4045 +== **Получение полных данных о ретрансляторе** == 4046 + 4047 +(% class="box infomessage" %) 4048 +((( 4049 +**GET ** **/api/v3/retranslations/{id}** 4050 +))) 4051 + 4052 +Идентификатор запроса: ID 4053 + 4054 + 4055 +Пример ответа: 4056 + 4057 +{ 4058 +"description": "", ~/~/ Определяет описание 4059 +"subscriberId": "", ~/~/ Подписчик 4060 +"protocolType": 0, ~/~/ Тип протокола 4061 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4062 +"address": "string", ~/~/ Адрес события 4063 +"objects": [ ~/~/Объекты для ретрансляции 4064 +{ 4065 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4066 +"name": "", ~/~/ Наименование объекта ретрансляции 4067 +"imei": "", ~/~/ IMEI объекта 4068 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4069 +} 4070 + ], 4071 +"id": "", ~/~/ идентификатор пользователя 4072 +"parentId": "", ~/~/Guid родителя 4073 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4074 +} 4075 + 4076 + 4077 +== **Удаление данных ретранслятора** == 4078 + 4079 +(% class="box infomessage" %) 4080 +((( 4081 +**DELETE** **/api/v3/retranslations/{id}** 4082 +))) 4083 + 4084 +Параметр запроса: ID 4085 + 4086 + 4087 +== **Создание ретранслятора** == 4088 + 4089 +(% class="box infomessage" %) 4090 +((( 4091 +**POST ** **/api/v3/retranslations/{id}** 4092 +))) 4093 + 4094 +Запрос: 4095 + 4096 +{ 4097 +"description": "", ~/~/ Описание 4098 +"subscriberId": "", ~/~/ Подписчик 4099 +"protocolType": 0, ~/~/ Тип протокола 4100 +"address": "", ~/~/ Адрес ретрансляции 4101 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4102 +"objects": [ ~/~/Объекты для ретрансляции 4103 +{ 4104 +"id": "", ~/~/ идентификатор пользователя 4105 +"imei": "", ~/~/IMEI объекта 4106 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4107 +} 4108 + ] 4109 +} 4110 + 4111 + 4112 +Ответ: 4113 + 4114 +{ 4115 +"description": "string", ~/~/ Определяет описание 4116 +"subscriberId": "", ~/~/ идентификатор запроса 4117 +"protocolType": 0, ~/~/ Тип протокола 4118 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4119 +"address": "", ~/~/ Адрес события 4120 +"objects": [ ~/~/Объекты для ретрансляции 4121 +{ 4122 +"id": "", ~/~/ идентификатор пользователя 4123 +"name": "string", ~/~/ Название уведомления 4124 +"imei": "string", ~/~/IMEI объекта 4125 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4126 +} 4127 + ], 4128 +"id": "", ~/~/ идентификатор пользователя 4129 +"parentId": "", ~/~/ Guid идентификатор родителя 4130 +"deleted": true ~/~/ Признак удаления 4131 +} 4132 + 4133 + 4134 +== **Редактирование ретранслятора** == 4135 + 4136 +(% class="box infomessage" %) 4137 +((( 4138 +**PUT** **/api/v3/retranslations** 4139 +))) 4140 + 4141 +Пример запроса: 4142 + 4143 +{ 4144 +"id": "", ~/~/ идентификатор пользователя 4145 +"description": "string", ~/~/ Определяет описание 4146 +"subscriberId": "", ~/~/ идентификатор запроса 4147 +"protocolType": 0, ~/~/ Тип протокола 4148 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4149 +"address": "string", ~/~/ Адрес события 4150 +"objects": ~/~/Объекты для ретрансляции 4151 +[ 4152 +{ 4153 +"id": "", ~/~/ идентификатор пользователя 4154 +"imei": "", ~/~/IMEI объекта 4155 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4156 +} 4157 + ] 4158 +} 4159 + 4160 + 4161 +Пример ответа: 4162 + 4163 +{ 4164 +"description": "", ~/~/ Определяет описание 4165 +"subscriberId": "", ~/~/ идентификатор запроса 4166 +"protocolType": 0, ~/~/ Тип протокола 4167 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4168 +"address": "string", ~/~/ Адрес события 4169 +"objects": [ ~/~/Объекты для ретрансляции 4170 +{ 4171 +"id": "", ~/~/ идентификатор пользователя 4172 +"name": "string", ~/~/ Название уведомления 4173 +"imei": "", ~/~/IMEI объекта 4174 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4175 +} 4176 + ], 4177 +"id": "", ~/~/ идентификатор пользователя 4178 +"parentId": "", ~/~/ Guid идентификатор родителя 4179 +"deleted": true ~/~/ Признак удаления 4180 +} 4181 + 4182 + 4183 +== **Получение списка ретранслятора клиента** == 4184 + 4185 +(% class="box infomessage" %) 4186 +((( 4187 +**POST /api/v3/retranslations/find** 4188 +))) 4189 + 4190 +Пример запроса: 4191 + 4192 +{ 4193 +"id": "", ~/~/ идентификатор пользователя 4194 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4195 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4196 +} 4197 + 4198 +Ответ: 4199 + 4200 +[ 4201 +{ 4202 +"description": "", ~/~/ Определяет описание 4203 +"subscriberId": "", ~/~/ идентификатор запроса 4204 +"protocolType": 0, ~/~/ Тип протокола 4205 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4206 +"address": "string", ~/~/ Адрес события 4207 +"id": "", ~/~/ идентификатор пользователя 4208 +"parentId": "", ~/~/ Guid идентификатор родителя 4209 +"deleted": true ~/~/ Признак удаления 4210 +} 4211 +] 4212 + 4213 + 4214 += (% style="color:#000000; font-size:18.6667px" %)**Раздел: Отчеты**(%%) = 4215 + 4216 +== **API для отчета по выгрузке комбайнов** == 4217 + 4218 +(% class="box infomessage" %) 4219 +((( 4220 +POST **/api/v3/Reports/harvesterUnloading** 4221 +))) 4222 + 4223 +Пример запроса: 4224 + 4225 +{ 4226 + "byTime": 0, ~/~/ Объединение событий по времени 4227 + "byDist": 0, ~/~/ Объединение событий по расстоянию 4228 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 4229 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 4230 + "showNearestObjects": true, ~/~/Показывать объекты рядом? 4231 + "vehicleIds": [ ~/~/ Список id объектов для анализа 4232 + 0 4233 + ], 4234 + "from": "", ~/~/ Дата и время начало запроса 4235 + "to": "", ~/~/ Дата и время окончания запроса 4236 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 4237 +} 4238 + 4239 +Пример ответа: 4240 + 4241 +[ 4242 + { 4243 + "harvesterName": "", ~/~/Комбайн, номер 4244 + "harvesterId": 0, ~/~/Комбайн, id 4245 +"harvesterModel": "", ~/~/ Модель комбайна 4246 +"hopperCapacity": 0, ~/~/ Объем бункера м3 4247 + "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек 4248 + "events": [ ~/~/Список событий в разрезе комбайна 4249 + { 4250 + "driverId": "", ~/~/Идентификатор водителя 4251 + "driverName": "", ~/~/Водитель комбайна, ФИО 4252 + "RFID": "", ~/~/ идентификатор карты-метки 4253 + "rfidName": "", ~/~/Водитель комбайна, имя метки 4254 + "vehicleId": 0, ~/~/идентификатор объекта 4255 + "vehicleName": "string", ~/~/ Имя объекта 4256 + "modelName": "string", ~/~/ Имя модели объекта 4257 + "nearestVehicles": [ ~/~/Объекты рядом 4258 + { 4259 + "vehicleId": 0, ~/~/идентификатор объекта 4260 + "vehicleName": "string" ~/~/ Имя объекта 4261 + } 4262 + ], 4263 + "fields": [ ~/~/Поля, где происходила выгрузка 4264 + { 4265 + "id": 0, ~/~/ идентификатор пользователя 4266 + "name": "string" ~/~/ имя пользователя 4267 + } 4268 + ], 4269 + "event": "string", ~/~/Событие 4270 + "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода 4271 + "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода 4272 + "durationSeconds": 0, ~/~/Продолжительность события, в секундах 4273 + "cultureName": "string", ~/~/ название культуры 4274 + "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события) 4275 + "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события) 4276 + "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события) 4277 + "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события) 4278 + "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события) 4279 + "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события) 4280 + "issued": 0, ~/~/Выдано, бункеров 4281 + "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера) 4282 + "latitude": 0, ~/~/Широта 4283 + "longitude": 0, ~/~/ Долгота 4284 + "litresAway": 0, ~/~/Отдано, л 4285 + "m3Away": 0 ~/~/Отдано, м3 4286 + } 4287 + ] 4288 + } 4289 +] 4290 + 4291 + 4292 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 4293 + 4294 +== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 4295 + 4296 + 4297 +(% class="box infomessage" %) 4298 +((( 4299 +GET api/v3/Vehicles/recyclebin/all 4300 +))) 4301 + 4302 +Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту 4303 + 4304 +Параметр запроса: {parentId} - идентификатор агента 4305 + 4306 +В заголовках запроса: X-Auth: Токен авторизации 4307 + 4308 +Ответ: 4309 + 4310 +[ 4311 + { 4312 + "recordTime": "", ~/~/Время записи 4313 + "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4314 + "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4315 + "objectId": 0, ~/~/ID объекта, помещённого в корзину 4316 + "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4317 + "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4318 + "details": { ~/~/Список деталей объекта, помещённого в корзину 4319 + "items": [ ~/~/ 4320 +nullable: true ~/~/Детали 4321 + { 4322 + "name": "string", ~/~/наименование столбца 4323 + "value": "string" ~/~/содержание столбца 4324 + } 4325 + ] 4326 + }, 4327 + "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4328 + "string" 4329 + ] 4330 + } 4331 +] 4332 + 4333 + 4334 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 4335 + 4336 +(% class="box infomessage" %) 4337 +((( 4338 +POST/api/v3/Vehicles/recyclebin/erase 4339 +))) 4340 + 4341 +В заголовках запроса: X-Auth: Токен авторизации 4342 + 4343 +Пример запроса: 4344 + 4345 +[ 4346 +0 4347 +] 4348 + 4349 + 4350 +Пример ответа: 4351 + 4352 +[ 4353 +{ 4354 + "recordTime": "", ~/~/Время записи 4355 + "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4356 + "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4357 + "objectId": 0, ~/~/ID объекта, помещённого в корзин 4358 + "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4359 + "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4360 + "details": { ~/~/Список деталей объекта, помещённого в корзину 4361 + "items": [ ~/~/Детали 4362 + { 4363 + "name": "", ~/~/Имя свойства 4364 + "value": "" ~/~/Значение свойства 4365 + } 4366 + ] 4367 + }, 4368 + "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4369 + "" 4370 + ] 4371 + } 4372 +] 4373 + 4374 +Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 4375 + 4376 +== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) == 4377 + 4378 +(% class="box infomessage" %) 4379 +((( 4380 +POST/api/v3/Vehicles/recyclebin/restore 4381 +))) 4382 + 4383 +В заголовках запроса: X-Auth: Токен авторизации 4384 + 4385 +Параметры в теле запроса (JSON): 4386 + 4387 +Восстанавливает объекты из корзины. Возвращает те объекты которые не получилось восстановить. 4388 + 4389 +В заголовках запроса: X-Auth: Токен авторизации 4390 + 4391 + 4392 +Пример запроса: 4393 + 4394 +((( 4395 +[ 4396 +))) 4397 + 4398 +((( 4399 + 0 4400 +))) 4401 + 4402 +((( 4403 +] 4404 +))) 4405 + 4406 + 4407 +Пример ответа: 4408 + 4409 +[ 4410 +{ 4411 + "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи 4412 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину 4413 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину 4414 + "objectId": 0, ~/~/ID объекта, помещённого в корзину 4415 + "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину 4416 + "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4417 + "details": { ~/~/Список деталей объекта, помещённого в корзину 4418 + "items": [ ~/~/Детали 4419 + { 4420 + "name": "string", ~/~/Имя свойства 4421 + "value": "string" ~/~/Значение свойства 4422 + } 4423 + ] 4424 + }, 4425 + "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4426 + "string" 4427 + ] 4428 + } 4429 +] 4430 + 4431 + 4432 + 3922 3922 (% class="box" lang="en-US" style="text-align: center;" %) 3923 3923 ((( 3924 3924 (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **