Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
<
>
edited by Андрей Калиновский
on 2024/11/22 13:26
on 2024/11/22 13:26
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,9 +1,11 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -**Содержание страницы:** \3 +**Содержание страницы:** 4 4 ))) 5 5 6 +{{toc/}} 6 6 8 + 7 7 = (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) = 8 8 9 9 (% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов). ... ... @@ -12,20 +12,11 @@ 12 12 13 13 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 14 14 15 -(% style="color:#000000" %)− (%%)При **редактировании** любойзаписи (пользователь, объект и т.д)необходимо передавать все параметры записив теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 16 16 17 - 18 -(% style="color:#000000; font-size:16px" %)**Рекомендации** 19 - 20 -- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 21 - 22 22 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 23 23 24 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 25 -((( 26 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 27 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 28 -))) 21 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 29 29 30 30 (% class="box successmessage" %) 31 31 ((( ... ... @@ -51,8 +51,12 @@ 51 51 52 52 (% lang="en-US" %) 53 53 (% style="color:#000000" %){ 54 - "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации 55 - "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" %) 56 56 } 57 57 58 58 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. ... ... @@ -232,6 +232,7 @@ 232 232 "bankKS": "string" ~/~/ корр. счёт 233 233 } 234 234 232 + 235 235 Ответ: 236 236 237 237 { ... ... @@ -425,6 +425,7 @@ 425 425 ], 426 426 "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 427 427 } 426 + 428 428 { 429 429 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 430 430 "lastName": "string", ... ... @@ -438,8 +438,12 @@ 438 438 439 439 (% style="text-align:left" %) 440 440 (% style="color:#000000; font-weight:normal" %)Ответ: 441 -{ 442 - "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 пользователя 443 443 "lastName": "" , ~/~/ Фамилия , 444 444 "firstName": "" , ~/~/ Имя 445 445 "position": "" , ~/~/ Должность ... ... @@ -456,9 +456,11 @@ 456 456 "kind": "" , ~/~/ тип аутентификации 457 457 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 458 458 "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя 459 -} 460 460 463 +(% style="text-align:left" %) 464 +(% style="color:#000000; font-weight:normal" %)} 461 461 466 + 462 462 == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) == 463 463 464 464 (% class="box infomessage" %) ... ... @@ -478,16 +478,19 @@ 478 478 479 479 (% style="color:#000000" %)Параметры в теле запроса (JSON): 480 480 481 -(% style="color:#000000" %){(%%) 486 +(% style="color:#000000" %){ 487 + 482 482 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента 483 483 "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно 484 484 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 485 485 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 492 + 486 486 (% style="color:#000000" %)} 487 487 488 488 (% style="color:#000000" %)Ответ: 489 489 490 490 (% style="color:#000000" %){ (%%) 498 + 491 491 "id": "" , ~/~/ идентификатор пользователя 492 492 "lastName": "" , ~/~/ фамилия 493 493 "firstName": "" , ~/~/ имя ... ... @@ -501,6 +501,7 @@ 501 501 "sessionDuration":"", ~/~/ длительность сессии в минутах 502 502 "status": "1", ~/~/ статус пользователя 503 503 "lastLogged": "", ~/~/ дата/время последней авторизации 512 + 504 504 (% style="color:#000000" %)} 505 505 506 506 == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) == ... ... @@ -574,8 +574,10 @@ 574 574 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 575 575 576 576 (% lang="en-US" style="text-align:left" %) 577 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 578 - "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 пользователя 579 579 "lastName": "" , ~/~/ фамилия 580 580 "firstName": "" , ~/~/ имя 581 581 "position": "" , ~/~/ должность ... ... @@ -597,7 +597,9 @@ 597 597 "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации 598 598 }, 599 599 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 600 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя(%%) 611 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 612 + 613 +(% lang="en-US" style="text-align:left" %) 601 601 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 602 602 603 603 (% lang="en-US" style="text-align:left" %) ... ... @@ -604,8 +604,10 @@ 604 604 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 605 605 606 606 (% lang="en-US" style="text-align:left" %) 607 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 608 - "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": "" , ~/~/ идентификатор пользователя 609 609 "lastName": "" , ~/~/ фамилия 610 610 "firstName": "" , ~/~/ имя 611 611 "position": "" , ~/~/ должность ... ... @@ -626,8 +626,10 @@ 626 626 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 627 627 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 628 628 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 629 -} 630 630 645 +(% lang="en-US" style="text-align:left" %) 646 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 647 + 631 631 == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) == 632 632 633 633 (% class="box warningmessage" %) ... ... @@ -647,10 +647,12 @@ 647 647 648 648 (% style="color:#000000" %)Параметры в теле запроса (JSON): 649 649 650 -(% style="color:#000000" %){(%%) 667 +(% style="color:#000000" %){ 668 + 651 651 "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован) 652 652 "description": "" , ~/~/ описание 653 653 "data": "" , ~/~/ данные, связанные со сменой статуса 672 + 654 654 (% style="color:#000000" %)} 655 655 656 656 (% style="text-align:left" %) ... ... @@ -672,7 +672,7 @@ 672 672 (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 673 673 674 674 [ 675 - "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 694 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 676 676 "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 677 677 ] 678 678 ... ... @@ -978,7 +978,7 @@ 978 978 979 979 Ответ: В случае успеха **Success 200** 980 980 981 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =1000 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 982 982 983 983 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 984 984 ... ... @@ -1014,15 +1014,19 @@ 1014 1014 "deviceTypeName": "", ~/~/ Название типа устройства 1015 1015 "sim1": "", ~/~/ Номер SIM1 1016 1016 "sim2": "", ~/~/ Номер SIM2 1036 + 1017 1017 "parentId": "", ~/~/ ID клиента-родителя 1018 1018 "parentName": "", ~/~/ Наименование клиента-родителя 1019 1019 "modelId": "", ~/~/ ID модели объекта 1020 1020 "modelName": "", ~/~/ Имя модели объекта 1041 + 1021 1021 "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1022 1022 "unitName": "string", ~/~/ Наименование подразделения 1023 1023 "status": 0, ~/~/ Статус объекта 1045 + 1024 1024 "createdAt": "", ~/~/ Дата создания объекта 1025 1025 }, 1048 + 1026 1026 "customFields": [ ~/~/ Произвольные поля 1027 1027 { 1028 1028 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля ... ... @@ -1045,7 +1045,8 @@ 1045 1045 "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1046 1046 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1047 1047 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1048 - "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1071 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1072 + 1049 1049 "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания 1050 1050 "mileageCoeff": 0, ~/~/ коэффициент пробега 1051 1051 "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна ... ... @@ -1075,6 +1075,7 @@ 1075 1075 "retries": 0 ~/~/ Количество попыток 1076 1076 } 1077 1077 ], 1102 + 1078 1078 "sensors": [ ~/~/ Датчики 1079 1079 { 1080 1080 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика ... ... @@ -1115,19 +1115,31 @@ 1115 1115 }, 1116 1116 1117 1117 ~/~/ Характерные для произвольного: 1143 + 1118 1118 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1145 + 1119 1119 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1147 + 1120 1120 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1149 + 1121 1121 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1151 + 1122 1122 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1153 + 1123 1123 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1155 + 1124 1124 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1157 + 1125 1125 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1159 + 1126 1126 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1161 + 1127 1127 ~/~/ "ValueOn": "Вкл.", 1163 + 1128 1128 ~/~/ "ValueOff": "Выкл." 1129 1129 "summaryMaxValue": 0 ~/~/ Макс. значение 1130 1130 } 1167 + 1131 1131 "drivers": [ ~/~/ Водители 1132 1132 { 1133 1133 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1136,6 +1136,7 @@ 1136 1136 "isDefault": true ~/~/ По умолчанию 1137 1137 } 1138 1138 ], 1176 + 1139 1139 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1140 1140 { 1141 1141 "id": "", ~/~/ ID задания ... ... @@ -1152,7 +1152,8 @@ 1152 1152 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1153 1153 } 1154 1154 ], 1155 -"statusHistory": [ ~/~/ История статусов 1193 + 1194 + "statusHistory": [ ~/~/ История статусов 1156 1156 { 1157 1157 "status": 0, 1158 1158 "date": "2023-05-22T09:57:39.562Z", ... ... @@ -1160,6 +1160,7 @@ 1160 1160 "additionalInfo": "string" 1161 1161 } 1162 1162 ] 1202 + 1163 1163 } 1164 1164 ))) 1165 1165 ... ... @@ -1170,143 +1170,82 @@ 1170 1170 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1171 1171 1172 1172 1173 -== ** Импортироватьисторию ТС(Асинхронный запрос)** ==1213 +== **Получить ответ на отправленную на ТС команду** == 1174 1174 1175 -(% class="box successmessage" %)1215 +(% class="box infomessage" %) 1176 1176 ((( 1177 -** POST /api/v3/Vehicles/importAsync/history/{vehicleId}1217 +(% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1178 1178 ))) 1179 1179 1180 - (% style="color:#000000" %)Метод запроса:**POST**1220 +Идентификатор команды: cmdid 1181 1181 1182 -(% style="color:#000000" %)URL запроса: (%%)**https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1183 1183 1184 - (% style="color:#000000" %)Параметр запроса:{__**vehicleid}**__ - идентификатортранспортного средства1223 +Запрос от терминала на ответ команды 1185 1185 1186 1186 1187 - Ответ:1226 +Пример ответ от терминала: 1188 1188 1189 -{ 1190 1190 1191 - "RequestId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Уникальный идентификаторзапроса1229 +ID= "" ~/~/ идентификатор произвольного поля 1192 1192 1193 - "Status": 0,~/~/Перечислениесостояний выполнения запроса1231 +Soft="" ~/~/ версия софта 1194 1194 1195 -~/~/ (0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)1233 +GPS=4 ~/~/ тип трекера 1196 1196 1197 - "Message":"string",~/~/Информацияо выполнениизапроса1235 +Time=11:05:43 28.06.24 ~/~/ время запроса 1198 1198 1199 - "ProgressState":1,~/~/Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)1237 +Lat=45.056221 ~/~/ широта 1200 1200 1201 - "ProgressValue":0,~/~/Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress1239 +Lon=39.035938 ~/~/ долгота 1202 1202 1203 - "Data": "string"~/~/Данные1241 +Speed=0.0 ~/~/ скорость 1204 1204 1205 - }1243 +Course=181.4 ~/~/направление 1206 1206 1207 1207 1208 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 1209 1209 1247 +((( 1248 +== **Список отправленных объекту команд с ответами** == 1249 + 1210 1210 (% class="box infomessage" %) 1211 1211 ((( 1212 -**GET importAsync/history/state/{requestId}**1252 +(% lang="en-US" %)**GET**(%%)**/api/v3/Vehicles/cmd/{vehicleId}/history** 1213 1213 ))) 1214 1214 1215 - (% style="color:#000000" %)Метод запроса:**GET**1255 +Идентификатор ТС: vehicleId 1216 1216 1217 -(% style="color:#000000" %)URL запроса: (%%)https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1218 1218 1219 - (%style="color:#000000" %)Параметрзапроса:{(%%)**requestId(%style="color:#000000"%)__}__(%%)**(%style="color:#000000" %) - (%%)Уникальныйидентификаторзапроса1258 +В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала. 1220 1220 1221 1221 1222 - Ответ:1261 +Пример ответа терминала 1223 1223 1224 -{ 1225 1225 1226 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Уникальный идентификатор запроса1264 +[ 1227 1227 1228 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 1229 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1266 +{ 1230 1230 1231 - Message": "string",Информацияо выполнениизапроса1268 +"id": "", ~/~/ идентификатор пользователя 1232 1232 1233 - ProgressState":1,ипинформирования о ходе выполнении запроса1270 +"commandText": "", ~/~/Текст команды. 1234 1234 1235 - ~/~/ 1 - Intermediate,2-ProgressProcent,255- None1272 +"templateId": "", ~/~/Идентификатор шаблона 1236 1236 1237 - ProgressValue":0,Прогресс выполнениязапроса. Актуально, только еслиProgressState=InProgress1274 +"updated": "", ~/~/ Время отправки 1238 1238 1239 - Data": "string"Данные1276 +"tryCount": 0, ~/~/ Количество попыток отправки команды 1240 1240 1241 - }1278 +"answer": "", ~/~/ Ответ терминала. 1242 1242 1280 +"status": "" ~/~/ Статус отправки 1243 1243 1244 -== **Отправить команду на терминал** == 1245 - 1246 -(% class="box successmessage" %) 1247 -((( 1248 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create** 1249 -))) 1250 - 1251 -Команда для отправки на тс. 1252 - 1253 -{ 1254 -"id": "", ~/~/идентификатор произвольного поля 1255 -"command": "", ~/~/ Текст команды 1256 -"retries": "", ~/~/ Количество попыток 1257 -"idTemplate": "" ~/~/ ID шаблона команды 1258 1258 } 1259 1259 1284 +] 1260 1260 1261 -== **Получить ответ на отправленную на ТС команду** == 1262 - 1263 -(% class="box infomessage" %) 1264 -((( 1265 -(% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1286 + 1266 1266 ))) 1267 1267 1268 -Идентификатор команды: cmdid 1269 - 1270 -Запрос от терминала на ответ команды 1271 - 1272 -Пример ответ от терминала: 1273 - 1274 -ID= "" ~/~/ идентификатор произвольного поля 1275 -Soft="" ~/~/ версия софта 1276 -GPS=4 ~/~/ тип трекера 1277 -Time=11:05:43 28.06.24 ~/~/ время запроса 1278 -Lat=45.056221 ~/~/ широта 1279 -Lon=39.035938 ~/~/ долгота 1280 -Speed=0.0 ~/~/ скорость 1281 -Course=181.4 ~/~/направление 1282 - 1283 -((( 1284 -== **Список отправленных объекту команд с ответами** == 1285 - 1286 -(% class="box infomessage" %) 1287 -((( 1288 -(% lang="en-US" %)**GET**(%%)**/api/v3/Vehicles/cmd/{vehicleId}/history** 1289 -))) 1290 - 1291 -Идентификатор ТС: vehicleId 1292 - 1293 -В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала. 1294 - 1295 -Пример ответа терминала 1296 - 1297 -[ 1298 -{ 1299 -"id": "", ~/~/ идентификатор пользователя 1300 -"commandText": "", ~/~/Текст команды. 1301 -"templateId": "", ~/~/Идентификатор шаблона 1302 -"updated": "", ~/~/ Время отправки 1303 -"tryCount": 0, ~/~/ Количество попыток отправки команды 1304 -"answer": "", ~/~/ Ответ терминала. 1305 -"status": "" ~/~/ Статус отправки 1306 -} 1307 -] 1308 -))) 1309 - 1310 1310 == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) == 1311 1311 1312 1312 (% class="box successmessage" %) ... ... @@ -1324,7 +1324,8 @@ 1324 1324 1325 1325 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1326 1326 1327 -(% style="color:#000000" %){(%%) 1306 +(% style="color:#000000" %){ 1307 + 1328 1328 "parentId": "" , ~/~/ ID клиента 1329 1329 "name": "" , ~/~/ имя ТС 1330 1330 "imei": "" , ~/~/ IMEI ... ... @@ -1345,6 +1345,7 @@ 1345 1345 "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1346 1346 "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1347 1347 "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1328 + 1348 1348 "mileageCalcMethod": 0, 1349 1349 "mileageCoeff": 0, 1350 1350 "locationByCellId": true, ... ... @@ -1377,6 +1377,7 @@ 1377 1377 "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано) 1378 1378 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 1379 1379 } 1361 + 1380 1380 "drivers": [ ~/~/ Водители 1381 1381 { 1382 1382 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -1391,7 +1391,8 @@ 1391 1391 "retries": 0 1392 1392 } 1393 1393 ], 1394 -"sensors": [ ~/~/ Датчики 1376 + 1377 + "sensors": [ ~/~/ Датчики 1395 1395 { 1396 1396 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1397 1397 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1429,43 +1429,41 @@ 1429 1429 "additionalProp2": "string", 1430 1430 "additionalProp3": "string" 1431 1431 }, 1415 + 1432 1432 ~/~/ Характерные для произвольного: 1417 + 1433 1433 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1419 + 1434 1434 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1421 + 1435 1435 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1423 + 1436 1436 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1425 + 1437 1437 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1427 + 1438 1438 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1429 + 1439 1439 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1431 + 1440 1440 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1433 + 1441 1441 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1435 + 1442 1442 ~/~/ "ValueOn": "Вкл.", 1443 -~/~/ "ValueOff": "Выкл." 1444 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1445 1445 1446 -((( 1447 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1448 - { 1449 - "from": 0, ~/~/ С какого значения 1450 - "color": "string", ~/~/ Каким цветом 1451 - "text": "string" ~/~/ Текст подписи к этому интервалу 1452 - } 1453 - ] 1438 +~/~/ "ValueOff": "Выкл." 1439 + "summaryMaxValue": 0 ~/~/ Макс. значение 1454 1454 } 1455 1455 ], 1456 -))) 1457 - 1458 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1459 - 1460 - 1461 1461 "customFields": [ ~/~/ Произвольные поля 1462 1462 { 1463 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1464 - "name": "string", ~/~/ Наименование произвольного поля1465 - "value": "string", ~/~/ Значение произвольного поля1466 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1467 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1468 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1444 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1445 + "name": "string", 1446 + "value": "string", 1447 + "forClient": true, 1448 + "forTooltip": true, 1449 + "forReport": true 1469 1469 } 1470 1470 ] 1471 1471 } ... ... @@ -1472,161 +1472,55 @@ 1472 1472 1473 1473 (% style="color:#000000" %)Ответ: 1474 1474 1456 +(% style="color:#000000" %){ 1475 1475 1476 -((( 1477 -((( 1478 -((( 1479 -{ 1480 - "vehicleId": 0, ~/~/ ID ТС 1481 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1482 - "name": "string", ~/~/ Имя объекта 1483 - "imei": "string", ~/~/ IMEI 1484 - "deviceTypeId": 0, ~/~/ ID типа устройства 1485 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1486 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1487 - "sim1": "string", ~/~/ SIM1 1488 - "sim2": "string", ~/~/ SIM2 1489 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1490 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1491 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1492 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1493 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1494 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1495 - "consumptionPer100KmSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1496 - "consumptionPer100KmSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1497 - "consumptionPerHourSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1498 - "consumptionPerHourSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1499 - "consumptionIdleSeasonalBegin": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1500 - "consumptionIdleSeasonalEnd": "2024-10-30T08:11:35.622Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1501 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега (0 - ByGps, 1 - ByMileageSensor) 1502 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1503 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1504 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1505 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1506 - "counters": { ~/~/ Dto для состояний счётчиков 1507 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1508 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1509 - "mileage": 0, ~/~/ Пробег 1510 - "motohours": 0 ~/~/ Моточасы 1511 - }, 1512 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1513 - "id": "string", ~/~/ CMSV6 Идентификатор 1514 - "enabled": true, ~/~/ Признак включения 1515 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1516 - "login": "string", ~/~/ CMSV6 имя учетной записи 1517 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1518 - }, 1519 - "inspectionTasks": [ ~/~/ Dto для описания задачи на ТО 1520 - { 1521 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1522 - "enabled": true, ~/~/ Признак включения 1523 - "name": "string", ~/~/ Имя задания 1524 - "description": "string", ~/~/ Описание задания 1525 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1526 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1527 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1528 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1529 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1530 - "kind": 0, ~/~/ Определяет вид периодичности ТО.( 0 - Дни, 1 - Месяцы , 2 - Годы) 1531 - "lastInspectionDate": "2024-10-30T08:11:35.622Z", ~/~/ Дата последнего ТО 1532 - "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 - однократно) 1533 1533 } 1534 - ], 1535 - "drivers": [ ~/~/ Список водителей. Определяет класс назначения водителя на объект. 1536 - { 1537 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1538 - "inputNumber": 0, ~/~/ № входа. 1539 - "createTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени создания назначения. 1540 - "comment": "string", ~/~/ Комментарий 1541 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1542 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1543 - "beginTime": "2024-10-30T08:11:35.622Z", ~/~/ Момент времени начала назначения. 1544 - "endTime": "2024-10-30T08:11:35.622Z" ~/~/ Момент времени окончания назначения. 1545 - } 1546 - ], 1547 - "commandTemplates": [ ~/~/ Список шаблонов команд 1548 - { 1549 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 1550 - "name": "string", ~/~/ Название шаблона команд 1551 - "command": "string", ~/~/ Команда на выполнение 1552 - "retries": 0 ~/~/ Лимит попыток отправки 1553 - } 1554 - ], 1555 - "sensors": [ ~/~/ Список датчиков 1556 - { 1557 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1558 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 1559 - "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 1560 - "name": "string", ~/~/ Имя датчика 1561 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 1562 - "inputNumber": 0, ~/~/ Номер входа 1563 - "pseudonym": "string", ~/~/ Псевдоним 1564 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 1565 - "isInverted": true, ~/~/ Признак инверсии 1566 - "disabled": true, ~/~/ Датчик не участвует в обработке 1567 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 1568 - "gradesTables": [ ~/~/ Тарировка 1569 - { 1570 - "grades": [ ~/~/ Таблицы тарировки 1571 - { 1572 - "input": 0, ~/~/ Вход 1573 - "output": 0 ~/~/ Выход 1574 - } 1575 - ], 1576 - "relevanceTime": "2024-10-30T08:11:35.622Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 1577 - } 1578 - ], 1579 - "showInTooltip": true, ~/~/ Отображение в подсказке 1580 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 1581 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1582 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1583 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 1584 - "expr": "string", ~/~/ Выражение 1585 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 1586 - "string" 1587 - ], 1588 - "customParams": { 1589 - "additionalProp1": "string", 1590 - "additionalProp2": "string", 1591 - "additionalProp3": "string" 1592 - }, 1593 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1594 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1595 - { 1596 - "from": 0, ~/~/ С какого значения 1597 - "color": "string", ~/~/ Каким цветом 1598 -))) 1599 1599 1600 -((( 1601 - "text": "string" ~/~/ Текст подписи к этому интервалу 1602 - } 1603 - ] 1604 - } 1605 - ], 1606 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1607 - "customFields": [ ~/~/ Список произвольных полей 1608 - { 1609 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1610 - "name": "string", ~/~/ Наименование произвольного поля 1611 - "value": "string", ~/~/ Значение произвольного поля 1612 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1613 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1614 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 1615 - } 1616 - ], 1617 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1618 -} 1619 -))) 1620 -))) 1621 -))) 1496 +(% style="text-align:left" %) 1497 +(% style="color:#000000" %)} 1622 1622 1623 - 1624 1624 **Валидация:** 1625 1625 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 1626 1626 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1627 1627 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1628 1628 1629 -== (% style="color:#000000; font-size:16px" %)**Получение списка объектовс основными параметрами**(%%) ==1504 +== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) == 1630 1630 1631 1631 (% class="box infomessage" %) 1632 1632 ((( ... ... @@ -1667,12 +1667,9 @@ 1667 1667 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1668 1668 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1669 1669 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1670 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1671 - "unitName": "string", ~/~/ Название подразделения (опционально) 1672 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1673 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1674 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1675 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1545 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1546 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1547 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1676 1676 } 1677 1677 1678 1678 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1679,14 +1679,8 @@ 1679 1679 1680 1680 (% style="color:#000000" %)Ответ: 1681 1681 1682 -(% style="color:#000000" %)[ 1683 -{ 1554 +(% style="color:#000000" %){ 1684 1684 1685 -((( 1686 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1687 -))) 1688 - 1689 -((( 1690 1690 (% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1691 1691 "name": "" ~/~/ наименование объекта 1692 1692 "imei": "" ~/~/ IMEI объекта ... ... @@ -1712,21 +1712,9 @@ 1712 1712 "forClient": true, ~/~/ право на отображение у клиента 1713 1713 "forTooltip": false, ~/~/ право на отображение в подсказке 1714 1714 "forReport": false ~/~/ право на отображение в отчетах 1715 -))) 1581 + }(%%) 1582 +(% style="color:#000000" %)} 1716 1716 1717 -((( 1718 - } 1719 - ], 1720 - "vehicleGroups": [ ~/~/ Группы ТС 1721 - { 1722 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1723 - "name": "string" ~/~/ Наименование группы ТС 1724 - } 1725 - ] 1726 - } 1727 -] 1728 -))) 1729 - 1730 1730 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1731 1731 1732 1732 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1758,11 +1758,13 @@ 1758 1758 "data": "", ~/~/ Данные 1759 1759 "overwrite": false, ~/~/ Флаг перезаписи 1760 1760 "stage": "", ~/~/ Состояние, может быть null 1615 + 1761 1761 (% style="color:#000000" %)} 1762 1762 1763 1763 (% style="color:#000000" %)Ответ: 1764 1764 1765 -(% style="color:#000000" %){(%%) 1620 +(% style="color:#000000" %){ 1621 + 1766 1766 "status": "", ~/~/ значение статуса 1767 1767 "date": "", ~/~/ Дата смены статуса 1768 1768 "description": "", ~/~/ Описание ... ... @@ -1769,10 +1769,34 @@ 1769 1769 "data": "", ~/~/ Данные 1770 1770 "overwrite": false, ~/~/ Флаг перезаписи 1771 1771 "stage": "", ~/~/ Состояние 1628 + 1629 +(% style="text-align:left" %) 1772 1772 (% style="color:#000000" %) } 1773 1773 1774 -== == 1632 +(% class="wikigeneratedid" id="H41843743C43543D43543D43843544144243044244344143043E43144A43543A442430" %) 1633 +**Отправить команду на терминал** 1775 1775 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 + 1776 1776 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1777 1777 1778 1778 (% class="box warningmessage" %) ... ... @@ -1860,7 +1860,8 @@ 1860 1860 "retries": 0 1861 1861 } 1862 1862 ], 1863 -"sensors": [ ~/~/ Датчики 1743 + 1744 + "sensors": [ ~/~/ Датчики 1864 1864 { 1865 1865 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 1866 1866 "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный ... ... @@ -1898,215 +1898,95 @@ 1898 1898 "additionalProp2": "string", 1899 1899 "additionalProp3": "string" 1900 1900 }, 1782 + 1901 1901 ~/~/ Характерные для произвольного: 1784 + 1902 1902 ~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1786 + 1903 1903 ~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1788 + 1904 1904 ~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1790 + 1905 1905 ~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1792 + 1906 1906 ~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1794 + 1907 1907 ~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1796 + 1908 1908 ~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1798 + 1909 1909 ~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1800 + 1910 1910 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1802 + 1911 1911 ~/~/ "ValueOn": "Вкл.", 1804 + 1912 1912 ~/~/ "ValueOff": "Выкл." 1913 1913 "summaryMaxValue": 0 ~/~/ Макс. значение 1914 - 1915 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1916 - { 1917 - "from": 0, ~/~/ С какого значения 1918 - "color": "string", ~/~/ Каким цветом 1919 - "text": "string" ~/~/ Текст подписи к этому интервалу 1920 - } 1921 - ] 1922 1922 } 1923 1923 ], 1924 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1925 - 1926 1926 "customFields": [ ~/~/ Произвольные поля 1927 - { 1928 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1929 - "name": "string", ~/~/ Наименование произвольного поля1930 - "value": "string", ~/~/ Значение произвольного поля1931 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1932 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1933 - "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 1934 1934 } 1935 1935 ] 1936 1936 } 1937 1937 1938 - 1939 1939 (% style="color:#000000" %)Ответ: 1940 1940 1941 -((( 1942 -{ 1943 - "vehicleId": 0, ~/~/ ID ТС 1944 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 1945 - "name": "string", ~/~/ Имя объекта 1946 - "imei": "string", ~/~/ IMEI 1947 - "deviceTypeId": 0, ~/~/ ID типа устройства 1948 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели 1949 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения 1950 - "sim1": "string", ~/~/ SIM1 1951 - "sim2": "string", ~/~/ SIM2 1952 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км 1953 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас 1954 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу 1955 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 1956 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 1957 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 1958 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 1959 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 1960 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 1961 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 1962 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 1963 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 1964 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor 1965 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1) 1966 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны? 1967 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат. 1968 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1969 - "counters": { ~/~/ состояний счётчиков 1970 - "mileageEnabled": true, ~/~/ Флаг включения счётчика "Пробег" 1971 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы" 1972 - "mileage": 0, ~/~/ Пробег 1973 - "motohours": 0 ~/~/ Моточасы 1974 - }, 1975 - "cmsv6Parameters": { ~/~/ Dto для CMSv6 1976 - "id": "string", ~/~/ CMSV6 Идентификатор 1977 - "enabled": true, ~/~/ Признак включения 1978 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1979 -))) 1823 +(% lang="en-US" style="text-align:left" %) 1824 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 1980 1980 1981 - 1982 -((( 1983 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол. 1984 - "login": "string", ~/~/ CMSV6 имя учетной записи 1985 - "password": "string" ~/~/ CMSV6 — пароль учетной записи 1986 - }, 1987 - "inspectionTasks": [ ~/~/ Задания на ТО 1988 - { 1989 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи 1990 - "enabled": true, ~/~/ Признак включения 1991 - "name": "string", ~/~/ Имя задания 1992 - "description": "string", ~/~/ Описание задания 1993 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах) 1994 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО 1995 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах) 1996 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО 1997 - "periodicCondition": 0, ~/~/ Условие периодичности по времени 1998 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы 1999 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО 2000 - "maxQuantity": 0 ~/~/ Условие по количеству записей для деактивации 2001 - } 2002 - ], 2003 - "drivers": [ ~/~/ Список водителей 2004 - { 2005 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 2006 - "inputNumber": 0, ~/~/ № входа. 2007 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения. 2008 - "comment": "string", ~/~/ Комментарий. 2009 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 2010 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 2011 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения. 2012 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения. 2013 - } 2014 - ], 2015 - "commandTemplates": [ ~/~/ Список шаблонов команд 2016 - { 2017 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона 2018 - "name": "string", ~/~/ Название шаблона команд 2019 - "command": "string", ~/~/ Команда на выполнение 2020 - "retries": 0 ~/~/ Лимит попыток отправки 2021 - } 2022 - ], 2023 - "sensors": [ ~/~/ Список датчиков 2024 - { 2025 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика 2026 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite 2027 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition, 2028 -))) 2029 - 2030 -((( 2031 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature, 2032 -))) 2033 - 2034 -((( 2035 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp, 2036 -))) 2037 - 2038 -((( 2039 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal, 2040 -))) 2041 - 2042 -((( 2043 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel, 2044 -))) 2045 - 2046 -((( 2047 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed 2048 - "name": "string", ~/~/ Имя датчика 2049 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse, 2050 -))) 2051 - 2052 -((( 2053 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual 2054 - "inputNumber": 0, ~/~/ Номер входа 2055 - "pseudonym": "string", ~/~/ Псевдоним 2056 - "medianDegree": 0, ~/~/ Степень медианной фильтрации 2057 - "isInverted": true, ~/~/ Признак инверсии 2058 - "disabled": true, ~/~/ Датчик не участвует в обработке 2059 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика. 0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs 2060 - "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 2061 2061 { 2062 - "grades": [ ~/~/ Таблицы тарировки 2063 - { 2064 - "input": 0, ~/~/ Вход 2065 - "output": 0 ~/~/ Выход 2066 - } 2067 - ], 2068 - "relevanceTime": "2024-10-30T10:31:17.196Z" ~/~/ Время, с которого наступает актуальность таблицы тарировки 2069 - } 2070 - ], 2071 - "showInTooltip": true, ~/~/ Отображение в подсказке 2072 - "showLastValid": true, ~/~/ Отображать последнее валидное значение 2073 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2074 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2075 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 2076 - "expr": "string", ~/~/ Выражение 2077 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков 2078 - "string" 2079 - ], 2080 - "customParams": { ~/~/ Дополнительные настройки 2081 - "additionalProp1": "string", 2082 - "additionalProp2": "string", 2083 - "additionalProp3": "string" 2084 - }, 2085 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 2086 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1847 + "id": ~/~/ идентификатор 1848 + "enabled": true, ~/~/ флаг включения 1849 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 1850 + "login": "", ~/~/ имя учетной записи 1851 + "password": "", ~/~/ пароль учетной записи 1852 + } 1853 + "inspectionTasks": ~/~/ задания на ТО 2087 2087 { 2088 - "from": 0, ~/~/ С какого значения 2089 - "color": "string", ~/~/ Каким цветом 2090 - "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": "", ~/~/ Сколько раз выполнить задание 2091 2091 } 2092 - ] 2093 - } 2094 - ], 2095 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 2096 - "customFields": [ ~/~/ Список произвольных полей 2097 - { 2098 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 2099 - "name": "string", ~/~/ Наименование произвольного поля 2100 - "value": "string", ~/~/ Значение произвольного поля 2101 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента 2102 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2103 - "forReport": true ~/~/ Отобразить произвольное поле в отчете 2104 - } 2105 - ], 2106 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 2107 -} 2108 -))) 2109 2109 1868 +(% lang="en-US" style="text-align:left" %) 1869 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 1870 + 2110 2110 **Валидация:** 2111 2111 - сезонный параметр может быть задан только если задана соответствующая обычная норма; 2112 2112 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; ... ... @@ -2151,9 +2151,12 @@ 2151 2151 2152 2152 (% style="color:#000000" %)Ответ: 2153 2153 2154 -(% style="color:#000000" %){(%%) 1915 +(% style="color:#000000" %){ 1916 + 2155 2155 "deviceTypeId" : "", ~/~/ ID типа устройства 2156 2156 "deviceTypeName" : "" ~/~/ Название типа устройства 1919 + 1920 +(% style="text-align:left" %) 2157 2157 (% style="color:#000000" %)} 2158 2158 2159 2159 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = ... ... @@ -2175,10 +2175,13 @@ 2175 2175 2176 2176 (% style="color:#000000" %)Ответ: 2177 2177 2178 -(% style="color:#000000" %){(%%) 1942 +(% style="color:#000000" %){ 1943 + 2179 2179 "id": "", ~/~/ ID типа датчика 2180 2180 "name": "", ~/~/ Название 2181 2181 "description": "", ~/~/ Описание 1947 + 1948 +(% style="text-align:left" %) 2182 2182 (% style="color:#000000" %)} 2183 2183 2184 2184 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) = ... ... @@ -2380,12 +2380,10 @@ 2380 2380 { 2381 2381 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2382 2382 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2383 - "mileage": 0, ~/~/ Пробег за период, километры 2384 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2385 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2386 - "motohours": 0, ~/~/ Моточасы за период, секунды 2387 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2388 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2150 + "mileageBegin": 0, ~/~/ Пробег на начало периода 2151 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 2152 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2153 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2389 2389 } 2390 2390 ] 2391 2391 } ... ... @@ -2434,12 +2434,6 @@ 2434 2434 } 2435 2435 ] 2436 2436 2437 -(% class="box warningmessage" %) 2438 -((( 2439 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2440 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2441 -))) 2442 - 2443 2443 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2444 2444 2445 2445 (% class="box infomessage" %) ... ... @@ -2503,42 +2503,74 @@ 2503 2503 Тело запроса: 2504 2504 2505 2505 { 2265 + 2506 2506 "vehicleIds": [ ], ~/~/ Список ID объектов 2267 + 2507 2507 "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2269 + 2508 2508 "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2271 + 2509 2509 "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2273 + 2510 2510 } 2511 2511 2512 2512 Ответ: 2513 2513 2514 -[ 2278 +[ 2279 + 2515 2515 { 2281 + 2516 2516 "vehicleId": 0, ~/~/ ID объекта 2283 + 2517 2517 "vehicleName": "string", ~/~/ Имя объекта 2285 + 2518 2518 "moves": [ ~/~/ Событие движения 2287 + 2519 2519 { 2289 + 2520 2520 "mileage": 0, ~/~/ Пробег, км 2291 + 2521 2521 "eventId": 0, ~/~/ Идентификатор события 2293 + 2522 2522 "eventName": "string", ~/~/ Название события 2295 + 2523 2523 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2297 + 2524 2524 "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2299 + 2525 2525 "duration": 0 ~/~/ Продолжительность события, секунд 2301 + 2526 2526 } 2303 + 2527 2527 ], 2305 + 2528 2528 "stops": [ ~/~/ События стоянок 2307 + 2529 2529 { 2530 - "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты 2309 + 2310 + "address": "string", ~/~/ Адрес события 2311 + 2531 2531 "eventId": 0, ~/~/ Идентификатор события 2313 + 2532 2532 "eventName": "string", ~/~/ Название события 2315 + 2533 2533 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2317 + 2534 2534 "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2319 + 2535 2535 "duration": 0 ~/~/ Продолжительность события, секунд 2321 + 2322 + 2536 2536 } 2324 + 2537 2537 ] 2326 + 2538 2538 } 2328 + 2539 2539 ] 2540 2540 2541 2541 2332 + 2542 2542 == (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) == 2543 2543 2544 2544 (% class="box infomessage" %) ... ... @@ -2575,6 +2575,7 @@ 2575 2575 } 2576 2576 2577 2577 2369 + 2578 2578 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2579 2579 2580 2580 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -2882,32 +2882,6 @@ 2882 2882 2883 2883 Success 2884 2884 2885 - 2886 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2887 - 2888 -(% class="box warningmessage" %) 2889 -((( 2890 -**PUT** /api/v3/notifications/prolongation 2891 -))) 2892 - 2893 -Метод позволяет продлить уведомления. 2894 - 2895 -Метод запроса **PUT** 2896 - 2897 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2898 - 2899 -В заголовках запроса: X-Auth: Токен авторизации. 2900 - 2901 -Тело запроса: 2902 - 2903 -[ 2904 - 2905 -0 2906 - 2907 -] 2908 - 2909 -где 0 идентификатор ids. 2910 - 2911 2911 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2912 2912 2913 2913 (% class="box errormessage" %) ... ... @@ -4098,7 +4098,7 @@ 4098 4098 **POST /api/v3/vehicles/import/{agentId}** 4099 4099 ))) 4100 4100 4101 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение*.xls)**или **wlp. **Также они могут находится в** zip-архиве(один файл - один архив).**3867 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 4102 4102 4103 4103 В пути указывается **agentId** - id клиента. 4104 4104 ... ... @@ -4110,7 +4110,7 @@ 4110 4110 4111 4111 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4112 4112 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 4113 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace- Замена,Merge- Слияние,Add- Добавление3879 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 4114 4114 4115 4115 В теле использовать тип **form-data,** тип значения** file** 4116 4116 ... ... @@ -4289,67 +4289,64 @@ 4289 4289 Тело запроса: 4290 4290 4291 4291 { 4292 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4293 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4294 - "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" 4295 4295 } 4296 4296 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 + 4297 4297 Ответ: 4298 4298 4299 4299 { 4300 - "items": [ ~/~/ Список в разрезе ТС4071 + "items": [ 4301 4301 { 4302 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода4303 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода4304 - "vehicleId": 0, ~/~/ ID ТС4305 - "vehicleName": "string", ~/~/ Название ТС4306 - "vehicleModel": "string", ~/~/ Модель ТС4307 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС4308 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС4309 - "totalViolations": 0, ~/~/ Нарушений всего4310 - "violationsByType": { ~/~/ Информация о нарушениях по типу4311 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4312 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4313 - "brakingViolations": 0, ~/~/ Нарушений торможения4314 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4315 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4316 - "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 4317 4317 }, 4318 - 4319 -((( 4320 - 4321 -))) 4322 - 4323 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4324 - "mileage": 0, ~/~/ Пробег, м 4325 - "tripsCount": 0, ~/~/ Кол-во рейсов 4326 - "trips": [ ~/~/ Информация по рейсу 4089 + "moveTime": 0, 4090 + "mileage": 0, 4091 + "tripsCount": 0, 4092 + "trips": [ 4327 4327 { 4328 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс4329 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс4330 - "violationsCount": 0, ~/~/ Всего нарушений4331 - "violationsByType": { ~/~/ Информация о нарушениях по типу4332 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости4333 - "accelerationViolations": 0, ~/~/ Нарушений ускорения4334 - "brakingViolations": 0, ~/~/ Нарушений торможения4335 - "turningViolations": 0, ~/~/ Нарушений опасного поворота4336 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения4337 - "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 4338 4338 }, 4339 - 4340 - "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4341 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4342 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4343 - "mileage": 0, ~/~/ Пробег, м 4344 - "motohours": 0, ~/~/ Моточасы, секунды 4345 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4346 - "startAddress": "string", ~/~/ Адрес начала рейса 4347 - "endAddress": "string", ~/~/ Адрес конца рейса 4348 - "drivers": [ ~/~/ Список водителей 4105 + "moveTime": 0, 4106 + "mileage": 0, 4107 + "motohours": 0, 4108 + "maxSpeed": 0, 4109 + "startAddress": "string", 4110 + "endAddress": "string", 4111 + "drivers": [ 4349 4349 { 4350 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4351 - "driverName": "string", ~/~/ФИО водителя4352 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки4113 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4114 + "driverName": "string", 4115 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4353 4353 } 4354 4354 ] 4355 4355 } ... ... @@ -4358,6 +4358,34 @@ 4358 4358 ] 4359 4359 } 4360 4360 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 + 4361 4361 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4362 4362 4363 4363 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) == ... ... @@ -4377,38 +4377,60 @@ 4377 4377 Параметры в теле запроса (JSON): 4378 4378 4379 4379 { 4171 + 4380 4380 "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4173 + 4381 4381 "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4382 - "ids": [ 4175 + 4176 + "ids": [ 4177 + 4383 4383 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4179 + 4384 4384 ], 4181 + 4385 4385 "timezone": 0 ~/~/Таймзона 4183 + 4386 4386 } 4387 4387 4388 - 4389 4389 Ответ: 4187 + 4390 4390 { 4189 + 4391 4391 "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4191 + 4392 4392 "driver": "string", ~/~/Водители, привязанные к ТК 4193 + 4393 4393 "object": "string", ~/~/Наименование ТС 4195 + 4394 4394 "amount": 0, ~/~/Количество топлива 4197 + 4395 4395 "amountDut": 0, ~/~/Количество по ДУТ 4199 + 4396 4396 "amountDiff": 0, ~/~/Разница, л 4201 + 4397 4397 "amountDiffPerc": 0, ~/~/Разница, % 4203 + 4398 4398 "summa": 0, ~/~/Стоимость, руб 4205 + 4399 4399 "serviceName": "string", ~/~/Тип топлива 4207 + 4400 4400 "price": 0, ~/~/Цена за литр, руб 4209 + 4401 4401 "cardName": "string", ~/~/Наименование ТК 4211 + 4402 4402 "cardNum": "string", ~/~/Номер ТК 4213 + 4403 4403 "operator": "string", ~/~/Оператор ТК 4215 + 4404 4404 "address": "string" ~/~/Адрес АЗС 4217 + 4405 4405 } 4406 4406 4407 4407 4408 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4221 +==== (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** ==== 4409 4409 4410 4410 4411 -== **Получение полных данных о ретрансляторе** == 4224 +==== **Получение полных данных о ретрансляторе** ==== 4412 4412 4413 4413 (% class="box infomessage" %) 4414 4414 ((( ... ... @@ -4420,27 +4420,44 @@ 4420 4420 4421 4421 Пример ответа: 4422 4422 4423 -{ 4236 +{ 4237 + 4424 4424 "description": "", ~/~/ Определяет описание 4239 + 4425 4425 "subscriberId": "", ~/~/ Подписчик 4241 + 4426 4426 "protocolType": 0, ~/~/ Тип протокола 4243 + 4427 4427 "isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4245 + 4428 4428 "address": "string", ~/~/ Адрес события 4247 + 4429 4429 "objects": [ ~/~/Объекты для ретрансляции 4430 -{ 4431 -"id": "", ~/~/ Идентификатор объекта ретрансляции 4432 -"name": "", ~/~/ Наименование объекта ретрансляции 4433 -"imei": "", ~/~/ IMEI объекта 4249 + 4250 +{ 4251 + 4252 +"id": "", ~/~/ Идентификатор объекта ретрансляции 4253 + 4254 +"name": "", ~/~/ Наименование объекта ретрансляции 4255 + 4256 +"imei": "", ~/~/ IMEI объекта 4257 + 4434 4434 "isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4259 + 4435 4435 } 4436 - ], 4437 -"id": "", ~/~/ идентификатор пользователя 4261 + 4262 + ], 4263 + 4264 +"id": "", ~/~/ идентификатор пользователя 4265 + 4438 4438 "parentId": "", ~/~/Guid родителя 4267 + 4439 4439 "deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4269 + 4440 4440 } 4441 4441 4442 4442 4443 -== **Удаление данных ретранслятора** == 4273 +==== **Удаление данных ретранслятора** ==== 4444 4444 4445 4445 (% class="box infomessage" %) 4446 4446 ((( ... ... @@ -4450,7 +4450,7 @@ 4450 4450 Параметр запроса: ID 4451 4451 4452 4452 4453 -== **Создание ретранслятора** == 4283 +==== **Создание ретранслятора** ==== 4454 4454 4455 4455 (% class="box infomessage" %) 4456 4456 ((( ... ... @@ -4459,45 +4459,77 @@ 4459 4459 4460 4460 Запрос: 4461 4461 4462 -{ 4292 + 4293 +{ 4294 + 4463 4463 "description": "", ~/~/ Описание 4296 + 4464 4464 "subscriberId": "", ~/~/ Подписчик 4298 + 4465 4465 "protocolType": 0, ~/~/ Тип протокола 4300 + 4466 4466 "address": "", ~/~/ Адрес ретрансляции 4302 + 4467 4467 "isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4304 + 4468 4468 "objects": [ ~/~/Объекты для ретрансляции 4469 -{ 4470 -"id": "", ~/~/ идентификатор пользователя 4306 + 4307 +{ 4308 + 4309 +"id": "", ~/~/ идентификатор пользователя 4310 + 4471 4471 "imei": "", ~/~/IMEI объекта 4472 -"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4312 + 4313 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4314 + 4473 4473 } 4316 + 4474 4474 ] 4318 + 4475 4475 } 4476 4476 4477 4477 4478 -Ответ: 4479 4479 4480 -{ 4323 +Ответ 4324 + 4325 +{ 4326 + 4481 4481 "description": "string", ~/~/ Определяет описание 4328 + 4482 4482 "subscriberId": "", ~/~/ идентификатор запроса 4330 + 4483 4483 "protocolType": 0, ~/~/ Тип протокола 4332 + 4484 4484 "isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4334 + 4485 4485 "address": "", ~/~/ Адрес события 4336 + 4486 4486 "objects": [ ~/~/Объекты для ретрансляции 4487 -{ 4488 -"id": "", ~/~/ идентификатор пользователя 4489 -"name": "string", ~/~/ Название уведомления 4490 -"imei": "string", ~/~/IMEI объекта 4491 -"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 + 4492 4492 } 4493 - ], 4494 -"id": "", ~/~/ идентификатор пользователя 4350 + 4351 + ], 4352 + 4353 +"id": "", ~/~/ идентификатор пользователя 4354 + 4495 4495 "parentId": "", ~/~/ Guid идентификатор родителя 4356 + 4496 4496 "deleted": true ~/~/ Признак удаления 4358 + 4497 4497 } 4498 4498 4499 4499 4500 -== **Редактирование ретранслятора** == 4362 +==== **Редактирование ретранслятора** ==== 4501 4501 4502 4502 (% class="box infomessage" %) 4503 4503 ((( ... ... @@ -4506,48 +4506,81 @@ 4506 4506 4507 4507 Пример запроса: 4508 4508 4509 -{ 4510 -"id": "", ~/~/ идентификатор пользователя 4371 +{ 4372 + 4373 +"id": "", ~/~/ идентификатор пользователя 4374 + 4511 4511 "description": "string", ~/~/ Определяет описание 4376 + 4512 4512 "subscriberId": "", ~/~/ идентификатор запроса 4378 + 4513 4513 "protocolType": 0, ~/~/ Тип протокола 4514 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4380 + 4381 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4382 + 4515 4515 "address": "string", ~/~/ Адрес события 4384 + 4516 4516 "objects": ~/~/Объекты для ретрансляции 4517 -[ 4518 -{ 4519 -"id": "", ~/~/ идентификатор пользователя 4386 + 4387 +[ 4388 + 4389 +{ 4390 + 4391 +"id": "", ~/~/ идентификатор пользователя 4392 + 4520 4520 "imei": "", ~/~/IMEI объекта 4521 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4394 + 4395 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4396 + 4522 4522 } 4398 + 4523 4523 ] 4400 + 4524 4524 } 4525 4525 4526 4526 4527 4527 Пример ответа: 4528 4528 4529 -{ 4406 +{ 4407 + 4530 4530 "description": "", ~/~/ Определяет описание 4409 + 4531 4531 "subscriberId": "", ~/~/ идентификатор запроса 4411 + 4532 4532 "protocolType": 0, ~/~/ Тип протокола 4533 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4413 + 4414 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4415 + 4534 4534 "address": "string", ~/~/ Адрес события 4417 + 4535 4535 "objects": [ ~/~/Объекты для ретрансляции 4536 -{ 4537 -"id": "", ~/~/ идентификатор пользователя 4538 -"name": "string", ~/~/ Название уведомления 4419 + 4420 +{ 4421 + 4422 +"id": "", ~/~/ идентификатор пользователя 4423 + 4424 +"name": "string", ~/~/ Название уведомления 4425 + 4539 4539 "imei": "", ~/~/IMEI объекта 4540 -"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4427 + 4428 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4429 + 4541 4541 } 4431 + 4542 4542 ], 4543 -"id": "", ~/~/ идентификатор пользователя 4433 + 4434 +"id": "", ~/~/ идентификатор пользователя 4435 + 4544 4544 "parentId": "", ~/~/ Guid идентификатор родителя 4437 + 4545 4545 "deleted": true ~/~/ Признак удаления 4439 + 4546 4546 } 4547 4547 4548 4548 4549 -== **Получение списка ретранслятора клиента** == 4550 4550 4444 +==== **Получение списка ретранслятора клиента** ==== 4445 + 4551 4551 (% class="box infomessage" %) 4552 4552 ((( 4553 4553 **POST /api/v3/retranslations/find** ... ... @@ -4555,32 +4555,53 @@ 4555 4555 4556 4556 Пример запроса: 4557 4557 4558 -{ 4559 -"id": "", ~/~/ идентификатор пользователя 4453 + 4454 +{ 4455 + 4456 +"id": "", ~/~/ идентификатор пользователя 4457 + 4560 4560 "search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4459 + 4561 4561 "parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4461 + 4562 4562 } 4563 4563 4564 -Ответ: 4565 4565 4566 -[ 4567 -{ 4465 + 4466 +Ответ 4467 + 4468 + 4469 +[ 4470 + 4471 +{ 4472 + 4568 4568 "description": "", ~/~/ Определяет описание 4474 + 4569 4569 "subscriberId": "", ~/~/ идентификатор запроса 4476 + 4570 4570 "protocolType": 0, ~/~/ Тип протокола 4571 -"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4478 + 4479 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4480 + 4572 4572 "address": "string", ~/~/ Адрес события 4573 -"id": "", ~/~/ идентификатор пользователя 4482 + 4483 +"id": "", ~/~/ идентификатор пользователя 4484 + 4574 4574 "parentId": "", ~/~/ Guid идентификатор родителя 4486 + 4575 4575 "deleted": true ~/~/ Признак удаления 4488 + 4576 4576 } 4490 + 4577 4577 ] 4578 4578 4579 4579 4580 -= (% style="color:#000000; font-size:18.6667px" %) **Раздел: Отчеты**(%%) =4494 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Отчеты**(%%) = 4581 4581 4582 -== **API для отчета по выгрузке комбайнов** == 4583 4583 4497 +==== **API для отчета по выгрузке комбайнов** ==== 4498 + 4499 + 4584 4584 (% class="box infomessage" %) 4585 4585 ((( 4586 4586 POST **/api/v3/Reports/harvesterUnloading** ... ... @@ -4588,70 +4588,134 @@ 4588 4588 4589 4589 Пример запроса: 4590 4590 4507 + 4591 4591 { 4509 + 4592 4592 "byTime": 0, ~/~/ Объединение событий по времени 4511 + 4593 4593 "byDist": 0, ~/~/ Объединение событий по расстоянию 4513 + 4594 4594 "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 4515 + 4595 4595 "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 4517 + 4596 4596 "showNearestObjects": true, ~/~/Показывать объекты рядом? 4519 + 4597 4597 "vehicleIds": [ ~/~/ Список id объектов для анализа 4521 + 4598 4598 0 4523 + 4599 4599 ], 4525 + 4600 4600 "from": "", ~/~/ Дата и время начало запроса 4527 + 4601 4601 "to": "", ~/~/ Дата и время окончания запроса 4529 + 4602 4602 "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 4531 + 4603 4603 } 4604 4604 4534 + 4535 + 4605 4605 Пример ответа: 4606 4606 4607 -[ 4538 + 4539 +[ 4540 + 4608 4608 { 4542 + 4609 4609 "harvesterName": "", ~/~/Комбайн, номер 4544 + 4610 4610 "harvesterId": 0, ~/~/Комбайн, id 4546 + 4611 4611 "harvesterModel": "", ~/~/ Модель комбайна 4612 -"hopperCapacity": 0, ~/~/ Объем бункера м3 4548 + 4549 + "hopperCapacity": 0, ~/~/ Объем бункера м3 4550 + 4613 4613 "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек 4552 + 4614 4614 "events": [ ~/~/Список событий в разрезе комбайна 4554 + 4615 4615 { 4556 + 4616 4616 "driverId": "", ~/~/Идентификатор водителя 4558 + 4617 4617 "driverName": "", ~/~/Водитель комбайна, ФИО 4560 + 4618 4618 "RFID": "", ~/~/ идентификатор карты-метки 4562 + 4619 4619 "rfidName": "", ~/~/Водитель комбайна, имя метки 4564 + 4620 4620 "vehicleId": 0, ~/~/идентификатор объекта 4566 + 4621 4621 "vehicleName": "string", ~/~/ Имя объекта 4568 + 4622 4622 "modelName": "string", ~/~/ Имя модели объекта 4570 + 4623 4623 "nearestVehicles": [ ~/~/Объекты рядом 4572 + 4624 4624 { 4574 + 4625 4625 "vehicleId": 0, ~/~/идентификатор объекта 4576 + 4626 4626 "vehicleName": "string" ~/~/ Имя объекта 4578 + 4627 4627 } 4580 + 4628 4628 ], 4582 + 4629 4629 "fields": [ ~/~/Поля, где происходила выгрузка 4584 + 4630 4630 { 4631 - "id": 0, ~/~/ идентификатор пользователя 4632 - "name": "string" ~/~/ имя пользователя 4586 + 4587 + "id": 0, ~/~/ идентификатор пользователя 4588 + 4589 + "name": "string" ~/~/ имя пользователя 4590 + 4633 4633 } 4592 + 4634 4634 ], 4594 + 4635 4635 "event": "string", ~/~/Событие 4596 + 4636 4636 "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода 4598 + 4637 4637 "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода 4600 + 4638 4638 "durationSeconds": 0, ~/~/Продолжительность события, в секундах 4602 + 4639 4639 "cultureName": "string", ~/~/ название культуры 4604 + 4640 4640 "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события) 4606 + 4641 4641 "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события) 4608 + 4642 4642 "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события) 4610 + 4643 4643 "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события) 4612 + 4644 4644 "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события) 4614 + 4645 4645 "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события) 4616 + 4646 4646 "issued": 0, ~/~/Выдано, бункеров 4618 + 4647 4647 "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера) 4620 + 4648 4648 "latitude": 0, ~/~/Широта 4622 + 4649 4649 "longitude": 0, ~/~/ Долгота 4624 + 4650 4650 "litresAway": 0, ~/~/Отдано, л 4626 + 4651 4651 "m3Away": 0 ~/~/Отдано, м3 4628 + 4652 4652 } 4630 + 4653 4653 ] 4632 + 4654 4654 } 4634 + 4655 4655 ] 4656 4656 4657 4657 ... ... @@ -4673,27 +4673,48 @@ 4673 4673 4674 4674 Ответ: 4675 4675 4676 -[ 4656 +[ 4657 + 4677 4677 { 4659 + 4678 4678 "recordTime": "", ~/~/Время записи 4661 + 4679 4679 "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4663 + 4680 4680 "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4665 + 4681 4681 "objectId": 0, ~/~/ID объекта, помещённого в корзину 4667 + 4682 4682 "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4669 + 4683 4683 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4671 + 4684 4684 "details": { ~/~/Список деталей объекта, помещённого в корзину 4685 - "items": [ ~/~/ 4673 + 4674 + "items": [ ~/~/ [ 4675 + 4686 4686 nullable: true ~/~/Детали 4677 + 4687 4687 { 4679 + 4688 4688 "name": "string", ~/~/наименование столбца 4681 + 4689 4689 "value": "string" ~/~/содержание столбца 4683 + 4690 4690 } 4685 + 4691 4691 ] 4687 + 4692 4692 }, 4693 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4689 + 4690 + "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4691 + 4694 4694 "string" 4693 + 4695 4695 ] 4695 + 4696 4696 } 4697 + 4697 4697 ] 4698 4698 4699 4699 ... ... @@ -4708,33 +4708,56 @@ 4708 4708 4709 4709 Пример запроса: 4710 4710 4712 + 4711 4711 [ 4712 -0 4714 + 4715 + 0 4716 + 4713 4713 ] 4714 - 4715 4715 4719 + 4716 4716 Пример ответа: 4717 4717 4718 -[ 4719 -{ 4722 +[ 4723 + 4724 + { 4725 + 4720 4720 "recordTime": "", ~/~/Время записи 4727 + 4721 4721 "userId": "", ~/~/Guid пользователя, добавившего объект в корзину 4729 + 4722 4722 "parentId": "", ~/~/Guid агента объекта, помещённого в корзину 4731 + 4723 4723 "objectId": 0, ~/~/ID объекта, помещённого в корзин 4733 + 4724 4724 "objectGuid": "", ~/~/Guid объекта, помещённого в корзину 4735 + 4725 4725 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4737 + 4726 4726 "details": { ~/~/Список деталей объекта, помещённого в корзину 4739 + 4727 4727 "items": [ ~/~/Детали 4741 + 4728 4728 { 4743 + 4729 4729 "name": "", ~/~/Имя свойства 4745 + 4730 4730 "value": "" ~/~/Значение свойства 4747 + 4731 4731 } 4749 + 4732 4732 ] 4751 + 4733 4733 }, 4753 + 4734 4734 "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4755 + 4735 4735 "" 4757 + 4736 4736 ] 4759 + 4737 4737 } 4761 + 4738 4738 ] 4739 4739 4740 4740 Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». ... ... @@ -4757,41 +4757,55 @@ 4757 4757 4758 4758 Пример запроса: 4759 4759 4760 -((( 4761 4761 [ 4762 -))) 4763 4763 4764 -((( 4765 4765 0 4766 -))) 4767 4767 4768 -((( 4769 4769 ] 4770 -))) 4771 4771 4772 4772 4773 4773 Пример ответа: 4774 4774 4775 4775 [ 4776 -{ 4794 + 4795 + { 4796 + 4777 4777 "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи 4798 + 4778 4778 "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину 4800 + 4779 4779 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину 4802 + 4780 4780 "objectId": 0, ~/~/ID объекта, помещённого в корзину 4804 + 4781 4781 "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину 4806 + 4782 4782 "objectType": 1, ~/~/Тип объекта, помещённого в корзину 4808 + 4783 4783 "details": { ~/~/Список деталей объекта, помещённого в корзину 4810 + 4784 4784 "items": [ ~/~/Детали 4812 + 4785 4785 { 4814 + 4786 4786 "name": "string", ~/~/Имя свойства 4816 + 4787 4787 "value": "string" ~/~/Значение свойства 4818 + 4788 4788 } 4820 + 4789 4789 ] 4822 + 4790 4790 }, 4824 + 4791 4791 "errors": [ ~/~/Список ошибок удаления/восстановления объекта 4826 + 4792 4792 "string" 4828 + 4793 4793 ] 4830 + 4794 4794 } 4832 + 4795 4795 ] 4796 4796 4797 4797