<
From version < 231.1 >
edited by Андрей Калиновский
on 2025/05/06 12:40
To version < 132.1 >
edited by Андрей Калиновский
on 2024/01/30 15:11
>
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -1,22 +1,5 @@
1 1  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
2 2  (((
3 -(% class="box warningmessage" %)
4 -(((
5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно
6 -просим вас соблюдать несколько простых правил при использовании API-команд:##
7 -)))
8 -
9 -* Формировать не более 3 отчётов одновременно.
10 -* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50.
11 -
12 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов.
13 -
14 -(% class="box infomessage" %)
15 -(((
16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя.
17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему.
18 -)))
19 -
20 20  **Содержание страницы:**
21 21  )))
22 22  
... ... @@ -31,20 +31,11 @@
31 31  
32 32  Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de.
33 33  
34 -(% style="color:#000000" %)− (%%)При **редактировании** любой записи (пользователь, объект и т.д) необходимо передавать все параметры записи в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!
17 +(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!
35 35  
36 -
37 -(% style="color:#000000; font-size:16px" %)**Рекомендации**
38 -
39 -- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период).
40 -
41 41  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) =
42 42  
43 -(% class="box warningmessage" id="H41043244243E44043843743044643844F" %)
44 -(((
45 -(% style="color:#000000; font-size:16px" %)**Авторизация**(%%)
46 -(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие)
47 -)))
21 +== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) ==
48 48  
49 49  (% class="box successmessage" %)
50 50  (((
... ... @@ -70,8 +70,12 @@
70 70  
71 71  (% lang="en-US" %)
72 72  (% style="color:#000000" %){
73 - "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации
74 - "User": "testuser" , ~/~/ имя пользователя(%%)
47 +
48 +(% lang="en-US" %)
49 +(% style="color:#000000" %) "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" , ~/~/ токен авторизации
50 + "User": "testuser" , ~/~/ имя пользователя
51 +
52 +(% lang="en-US" %)
75 75  }
76 76  
77 77  **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется.
... ... @@ -82,9 +82,6 @@
82 82  |(% style="width:215px" %)(% style="color:#000000" %)AuthId|(% style="width:861px" %)Токен авторизации
83 83  |(% style="width:215px" %)(% style="color:#000000" %)User|(% style="width:861px" %)Логин пользователя
84 84  
85 -(% class="wikigeneratedid" %)
86 -Также имеется возможность сквозной (/бесшовной) авторизации. Для этого к ссылке ( [[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}]])
87 -
88 88  == (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) ==
89 89  
90 90  (% class="box infomessage" %)
... ... @@ -123,41 +123,29 @@
123 123  Запрос должен содержать данные параметра "**agentId**"
124 124  
125 125  (% style="color:#000000" %)Ответ:
126 -
127 -(((
128 128  {
129 - "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID клиента
130 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID родителя
131 - "parentName": "string", ~/~/ Наименование агента
132 - "name": "string", ~/~/ Имя клиента
133 - "fullName": "string", ~/~/ ФИО клиента
134 - "agentInfoType": 0, ~/~/ Тип клиента ((% style="color:#000000" %)0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор(%%))
135 - "isForeign": true, ~/~/ Флаг "Иностранный контрагент"
136 - "district": "string", ~/~/ Район
137 - "region": "string", ~/~/ Область
138 - "city": "string", ~/~/ Город
139 - "email": "string", ~/~/ Email
140 - "director": "string", ~/~/ Руководитель
141 - "RegionalData": [ ~/~/ Определяет региональные сведения.
142 - {
143 - "Country": 0, ~/~/ Страна
144 - "groups": [ ~/~/ Список групп
145 - {
146 - "groupId": "string", ~/~/ Уникальный идентификатор группы 
147 - "fields": [ ~/~/ Список значений полей
148 - {
149 - "name": "string", ~/~/ Имя поля формы
150 - "value": "string" ~/~/ Значение поля формы
151 - }
152 - ]
153 - }
154 - ]
155 - }
156 - ]
157 -}
158 -)))
102 + "agentId": "",  (%%)
103 + "parentId": "",
104 + "parentName": "string",
105 + "name": "string",
106 + "fullName": "string",
107 + "agentInfoType": 0,
108 + "isForeign": true/false,
109 + "district": "string", 
110 + "region": "string",
111 + "city": "string",
112 + "inn": "string",
113 + "kpp": "string",
114 + "address": "string",
115 + "addressFact": "string",
116 + "email": "string",
117 + "director": "string",
118 + "bankName": "string",
119 + "bankBIK": "string",
120 + "bankRS": "string",
121 + "bankKS": "string"
122 + }
159 159  
160 -
161 161  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
162 162  |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 
163 163  |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя
... ... @@ -263,6 +263,7 @@
263 263   "bankKS": "string" ~/~/ корр. счёт
264 264  }
265 265  
229 +
266 266  Ответ:
267 267  
268 268  {
... ... @@ -456,6 +456,7 @@
456 456   ],
457 457   "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
458 458  }
423 +
459 459  {
460 460   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
461 461   "lastName": "string",
... ... @@ -469,8 +469,12 @@
469 469  
470 470  (% style="text-align:left" %)
471 471  (% style="color:#000000; font-weight:normal" %)Ответ:
472 -{     
473 - "id": "" , ~/~/ ID пользователя
437 +
438 +(% style="text-align:left" %)
439 +(% style="color:#000000; font-weight:normal" %){    
440 +
441 +(% style="text-align:left" %)
442 +(% style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя
474 474   "lastName": "" , ~/~/ Фамилия ,
475 475   "firstName": "" , ~/~/ Имя
476 476   "position": "" , ~/~/ Должность
... ... @@ -487,9 +487,11 @@
487 487   "kind": "" , ~/~/ тип аутентификации
488 488   "target": "" , ~/~/ в случае аутентификации по email - email-адрес
489 489   "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %), ~/~/ роли пользователя, перечислены названия групп пользователя
490 -}
491 491  
460 +(% style="text-align:left" %)
461 +(% style="color:#000000; font-weight:normal" %)}
492 492  
463 +
493 493  == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) ==
494 494  
495 495  (% class="box infomessage" %)
... ... @@ -509,16 +509,19 @@
509 509  
510 510  (% style="color:#000000" %)Параметры в теле запроса (JSON):
511 511  
512 -(% style="color:#000000" %){(%%)
483 +(% style="color:#000000" %){
484 +
513 513   "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента
514 514   "userId": "11111111-c384-43f8-8562-1c3d79a32303", ~/~/ ID пользователя, по которому фильтруется, null - неважно
515 515   "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно
516 516   "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно
489 +
517 517  (% style="color:#000000" %)}
518 518  
519 519  (% style="color:#000000" %)Ответ:
520 520  
521 521  (% style="color:#000000" %){         (%%)
495 +
522 522   "id": "" , ~/~/ идентификатор пользователя
523 523   "lastName": "" , ~/~/ фамилия
524 524   "firstName": "" , ~/~/ имя
... ... @@ -532,6 +532,7 @@
532 532   "sessionDuration":"", ~/~/ длительность сессии в минутах
533 533   "status": "1",  ~/~/ статус пользователя
534 534   "lastLogged": "", ~/~/ дата/время последней авторизации
509 +
535 535  (% style="color:#000000" %)}
536 536  
537 537  == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) ==
... ... @@ -605,8 +605,10 @@
605 605  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON):
606 606  
607 607  (% lang="en-US" style="text-align:left" %)
608 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){   
609 - "id": "" , ~/~/ ID пользователя 
583 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){  
584 +
585 +(% lang="en-US" style="text-align:left" %)
586 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ ID пользователя 
610 610   "lastName": "" , ~/~/ фамилия
611 611   "firstName": "" , ~/~/ имя
612 612   "position": "" , ~/~/ должность
... ... @@ -628,7 +628,9 @@
628 628   "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации
629 629   },
630 630   "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен
631 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя(%%)
608 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя
609 +
610 +(% lang="en-US" style="text-align:left" %)
632 632  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__
633 633  
634 634  (% lang="en-US" style="text-align:left" %)
... ... @@ -635,8 +635,10 @@
635 635  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~://
636 636  
637 637  (% lang="en-US" style="text-align:left" %)
638 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){     
639 - "id": "" , ~/~/ идентификатор пользователя
617 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){    
618 +
619 +(% lang="en-US" style="text-align:left" %)
620 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя
640 640   "lastName": "" , ~/~/ фамилия
641 641   "firstName": "" , ~/~/ имя
642 642   "position": "" , ~/~/ должность
... ... @@ -657,8 +657,10 @@
657 657   "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен
658 658   "target": "" , ~/~/ в случае аутентификации по email - email-адрес
659 659   "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя
660 -}
661 661  
642 +(% lang="en-US" style="text-align:left" %)
643 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
644 +
662 662  == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) ==
663 663  
664 664  (% class="box warningmessage" %)
... ... @@ -678,10 +678,12 @@
678 678  
679 679  (% style="color:#000000" %)Параметры в теле запроса (JSON):
680 680  
681 -(% style="color:#000000" %){(%%)
664 +(% style="color:#000000" %){
665 +
682 682   "status": "" , ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован)
683 683   "description": "" , ~/~/ описание
684 684   "data": "" , ~/~/ данные, связанные со сменой статуса
669 +
685 685  (% style="color:#000000" %)}
686 686  
687 687  (% style="text-align:left" %)
... ... @@ -703,7 +703,7 @@
703 703  (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON):
704 704  
705 705   [ 
706 - "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc",
691 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc",
707 707   "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1"
708 708   ]
709 709  
... ... @@ -1009,7 +1009,7 @@
1009 1009  
1010 1010  Ответ: В случае успеха **Success 200**
1011 1011  
1012 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =
997 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) =
1013 1013  
1014 1014  == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) ==
1015 1015  
... ... @@ -1038,17 +1038,6 @@
1038 1038  
1039 1039  (((
1040 1040  {
1041 -
1042 -(((
1043 - "showLineTrackWhenNoCoords": true,  ~/~/ Обозначать трек при отсутствии координат.
1044 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства
1045 -)))
1046 -
1047 -(((
1048 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink
1049 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC
1050 -)))
1051 -
1052 1052   "vehicleId": "", ~/~/ ID объекта
1053 1053   "name": "", ~/~/ Имя объекта
1054 1054   "imei": "", ~/~/ IMEI объекта
... ... @@ -1056,15 +1056,19 @@
1056 1056   "deviceTypeName": "", ~/~/ Название типа устройства
1057 1057   "sim1": "", ~/~/ Номер SIM1
1058 1058   "sim2": "", ~/~/ Номер SIM2
1033 +
1059 1059   "parentId": "", ~/~/ ID клиента-родителя
1060 1060   "parentName": "", ~/~/ Наименование клиента-родителя
1061 1061   "modelId": "", ~/~/ ID модели объекта
1062 1062   "modelName": "", ~/~/ Имя модели объекта
1038 +
1063 1063   "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения
1064 1064   "unitName": "string", ~/~/ Наименование подразделения
1065 1065   "status": 0, ~/~/ Статус объекта
1042 +
1066 1066   "createdAt": "", ~/~/ Дата создания объекта
1067 1067   },
1045 +
1068 1068  "customFields": [ ~/~/ Произвольные поля
1069 1069   {
1070 1070   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля
... ... @@ -1087,7 +1087,8 @@
1087 1087   "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас
1088 1088   "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на  моточас
1089 1089   "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х
1090 - "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х  
1068 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 
1069 +
1091 1091   "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания
1092 1092   "mileageCoeff": 0, ~/~/ коэффициент пробега
1093 1093   "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна
... ... @@ -1117,6 +1117,7 @@
1117 1117   "retries": 0 ~/~/ Количество попыток
1118 1118   }
1119 1119   ],
1099 +
1120 1120   "sensors": [ ~/~/ Датчики
1121 1121   {
1122 1122   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
... ... @@ -1143,7 +1143,6 @@
1143 1143   ],
1144 1144   "showInTooltip": true, ~/~/ Отображать в подсказке
1145 1145   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1146 - "color": "string", ~/~/ Код цвета датчиков
1147 1147   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1148 1148   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1149 1149   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1158,19 +1158,31 @@
1158 1158   },
1159 1159  
1160 1160  ~/~/ Характерные для произвольного:
1140 +
1161 1161  ~/~/  "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
1142 +
1162 1162  ~/~/  "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
1144 +
1163 1163  ~/~/  "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
1146 +
1164 1164  ~/~/  "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
1148 +
1165 1165  ~/~/  "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
1150 +
1166 1166  ~/~/  "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
1152 +
1167 1167  ~/~/  "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
1154 +
1168 1168  ~/~/  "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
1156 +
1169 1169  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
1158 +
1170 1170  ~/~/ "ValueOn": "Вкл.",
1160 +
1171 1171  ~/~/ "ValueOff": "Выкл."
1172 1172   "summaryMaxValue": 0 ~/~/ Макс. значение
1173 1173   }
1164 +
1174 1174   "drivers": [ ~/~/ Водители
1175 1175   {
1176 1176   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
... ... @@ -1179,6 +1179,7 @@
1179 1179   "isDefault": true ~/~/ По умолчанию
1180 1180   }
1181 1181   ],
1173 +
1182 1182   "inspectionTasks": [ ~/~/ Задания на тех. обслуживание
1183 1183   {
1184 1184   "id": "", ~/~/ ID  задания
... ... @@ -1195,27 +1195,19 @@
1195 1195   "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
1196 1196   }
1197 1197   ],
1198 -"statusHistory": [ ~/~/ История статусов
1190 +
1191 + "statusHistory": [ ~/~/ История статусов
1199 1199   {
1200 1200   "status": 0,
1201 1201   "date": "2023-05-22T09:57:39.562Z",
1202 1202   "description": "string",
1203 1203   "additionalInfo": "string"
1197 + }
1198 + ]
1204 1204  
1205 -(((
1206 1206  }
1207 - ],
1208 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
1209 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов.
1210 1210  )))
1211 1211  
1212 -(((
1213 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1214 -}
1215 -
1216 -)))
1217 -)))
1218 -
1219 1219  (% style="text-align:left" %)
1220 1220  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
1221 1221  
... ... @@ -1222,75 +1222,6 @@
1222 1222  (% style="text-align:left" %)
1223 1223  0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
1224 1224  
1225 -
1226 -== **Отправить команду на терминал** ==
1227 -
1228 -(% class="box successmessage" %)
1229 -(((
1230 -(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create**
1231 -)))
1232 -
1233 -Команда для отправки на тс.
1234 -
1235 -{  
1236 -"id": "", ~/~/идентификатор объекта (он же идентификатор ТС: vehicleId)
1237 -"command": "", ~/~/ Текст отправляемой команды
1238 -"retries": "", ~/~/ Количество попыток отправки на терминал
1239 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов). 
1240 -}
1241 -
1242 -В ответ получаем cmdid
1243 -
1244 -
1245 -== **Получить ответ на отправленную на ТС команду** ==
1246 -
1247 -(% class="box infomessage" %)
1248 -(((
1249 -(% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer**
1250 -)))
1251 -
1252 -Идентификатор команды: cmdId
1253 -
1254 -Запрос от терминала на ответ команды
1255 -
1256 -Пример ответ от терминала:
1257 -
1258 -ID= "" ~/~/ идентификатор объекта
1259 -Soft="" ~/~/ версия софта
1260 -GPS=4 ~/~/ тип трекера
1261 -Time=11:05:43 28.06.24 ~/~/ время запроса
1262 -Lat=45.056221 ~/~/ широта
1263 -Lon=39.035938 ~/~/ долгота
1264 -Speed=0.0 ~/~/ скорость
1265 -Course=181.4 ~/~/направление
1266 -
1267 -(((
1268 -== **Список отправленных объекту команд с ответами** ==
1269 -
1270 -(% class="box infomessage" %)
1271 -(((
1272 -(% lang="en-US" %)**GET**(%%)**/api/v3/Vehicles/cmd/{vehicleId}/history**
1273 -)))
1274 -
1275 -Идентификатор ТС: vehicleId
1276 -
1277 -В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала.
1278 -
1279 -Пример ответа терминала
1280 -
1281 -[ 
1282 -{    
1283 -"id": "", ~/~/ идентификатор пользователя
1284 -"commandText": "", ~/~/Текст команды.
1285 -"templateId": "", ~/~/Идентификатор шаблона
1286 -"updated": "", ~/~/ Время отправки  
1287 -"tryCount": 0, ~/~/ Количество попыток отправки команды
1288 -"answer": "", ~/~/ Ответ терминала.
1289 -"status": "" ~/~/ Статус отправки
1290 -}
1291 -]
1292 -)))
1293 -
1294 1294  == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) ==
1295 1295  
1296 1296  (% class="box successmessage" %)
... ... @@ -1310,11 +1310,6 @@
1310 1310  
1311 1311  (% style="color:#000000" %){
1312 1312  
1313 -
1314 -(((
1315 - "vehicleId": 0, ~/~/ ID ТС
1316 -)))
1317 -
1318 1318   "parentId": "" , ~/~/ ID клиента
1319 1319   "name": "" , ~/~/ имя ТС
1320 1320   "imei": "" , ~/~/ IMEI
... ... @@ -1335,6 +1335,7 @@
1335 1335   "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас
1336 1336   "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х
1337 1337   "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х
1248 +
1338 1338   "mileageCalcMethod": 0,
1339 1339   "mileageCoeff": 0,
1340 1340   "locationByCellId": true,
... ... @@ -1367,6 +1367,7 @@
1367 1367   "lastInspectionDate": "" , ~/~/ Дата последнего ТО (null - не указано)
1368 1368   "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
1369 1369   }
1281 +
1370 1370  "drivers": [ ~/~/ Водители
1371 1371   {
1372 1372   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
... ... @@ -1381,7 +1381,8 @@
1381 1381   "retries": 0
1382 1382   }
1383 1383   ],
1384 -"sensors": [ ~/~/ Датчики
1296 +
1297 + "sensors": [ ~/~/ Датчики
1385 1385   {
1386 1386   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
1387 1387   "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный
... ... @@ -1407,7 +1407,6 @@
1407 1407   ],
1408 1408   "showInTooltip": true, ~/~/ Отображать в подсказке
1409 1409   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1410 - "color": "string", ~/~/ код цвета датчиков
1411 1411   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1412 1412   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1413 1413   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1420,222 +1420,103 @@
1420 1420   "additionalProp2": "string",
1421 1421   "additionalProp3": "string"
1422 1422   },
1335 +
1423 1423  ~/~/ Характерные для произвольного:
1337 +
1424 1424  ~/~/  "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
1339 +
1425 1425  ~/~/  "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
1341 +
1426 1426  ~/~/  "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
1343 +
1427 1427  ~/~/  "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
1345 +
1428 1428  ~/~/  "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
1347 +
1429 1429  ~/~/  "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
1349 +
1430 1430  ~/~/  "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
1351 +
1431 1431  ~/~/  "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
1353 +
1432 1432  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
1355 +
1433 1433  ~/~/ "ValueOn": "Вкл.",
1434 -~/~/ "ValueOff": "Выкл."
1435 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления.
1436 1436  
1437 -(((
1438 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге
1439 - {
1440 - "from": 0, ~/~/ С какого значения
1441 - "color": "string", ~/~/ Каким цветом
1442 - "text": "string" ~/~/ Текст подписи к этому интервалу
1443 - }
1444 - ]
1358 +~/~/ "ValueOff": "Выкл."
1359 + "summaryMaxValue": 0 ~/~/ Макс. значение
1445 1445   }
1446 1446   ],
1447 -)))
1448 -
1449 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
1450 -
1451 -
1452 1452   "customFields": [ ~/~/ Произвольные поля
1453 1453   {
1454 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ System.Guid идентификатор элемента сущности
1455 - "name": "string", ~/~/ Наименование произвольного поля
1456 - "value": "string", ~/~/ Значение произвольного поля
1457 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента
1458 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
1459 - "forReport": true ~/~/ Отобразить произвольное поле в отчете
1460 -
1461 -(((
1462 - }
1463 - ],
1464 - "motohoursCalcMethod": 0 ~/~/  Вид расчета моточасов.
1465 -)))
1466 -
1467 -(((
1468 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1364 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
1365 + "name": "string",
1366 + "value": "string",
1367 + "forClient": true,
1368 + "forTooltip": true,
1369 + "forReport": true
1370 + }
1371 + ]
1469 1469  }
1470 -)))
1471 1471  
1472 -
1473 1473  (% style="color:#000000" %)Ответ:
1474 1474  
1376 +(% 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 ~/~/ Условие по количеству записей для деактивации
1378 + "vehicleId": "", ~/~/ID ТС 
1379 + "parentId": "", ~/~/Guid владельца ТС
1380 + "name": "", ~/~/Имя объекта
1381 + "imei": "", ~/~/IMEI
1382 + "deviceTypeId": "", ~/~/ID типа устройства
1383 + "modelId": "", ~/~/ID модели
1384 + "unitId": "", ~/~/ID подразделения
1385 + "sim1": "", ~/~/SIM1
1386 + "sim2": "", ~/~/SIM2
1387 + "consumptionPer100Km": "", ~/~/Расход топлива на 100 км
1388 + "consumptionIdle": "", ~/~/Расход топлива на холостом ходу
1389 + "counters": { ~/~/Счётчики
1390 + "mileageEnabled": true,
1391 + "motohoursEnabled": true,
1392 + "mileage": "",
1393 + "motohours": 345.0
1394 + },
1395 + "cmsv6Parameters": { ~/~/Параметры CmsV6
1396 + "id": null,
1397 + "enabled": true, ~/~/флаг включения
1398 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
1399 + "login": "", ~/~/ имя учетной записи
1400 + "password": "" ~/~/ пароль учетной записи
1401 + },
1402 + "inspectionTasks": { ~/~/ задания на ТО
1403 + "id": "", ~/~/ ID задачи
1404 + "enabled": false, ~/~/ Признак включения
1405 + "name": "", ~/~/ Имя задания
1406 + "description": "", ~/~/ Описание задания
1407 + "mileageCondition": "", ~/~/ Условие по пробегу
1408 + "lastMileage": "", ~/~/ Пробег (в метрах)
1409 + "motohoursCondition": "", ~/~/ Условие по моточасам
1410 + "lastMotohours": "", ~/~/ Моточасы
1411 + "periodicCondition": "", ~/~/ Условие периодичности по времени
1412 + "kind": "", ~/~/ Вид периодичности по времени 
1413 + "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 - "color": "string", ~/~/ код цвета датчиков
1582 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1583 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
1584 - "agrFunction": 0,  ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION
1585 - "expr": "string", ~/~/ Выражение
1586 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков
1587 - "string"
1588 - ],
1589 - "customParams": {
1590 - "additionalProp1": "string",
1591 - "additionalProp2": "string",
1592 - "additionalProp3": "string"
1593 - },
1594 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления.
1595 - "valueIntervals": [  ~/~/ Интервалы значений для подсветки в мониторинге
1596 - {
1597 - "from": 0, ~/~/ С какого значения
1598 - "color": "string", ~/~/ Каким цветом
1599 -)))
1600 1600  
1601 -(((
1602 - "text": "string" ~/~/ Текст подписи к этому интервалу
1603 - }
1604 - ]
1605 - }
1606 - ],
1607 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
1608 - "customFields": [ ~/~/ Список произвольных полей
1609 - {
1610 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности
1611 - "name": "string", ~/~/ Наименование произвольного поля
1612 - "value": "string", ~/~/ Значение произвольного поля
1613 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента
1614 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
1615 - "forReport": true ~/~/ Отобразить произвольное поле в отчете
1616 - }
1617 - ],
1618 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1619 -}
1620 -)))
1621 -)))
1622 -)))
1416 +(% style="text-align:left" %)
1417 +(% style="color:#000000" %)}
1623 1623  
1624 -
1625 1625  **Валидация:**
1626 1626  - сезонный параметр может быть задан только если задана соответствующая обычная норма;
1627 1627  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
1628 1628  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
1629 1629  
1424 +== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) ==
1630 1630  
1631 -(% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**
1632 -
1633 1633  (% class="box infomessage" %)
1634 1634  (((
1635 1635  (% lang="en-US" %)**POST /api/v3/vehicles/find**
1636 1636  )))
1637 1637  
1638 -(% style="color:#000000" %)Метод позволяет получить список доступных объектов мониторинга (транспортных средств) с их основными параметрами: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).
1431 +(% style="color:#000000" %)Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель).
1639 1639  
1640 1640  (% style="color:#000000" %)Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе:
1641 1641  
... ... @@ -1669,12 +1669,9 @@
1669 1669   "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально)
1670 1670   "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально)
1671 1671   "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально)
1672 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально)
1673 - "unitName": "string",  ~/~/ Название подразделения (опционально)
1674 - "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально)
1675 - "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально)
1676 - "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально)
1677 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные
1465 + "parentId": null, ~/~/ ID клиента (Guid, опционально)
1466 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)
1467 + "customFields": null ~/~/ значение любого из произвольных полей ТС
1678 1678  }
1679 1679  
1680 1680  (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
... ... @@ -1681,14 +1681,8 @@
1681 1681  
1682 1682  (% style="color:#000000" %)Ответ:
1683 1683  
1684 -(% style="color:#000000" %)[
1685 -{
1474 +(% style="color:#000000" %){
1686 1686  
1687 -(((
1688 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC
1689 -)))
1690 -
1691 -(((
1692 1692  (% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта
1693 1693   "name": "" ~/~/ наименование объекта
1694 1694   "imei": "" ~/~/ IMEI объекта
... ... @@ -1714,21 +1714,9 @@
1714 1714   "forClient": true, ~/~/ право на отображение у клиента
1715 1715   "forTooltip": false, ~/~/ право на отображение в подсказке
1716 1716   "forReport": false ~/~/ право на отображение в отчетах
1717 -)))
1501 + }(%%)
1502 +(% style="color:#000000" %)}
1718 1718  
1719 -(((
1720 - }
1721 - ],
1722 - "vehicleGroups": [  ~/~/ Группы ТС
1723 - {
1724 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности
1725 - "name": "string" ~/~/ Наименование группы ТС
1726 - }
1727 - ]
1728 - }
1729 -]
1730 -)))
1731 -
1732 1732  (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.
1733 1733  
1734 1734  == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) ==
... ... @@ -1760,11 +1760,13 @@
1760 1760   "data": "", ~/~/ Данные
1761 1761   "overwrite": false, ~/~/ Флаг перезаписи
1762 1762   "stage": "", ~/~/ Состояние, может быть null
1535 +
1763 1763  (% style="color:#000000" %)}
1764 1764  
1765 1765  (% style="color:#000000" %)Ответ:
1766 1766  
1767 -(% style="color:#000000" %){(%%)
1540 +(% style="color:#000000" %){
1541 +
1768 1768   "status": "", ~/~/ значение статуса
1769 1769   "date": "", ~/~/ Дата смены статуса 
1770 1770   "description": "", ~/~/ Описание
... ... @@ -1771,9 +1771,10 @@
1771 1771   "data": "", ~/~/ Данные
1772 1772   "overwrite": false, ~/~/ Флаг перезаписи
1773 1773   "stage": "", ~/~/ Состояние
1548 +
1549 +(% style="text-align:left" %)
1774 1774  (% style="color:#000000" %) }
1775 1775  
1776 -
1777 1777  == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==
1778 1778  
1779 1779  (% class="box warningmessage" %)
... ... @@ -1849,19 +1849,9 @@
1849 1849  
1850 1850  "drivers": [ ~/~/ Водители
1851 1851   {
1852 -
1853 -(((
1854 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор объекта.
1855 - "inputNumber": 0, ~/~/ № входа.
1856 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения.
1857 - "comment": "string", ~/~/ Комментарий.
1858 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения.
1859 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя.
1860 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения.
1861 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения.
1862 -)))
1863 -
1864 - } 
1627 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
1628 + "isDefault": true
1629 + }
1865 1865   ],
1866 1866   "commandTemplates": [ ~/~/ Шаблон команды
1867 1867   {
... ... @@ -1871,7 +1871,8 @@
1871 1871   "retries": 0
1872 1872   }
1873 1873   ],
1874 -"sensors": [ ~/~/ Датчики
1639 +
1640 + "sensors": [ ~/~/ Датчики
1875 1875   {
1876 1876   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
1877 1877   "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный
... ... @@ -1897,11 +1897,6 @@
1897 1897   ],
1898 1898   "showInTooltip": true, ~/~/ Отображать в подсказке
1899 1899   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1900 -
1901 -(((
1902 - "color": "string",** ~/~/ **Цвет датчика
1903 -)))
1904 -
1905 1905   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1906 1906   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1907 1907   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1914,225 +1914,95 @@
1914 1914   "additionalProp2": "string",
1915 1915   "additionalProp3": "string"
1916 1916   },
1678 +
1917 1917  ~/~/ Характерные для произвольного:
1680 +
1918 1918  ~/~/  "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
1682 +
1919 1919  ~/~/  "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
1684 +
1920 1920  ~/~/  "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
1686 +
1921 1921  ~/~/  "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
1688 +
1922 1922  ~/~/  "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
1690 +
1923 1923  ~/~/  "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
1692 +
1924 1924  ~/~/  "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
1694 +
1925 1925  ~/~/  "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
1696 +
1926 1926  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
1698 +
1927 1927  ~/~/ "ValueOn": "Вкл.",
1700 +
1928 1928  ~/~/ "ValueOff": "Выкл."
1929 1929   "summaryMaxValue": 0 ~/~/ Макс. значение
1930 -
1931 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге
1932 - {
1933 - "from": 0, ~/~/ С какого значения
1934 - "color": "string", ~/~/ Каким цветом
1935 - "text": "string" ~/~/ Текст подписи к этому интервалу
1936 - }
1937 - ]
1938 1938   }
1939 1939   ],
1940 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
1941 -
1942 1942   "customFields": [ ~/~/ Произвольные поля
1943 - {     
1944 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ System.Guid идентификатор элемента сущности
1945 - "name": "string", ~/~/ Наименование произвольного поля
1946 - "value": "string", ~/~/ Значение произвольного поля
1947 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента
1948 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
1949 - "forReport": true ~/~/ Отобразить произвольное поле в отчете
1706 + {
1707 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
1708 + "name": "string",
1709 + "value": "string",
1710 + "forClient": true,
1711 + "forTooltip": true,
1712 + "forReport": true
1950 1950   }
1951 -
1952 -(((
1953 - ],
1954 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1955 -)))
1956 -
1714 + ]
1957 1957  }
1958 1958  
1959 -
1960 1960  (% style="color:#000000" %)Ответ:
1961 1961  
1962 -(((
1963 -{
1964 - "vehicleId": 0, ~/~/ ID ТС
1965 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 
1966 - "name": "string", ~/~/ Имя объекта
1967 - "imei": "string", ~/~/ IMEI
1968 - "deviceTypeId": 0, ~/~/ ID типа устройства
1969 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели
1970 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения
1971 - "sim1": "string", ~/~/ SIM1
1972 - "sim2": "string", ~/~/ SIM2
1973 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км
1974 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас
1975 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу
1976 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км
1977 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас
1978 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу
1979 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км
1980 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км
1981 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас
1982 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас
1983 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х
1984 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х
1985 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor
1986 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1)
1987 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны?
1988 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат.
1989 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат.
1990 - "counters": { ~/~/ состояний счётчиков
1991 - "mileageEnabled": true,  ~/~/ Флаг включения счётчика "Пробег"
1992 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы"
1993 - "mileage": 0, ~/~/ Пробег
1994 - "motohours": 0 ~/~/ Моточасы 
1995 - },
1996 - "cmsv6Parameters": { ~/~/ Dto для CMSv6
1997 - "id": "string", ~/~/ CMSV6 Идентификатор
1998 - "enabled": true, ~/~/ Признак включения
1999 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 
2000 -)))
1719 +(% lang="en-US" style="text-align:left" %)
1720 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){    
2001 2001  
2002 -
2003 -(((
2004 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол.
2005 - "login": "string", ~/~/ CMSV6 имя учетной записи
2006 - "password": "string" ~/~/ CMSV6 — пароль учетной записи
2007 - },
2008 - "inspectionTasks": [ ~/~/ Задания на ТО
2009 - {
2010 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи
2011 - "enabled": true, ~/~/ Признак включения
2012 - "name": "string", ~/~/ Имя задания
2013 - "description": "string", ~/~/ Описание задания
2014 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах)
2015 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО
2016 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах)
2017 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО
2018 - "periodicCondition": 0, ~/~/ Условие периодичности по времени
2019 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы
2020 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО
2021 - "maxQuantity": 0  ~/~/ Условие по количеству записей для деактивации
2022 - }
2023 - ],
2024 - "drivers": [  ~/~/ Список водителей
2025 - {
2026 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта.
2027 - "inputNumber": 0, ~/~/ № входа.
2028 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения.
2029 - "comment": "string", ~/~/ Комментарий.
2030 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения.
2031 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя.
2032 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения.
2033 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения.
2034 - }
2035 - ],
2036 - "commandTemplates": [ ~/~/ Список шаблонов команд
2037 - {
2038 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона
2039 - "name": "string", ~/~/ Название шаблона команд
2040 - "command": "string", ~/~/ Команда на выполнение
2041 - "retries": 0 ~/~/ Лимит попыток отправки
2042 - }
2043 - ],
2044 - "sensors": [  ~/~/ Список датчиков 
2045 - {
2046 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
2047 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite
2048 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition,
2049 -)))
2050 -
2051 -(((
2052 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature,
2053 -)))
2054 -
2055 -(((
2056 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp,
2057 -)))
2058 -
2059 -(((
2060 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal,
2061 -)))
2062 -
2063 -(((
2064 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel,
2065 -)))
2066 -
2067 -(((
2068 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed
2069 - "name": "string", ~/~/ Имя датчика
2070 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse,
2071 -)))
2072 -
2073 -(((
2074 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual
2075 - "inputNumber": 0, ~/~/ Номер входа
2076 - "pseudonym": "string", ~/~/ Псевдоним
2077 - "medianDegree": 0, ~/~/ Степень медианной фильтрации
2078 - "isInverted": true, ~/~/ Признак инверсии
2079 - "disabled": true, ~/~/ Датчик не участвует в обработке
2080 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика.  0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs
2081 - "gradesTables": [ ~/~/ Тарировка
1722 +(% lang="en-US" style="text-align:left" %)
1723 + "vehicleId": "", ~/~/ ID ТС
1724 + "parentId": "", ~/~/ ID клиента
1725 + "name": "", ~/~/ имя ТС
1726 + "imei": "", ~/~/ IMEI
1727 + "deviceTypeId": "", ~/~/ типа устройства
1728 + "modelId": "", ~/~/ ID модели
1729 + "unitId": "", ~/~/ ID подразделения
1730 + "sim1": "", ~/~/ SIM 1
1731 + "sim2": "", ~/~/ SIM2
1732 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км
1733 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу
1734 + "counters": 
1735 + {
1736 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег»
1737 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы»
1738 + "mileage": "", ~/~/ пробег
1739 + "motohours": "", ~/~/ моточасы
1740 + }
1741 + "cmsv6Parameters": ~/~/ параметры CMSv6
2082 2082   {
2083 - "grades": [ ~/~/ Таблицы тарировки
2084 - {
2085 - "input": 0, ~/~/ Вход
2086 - "output": 0 ~/~/ Выход
2087 - }
2088 - ],
2089 - "relevanceTime": "2024-10-30T10:31:17.196Z"  ~/~/ Время, с которого наступает актуальность таблицы тарировки
2090 - }
2091 - ],
2092 - "showInTooltip": true, ~/~/ Отображение в подсказке
2093 - "showLastValid": true, ~/~/ Отображать последнее валидное значение
2094 -
2095 -(((
2096 - "color": "string", ~/~/ цвет уведомлений
2097 -)))
2098 -
2099 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
2100 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
2101 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 
2102 - "expr": "string", ~/~/ Выражение
2103 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков
2104 - "string" 
2105 - ],
2106 - "customParams": { ~/~/ Дополнительные настройки
2107 - "additionalProp1": "string",
2108 - "additionalProp2": "string",
2109 - "additionalProp3": "string"
2110 - },
2111 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления.
2112 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге
1743 + "id": ~/~/ идентификатор
1744 + "enabled": true, ~/~/ флаг включения
1745 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
1746 + "login": "", ~/~/ имя учетной записи
1747 + "password": "", ~/~/ пароль учетной записи
1748 + }
1749 + "inspectionTasks": ~/~/ задания на ТО
2113 2113   {
2114 - "from": 0, ~/~/ С какого значения
2115 - "color": "string", ~/~/ Каким цветом
2116 - "text": "string" ~/~/ Текст подписи к этому интервалу
1751 + "id": "", ~/~/ ID задания
1752 + "enabled": false, ~/~/ Признак включения
1753 + "name": "", ~/~/ Имя задания
1754 + "description": "", ~/~/ Описание задания
1755 + "mileageCondition": "", ~/~/ Условие по пробегу
1756 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО
1757 + "motohoursCondition": "", ~/~/ Условие по моточасам
1758 + "lastMotohours": "", ~/~/ Моточасы
1759 + "periodicCondition": "", ~/~/ Условие периодичности по времени
1760 + "kind": "", ~/~/ Вид периодичности по времени
1761 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание
2117 2117   }
2118 - ]
2119 - }
2120 - ],
2121 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
2122 - "customFields": [ ~/~/ Список произвольных полей
2123 - {
2124 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности
2125 - "name": "string", ~/~/ Наименование произвольного поля
2126 - "value": "string", ~/~/ Значение произвольного поля
2127 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента
2128 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
2129 - "forReport": true ~/~/ Отобразить произвольное поле в отчете
2130 - }
2131 - ],
2132 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor
2133 -}
2134 -)))
2135 2135  
1764 +(% lang="en-US" style="text-align:left" %)
1765 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
1766 +
2136 2136  **Валидация:**
2137 2137  - сезонный параметр может быть задан только если задана соответствующая обычная норма;
2138 2138  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
... ... @@ -2177,9 +2177,12 @@
2177 2177  
2178 2178  (% style="color:#000000" %)Ответ:
2179 2179  
2180 -(% style="color:#000000" %){(%%)
1811 +(% style="color:#000000" %){
1812 +
2181 2181   "deviceTypeId" : "", ~/~/ ID типа устройства
2182 2182   "deviceTypeName" : "" ~/~/ Название типа устройства
1815 +
1816 +(% style="text-align:left" %)
2183 2183  (% style="color:#000000" %)}
2184 2184  
2185 2185  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) =
... ... @@ -2201,10 +2201,13 @@
2201 2201  
2202 2202  (% style="color:#000000" %)Ответ:
2203 2203  
2204 -(% style="color:#000000" %){(%%)
1838 +(% style="color:#000000" %){
1839 +
2205 2205   "id": "", ~/~/ ID типа датчика 
2206 2206   "name": "", ~/~/ Название
2207 2207   "description": "", ~/~/ Описание
1843 +
1844 +(% style="text-align:left" %)
2208 2208  (% style="color:#000000" %)}
2209 2209  
2210 2210  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) =
... ... @@ -2291,13 +2291,8 @@
2291 2291  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
2292 2292  |protocolType|Тип протокола
2293 2293  |inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный
2294 -|inputNumber|(((
2295 -Номер входа
2296 -)))
1931 +|inputNumber|Номер входа
2297 2297  
2298 -(% class="wikigeneratedid" %)
2299 -Перечень 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/]]
2300 -
2301 2301  == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) ==
2302 2302  
2303 2303  (% class="box infomessage" %)
... ... @@ -2406,14 +2406,10 @@
2406 2406   {
2407 2407   "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 
2408 2408   "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 
2409 - "mileage": 0, ~/~/ Пробег за период, километры
2410 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 
2411 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры
2412 - "motohours": 0, ~/~/ Моточасы за период, секунды
2413 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды
2414 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды
2415 - "idlingTime": 0 ~/~/  Холостой ход за период, секунд
2416 -
2041 + "mileageBegin": 0, ~/~/ Пробег на начало периода
2042 + "mileageEnd": 0, ~/~/ Пробег на окончание периода
2043 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода
2044 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода
2417 2417   }
2418 2418   ]
2419 2419   }
... ... @@ -2457,19 +2457,11 @@
2457 2457   "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода
2458 2458   "fuelConsumption": 0, ~/~/ Расход топлива
2459 2459   "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении
2460 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне
2461 -
2462 2462   }
2463 2463   ]
2464 2464   }
2465 2465  ]
2466 2466  
2467 -(% class="box warningmessage" %)
2468 -(((
2469 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"".
2470 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling".
2471 -)))
2472 -
2473 2473  == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) ==
2474 2474  
2475 2475  (% class="box infomessage" %)
... ... @@ -2504,8 +2504,7 @@
2504 2504   "model": "string", ~/~/ Модель объекта
2505 2505   "fuels": [ ~/~/ Массив данным по заправкам и сливам
2506 2506   {
2507 - "event": 0, ~/~/ Тип события 0 - Other, 1 - Engine, 2 - Stop, 3 - FuelIn, 4 - FuelOut, 5 - Garbage, 6 - Grader, 8 - Otval, 9 - Sand, 10 - MixerLand, 11 - MixerMove, 12 - OpenCircuit, 13 - TechSpeed, 14 - Work, 15 - Braid, 16 - Broom, 17 - ReFuller, 18 - Crane, 19 - Power, 20 - TankFuelIn, 21 - TankFuelOut, 22 - BigStop, 23 - OverSpeed, 24 - Unloading, 25 - Warning, 26 - GarbageWork, 27 - Custom, 28 - CustomWork, 29 - GNSS, 30 - GrainIn, 31 - GrainOut, 32 - WeighingTerminal, 33 - Stopping, 34 - FertilizerWork, 35 - FertilizerRefueling
2508 -
2127 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив
2509 2509   "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало
2510 2510   "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание
2511 2511   "valueFuel": 0, ~/~/ Количество
... ... @@ -2517,11 +2517,11 @@
2517 2517  ]
2518 2518  
2519 2519  
2520 -== (% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов**(%%) ==
2139 +(% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов**
2521 2521  
2522 2522  (% class="box infomessage" %)
2523 2523  (((
2524 -**POST /api/v3/vehicles/moveStop**
2143 +**POST/api/v3/vehicles/moveStop**
2525 2525  )))
2526 2526  
2527 2527  Метод запроса: **POST**
... ... @@ -2534,78 +2534,73 @@
2534 2534  Тело запроса:
2535 2535  
2536 2536  {
2156 +
2537 2537   "vehicleIds": [ ], ~/~/ Список ID объектов
2158 +
2538 2538   "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса
2160 +
2539 2539   "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса
2162 +
2540 2540   "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
2164 +
2541 2541  }
2542 2542  
2167 +
2543 2543  Ответ:
2544 2544  
2545 -[ 
2170 +[
2171 +
2546 2546   {
2173 +
2547 2547   "vehicleId": 0, ~/~/ ID объекта
2175 +
2548 2548   "vehicleName": "string", ~/~/ Имя объекта
2177 +
2549 2549   "moves": [ ~/~/ Событие движения
2179 +
2550 2550   {
2181 +
2551 2551   "mileage": 0, ~/~/ Пробег, км
2183 +
2552 2552   "eventId": 0, ~/~/ Идентификатор события
2185 +
2553 2553   "eventName": "string", ~/~/ Название события
2187 +
2554 2554   "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события
2189 +
2555 2555   "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события
2191 +
2556 2556   "duration": 0 ~/~/ Продолжительность события, секунд
2193 +
2557 2557   }
2195 +
2558 2558   ],
2197 +
2559 2559   "stops": [ ~/~/ События стоянок
2199 +
2560 2560   {
2561 - "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты
2201 +
2202 + "address": "string", ~/~/ Адрес события
2203 +
2562 2562   "eventId": 0, ~/~/ Идентификатор события
2205 +
2563 2563   "eventName": "string", ~/~/ Название события
2207 +
2564 2564   "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события
2209 +
2565 2565   "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события
2211 +
2566 2566   "duration": 0 ~/~/ Продолжительность события, секунд
2567 - }
2568 - ]
2569 - }
2570 -]
2571 2571  
2572 2572  
2573 -== (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) ==
2215 + }
2574 2574  
2575 -(% class="box infomessage" %)
2576 -(((
2577 -**POST /api/v3/vehicles/getlastdata**
2578 -)))
2217 + ]
2579 2579  
2580 -Метод запроса: **POST**
2219 + }
2581 2581  
2582 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/getlastdata
2221 +]
2583 2583  
2584 -В заголовках запроса: X-Auth: Токен авторизации
2585 -
2586 -
2587 -В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую.
2588 -
2589 -Ответ:
2590 - {
2591 - "vehicleId": 0, ~/~/Идентификатор объекта.
2592 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта.
2593 - "vehicleNumber": "string",~/~/Номер объекта.
2594 - "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер
2595 - "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве.
2596 - "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
2597 - "speed": 0,~/~/Скорость объекта.
2598 - "course": 0,~/~/Курс движения [0;360]
2599 - "latitude": 0,~/~/Широта [-90°;90°].
2600 - "longitude": 0,~/~/Долгота [-180°;180°].
2601 - "address": "string",~/~/Адрес.
2602 - "geozones": [ ~/~/Сведения по геозонам.
2603 - {
2604 - "id": 0,
2605 - "name": "string"
2606 - }
2607 -
2608 -
2609 2609  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =
2610 2610  
2611 2611  == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) ==
... ... @@ -2734,35 +2734,6 @@
2734 2734   }
2735 2735  ]
2736 2736  
2737 -
2738 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) ==
2739 -
2740 -(% class="box successmessage" %)
2741 -(((
2742 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis**
2743 -)))
2744 -
2745 -(% style="color:#000000" %)Метод запроса: **PUT**
2746 -
2747 -Пример запроса:
2748 -
2749 -(((
2750 -{
2751 - "id": 0,  ~/~/ Идентификатор объекта геозоны
2752 - "name": "string",  ~/~/ Наименование объекта геозоны
2753 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Подразделение
2754 - "description": "string", ~/~/ Описание объекта геозоны
2755 - "beginCalc": "2025-04-24T12:10:28.751Z",  ~/~/ Дата начала расчетов для геозоны
2756 - "endCalc": "2025-04-24T12:10:28.751Z",  ~/~/ Дата окончания расчетов для геозоны
2757 - "settingsData": "string"  ~/~/ Параметры отображения в формате XML.
2758 -}
2759 -)))
2760 -
2761 -
2762 -Пример ответа:
2763 -
2764 -200 ~/~/ Success
2765 -
2766 2766  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =
2767 2767  
2768 2768  == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==
... ... @@ -2942,32 +2942,6 @@
2942 2942  
2943 2943  Success
2944 2944  
2945 -
2946 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) ==
2947 -
2948 -(% class="box warningmessage" %)
2949 -(((
2950 -**PUT** /api/v3/notifications/prolongation
2951 -)))
2952 -
2953 -Метод позволяет продлить уведомления.
2954 -
2955 -Метод запроса **PUT**
2956 -
2957 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation
2958 -
2959 -В заголовках запроса: X-Auth: Токен авторизации.
2960 -
2961 -Тело запроса:
2962 -
2963 -[
2964 -
2965 -0
2966 -
2967 -]
2968 -
2969 -где 0 идентификатор ids.
2970 -
2971 2971  == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) ==
2972 2972  
2973 2973  (% class="box errormessage" %)
... ... @@ -4158,7 +4158,7 @@
4158 4158  **POST /api/v3/vehicles/import/{agentId}**
4159 4159  )))
4160 4160  
4161 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).**
3720 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.**
4162 4162  
4163 4163  В пути указывается **agentId** - id клиента.
4164 4164  
... ... @@ -4170,7 +4170,7 @@
4170 4170  
4171 4171  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4172 4172  |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать.
4173 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление
3732 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление
4174 4174  
4175 4175  В теле использовать тип **form-data,** тип значения** file**
4176 4176  
... ... @@ -4247,44 +4247,6 @@
4247 4247  |producedCount|Кол-во успешно отправленных в шину данных сообщений
4248 4248  |msgCount|Кол-во обработанных сообщений всего
4249 4249  
4250 -
4251 -== **Импортировать историю ТС (Асинхронный запрос)** ==
4252 -
4253 -(% class="box successmessage" %)
4254 -(((
4255 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
4256 -)))
4257 -
4258 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4259 -
4260 -Метод запроса: **POST**
4261 -
4262 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
4263 -
4264 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
4265 -
4266 -
4267 -Ответ:
4268 -
4269 -{
4270 -
4271 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4272 -
4273 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса
4274 -
4275 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
4276 -
4277 - "Message": "string", ~/~/ Информация о выполнении запроса
4278 -
4279 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
4280 -
4281 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4282 -
4283 - "Data": "string" ~/~/ Данные
4284 -
4285 -}
4286 -
4287 -
4288 4288  == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) ==
4289 4289  
4290 4290  (% class="box infomessage" %)
... ... @@ -4302,59 +4302,10 @@
4302 4302   "message": "string"
4303 4303  }
4304 4304  
4305 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)(((
4306 -**Параметр**
4307 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)(((
4308 -**Описание**
4309 -)))
4310 -|(((
4311 -activity
4312 -)))|(((
4313 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет
4314 -)))
4315 -|(((
4316 -progress
4317 -)))|(((
4318 -Guid ТС
4319 -)))
3826 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3827 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет
3828 +|progress|Guid ТС
4320 4320  
4321 -== **Возвращает статус асинхронного запроса импорта истории ТС** ==
4322 -
4323 -(% class="box infomessage" %)
4324 -(((
4325 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
4326 -)))
4327 -
4328 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4329 -
4330 -Метод запроса: **GET**
4331 -
4332 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
4333 -
4334 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
4335 -
4336 -
4337 -Ответ:
4338 -
4339 -{
4340 -
4341 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4342 -
4343 - "Status": 0, ~/~/ Перечисление состояний выполения запроса
4344 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
4345 -
4346 - "Message": "string", ~/~/ Информация о выполнении запроса
4347 -
4348 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
4349 -
4350 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
4351 -
4352 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4353 -
4354 - "Data": "string" ~/~/ Данные
4355 -
4356 -}
4357 -
4358 4358  == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==
4359 4359  
4360 4360  (% class="box infomessage" %)
... ... @@ -4436,67 +4436,64 @@
4436 4436  Тело запроса:
4437 4437  
4438 4438  {
4439 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов
4440 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса
4441 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса
3911 + "vehicleIds": [vehicleId],
3912 + "from": "2023-11-22T09:29:48.051Z",
3913 + "to": "2023-11-22T09:29:48.051Z"
4442 4442  }
4443 4443  
3916 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3917 +|vehicleIds|Массив ID объектов
3918 +|from|Дата начала запроса
3919 +|to|Дата окончания запроса
3920 +
4444 4444  Ответ:
4445 4445  
4446 4446  {
4447 - "items": [  ~/~/ Список в разрезе ТС
3924 + "items": [
4448 4448   {
4449 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода
4450 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода
4451 - "vehicleId": 0, ~/~/ ID ТС
4452 - "vehicleName": "string", ~/~/ Название ТС
4453 - "vehicleModel": "string", ~/~/ Модель ТС
4454 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС
4455 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС
4456 - "totalViolations": 0, ~/~/ Нарушений всего
4457 - "violationsByType": { ~/~/ Информация о нарушениях по типу
4458 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости
4459 - "accelerationViolations": 0, ~/~/ Нарушений ускорения
4460 - "brakingViolations": 0, ~/~/ Нарушений торможения
4461 - "turningViolations": 0, ~/~/ Нарушений опасного поворота
4462 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения
4463 - "sensorViolations": 0 ~/~/ Нарушений по датчику
3926 + "from": "2023-11-22T09:29:48.052Z",
3927 + "to": "2023-11-22T09:29:48.052Z",
3928 + "vehicleId": 0,
3929 + "vehicleName": "string",
3930 + "vehicleModel": "string",
3931 + "penalty": 0,
3932 + "score": 0,
3933 + "totalViolations": 0,
3934 + "violationsByType": {
3935 + "overspeedingViolations": 0,
3936 + "accelerationViolations": 0,
3937 + "brakingViolations": 0,
3938 + "turningViolations": 0,
3939 + "dangerousDrivingViolations": 0,
3940 + "sensorViolations": 0
4464 4464   },
4465 -
4466 -(((
4467 -
4468 -)))
4469 -
4470 - "moveTime": 0, ~/~/ Продолжительность движения, сек
4471 - "mileage": 0, ~/~/ Пробег, м
4472 - "tripsCount": 0, ~/~/ Кол-во рейсов
4473 - "trips": [  ~/~/ Информация по рейсу
3942 + "moveTime": 0,
3943 + "mileage": 0,
3944 + "tripsCount": 0,
3945 + "trips": [
4474 4474   {
4475 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс
4476 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс
4477 - "violationsCount": 0, ~/~/ Всего нарушений
4478 - "violationsByType": { ~/~/ Информация о нарушениях по типу
4479 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости
4480 - "accelerationViolations": 0, ~/~/ Нарушений ускорения
4481 - "brakingViolations": 0, ~/~/ Нарушений торможения
4482 - "turningViolations": 0, ~/~/ Нарушений опасного поворота
4483 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения
4484 - "sensorViolations": 0 ~/~/ Нарушений по датчику
3947 + "penalty": 0,
3948 + "score": 0,
3949 + "violationsCount": 0,
3950 + "violationsByType": {
3951 + "overspeedingViolations": 0,
3952 + "accelerationViolations": 0,
3953 + "brakingViolations": 0,
3954 + "turningViolations": 0,
3955 + "dangerousDrivingViolations": 0,
3956 + "sensorViolations": 0
4485 4485   },
4486 -
4487 - "startDate": "2024-11-18T13:23:38.516Z",  ~/~/ Дата начала поездки
4488 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки
4489 - "moveTime": 0, ~/~/ Продолжительность движения, сек
4490 - "mileage": 0, ~/~/ Пробег, м
4491 - "motohours": 0, ~/~/ Моточасы, секунды
4492 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс
4493 - "startAddress": "string", ~/~/ Адрес начала рейса
4494 - "endAddress": "string", ~/~/ Адрес конца рейса
4495 - "drivers": [  ~/~/ Список водителей
3958 + "moveTime": 0,
3959 + "mileage": 0,
3960 + "motohours": 0,
3961 + "maxSpeed": 0,
3962 + "startAddress": "string",
3963 + "endAddress": "string",
3964 + "drivers": [
4496 4496   {
4497 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя
4498 - "driverName": "string", ~/~/ФИО водителя
4499 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки
3966 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3967 + "driverName": "string",
3968 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
4500 4500   }
4501 4501   ]
4502 4502   }
... ... @@ -4505,1747 +4505,34 @@
4505 4505   ]
4506 4506  }
4507 4507  
4508 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) =
3977 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3978 +|from|Дата начала запроса
3979 +|to|Дата  окончания
3980 +|vehicleId|ID объекта
3981 +|vehicleName|Имя объекта
3982 +|vehicleModel|Модель объекта
3983 +|penalty|Сумма штрафных баллов
3984 +|score|Оценка
3985 +|totalViolations|Суммарное количество нарушений
3986 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа
3987 +|overspeedingViolations|Превышение скорости
3988 +|accelerationViolations|Ускорение
3989 +|brakingViolations|Торможение
3990 +|turningViolations|Резкий поворот
3991 +|dangerousDrivingViolations|Резкое вождение
3992 +|sensorViolations|Нарушение по датчику
3993 +|moveTime|Время в движении
3994 +|mileage|Пробег
3995 +|tripsCount|Количество рейсов
3996 +|motohours|Моточасы
3997 +|maxSpeed|Максимальная скорость
3998 +|startAddress|Адрес начала рейса
3999 +|endAddress|Адрес окончания рейса
4000 +|drivers|Список водителей, которые были на объекте в течениии рейса
4001 +|driverGuid|Guid водителя
4002 +|driverName|Имя водителя
4003 +|driverRfid|Номер Карты-метки
4509 4509  
4510 -== (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==
4511 -
4512 -Транзакции по топливным картам можно получить при наличии права «Транзакции ТК». Метод позволяет получить транзакции по нескольким топливным картам.
4513 -
4514 -(% class="box infomessage" %)
4515 -(((
4516 -**POST /api/v3/fuelcards/transactions**
4517 -)))
4518 -
4519 -Метод запроса: POST
4520 -
4521 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards/transactions
4522 -\\В заголовках запроса: X-Auth: Токен авторизации
4523 -
4524 -Параметры в теле запроса (JSON):
4525 -
4526 -{
4527 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ Начало периода
4528 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ Конец периода
4529 - "ids": [ 
4530 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы топливных карт
4531 - ],
4532 - "timezone": 0 ~/~/ Часовой пояс
4533 -}
4534 -
4535 -
4536 -Ответ:
4537 - {
4538 - "date": "2024-04-11T10:41:02.265Z", ~/~/ Дата и время транзакции
4539 - "driver": "string", ~/~/ Водители, привязанные к ТК
4540 - "object": "string", ~/~/ Наименование ТС
4541 - "amount": 0, ~/~/ Количество топлива
4542 - "amountDut": 0, ~/~/ Количество по ДУТ
4543 - "amountDiff": 0, ~/~/ Разница, л
4544 - "amountDiffPerc": 0, ~/~/ Разница, %
4545 - "summa": 0, ~/~/ Стоимость, руб
4546 - "serviceName": "string", ~/~/ Тип топлива
4547 - "price": 0, ~/~/ Цена за литр, руб
4548 - "cardName": "string", ~/~/ Наименование ТК
4549 - "cardNum": "string", ~/~/ Номер ТК
4550 - "operator": "string", ~/~/ Оператор ТК
4551 - "address": "string" ~/~/ Адрес АЗС
4552 - }
4553 -
4554 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) ==
4555 -
4556 -(% class="box infomessage" %)
4557 -(((
4558 -**GET /api/v3/fuelcards**
4559 -)))
4560 -
4561 -Метод запроса: GET
4562 -
4563 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список
4564 -
4565 -Ответ:
4566 -
4567 -[
4568 - {
4569 - "Name": "string", ~/~/ Определяет наименование карты.
4570 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора.
4571 - "Number": "string", ~/~/ Определяет № карты.
4572 - "Enabled": true, ~/~/ Определяет признак активности карты.
4573 - "Description": "string", ~/~/ Определяет описание карты.
4574 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты
4575 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
4576 - "deleted": true ~/~/ Признак удаления
4577 - }
4578 -]
4579 -
4580 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
4581 -
4582 -
4583 -== **Получение полных данных о ретрансляторе** ==
4584 -
4585 -(% class="box infomessage" %)
4586 -(((
4587 -**GET ** **/api/v3/retranslations/{id}**
4588 -)))
4589 -
4590 -id - Идентификатор ретранслятора
4591 -
4592 -
4593 -Пример ответа:
4594 -
4595 -{  
4596 -"description": "", ~/~/ Поле описания ретранслятора
4597 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4598 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4599 -"isEnabled": true, ~/~/ Признак включения ретранслятора, Включен, true - включен, false - отключен
4600 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4601 -"objects": [ ~/~/ Объекты для ретрансляции
4602 -{      
4603 -"id": "",  ~/~/ Идентификатор объекта ретрансляции
4604 -"name": "", ~/~/ Наименование объекта ретрансляции
4605 -"imei": "", ~/~/ IMEI объекта  ретрансляции
4606 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4607 -}
4608 - ],  
4609 -"id": "", ~/~/ Идентификатор ретранслятора 
4610 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4611 -"deleted": "" ~/~/ Признак удаления ретранслятора: true - включен, false - отключен
4612 -}
4613 -
4614 -
4615 -== **Удаление данных ретранслятора** ==
4616 -
4617 -(% class="box infomessage" %)
4618 -(((
4619 -**DELETE** **/api/v3/retranslations/{id}**
4620 -)))
4621 -
4622 -id - Идентификатор ретранслятора
4623 -
4624 -
4625 -== **Создание ретранслятора** ==
4626 -
4627 -(% class="box infomessage" %)
4628 -(((
4629 -**POST ** **/api/v3/retranslations/{id}**
4630 -)))
4631 -
4632 -Запрос:
4633 -
4634 -{  
4635 -"description": "", ~/~/ Поле описания ретранслятора
4636 -"subscriberId": "", ~/~/ Идентификатор подписчика
4637 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4638 -"address": "", ~/~/ Адрес и порт принимающего сервера
4639 -"isEnabled": "", ~/~/ Признак включения ретранслятора, true - включен, false - отключен
4640 -"objects": [ ~/~/Объекты для ретрансляции
4641 -{      
4642 -"id": "", ~/~/ Идентификатор ретранслятора 
4643 -"imei": "", ~/~/ IMEI объекта ретрансляции
4644 -"isEnabled": ""  ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4645 -}
4646 - ]
4647 -}
4648 -
4649 -
4650 -Ответ:
4651 -
4652 -{  
4653 -"description": "", ~/~/ Поле описания ретранслятора
4654 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4655 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4656 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4657 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4658 -"objects": [ ~/~/ Объекты для ретрансляции
4659 -{      
4660 -"id": "", ~/~/ Идентификатор объекта ретрансляции     
4661 -"name": "string", ~/~/ Наименование объекта ретрансляции    
4662 -"imei": "", ~/~/ IMEI объекта ретрансляции
4663 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен  
4664 -}
4665 - ],
4666 -"id": "", ~/~/ Идентификатор ретранслятора   
4667 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4668 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4669 -}
4670 -
4671 -
4672 -== **Редактирование ретранслятора** ==
4673 -
4674 -(% class="box infomessage" %)
4675 -(((
4676 -**PUT** **/api/v3/retranslations**
4677 -)))
4678 -
4679 -Пример запроса:
4680 -
4681 -{  
4682 -"id": "", ~/~/ Идентификатор ретранслятора   
4683 -"description": "string", ~/~/ Поле описания ретранслятора
4684 -"subscriberId": "", ~/~/ Идентификатор подписчика
4685 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4686 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4687 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4688 -"objects": ~/~/ Объекты для ретрансляции
4689 -[    
4690 -{      
4691 -"id": "",  ~/~/ Идентификатор объекта ретрансляции 
4692 -"imei": "", ~/~/ IMEI объекта ретрансляции
4693 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4694 -}
4695 - ]
4696 -}
4697 -
4698 -
4699 -Пример ответа:
4700 -
4701 -{  
4702 -"description": "", ~/~/ Поле описания ретранслятора
4703 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4704 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4705 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4706 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4707 -"objects": [ ~/~/ Объекты для ретрансляции
4708 -{      
4709 -"id": "", ~/~/ Идентификатор объекта ретрансляции     
4710 -"name": "string", ~/~/ Наименование объекта ретрансляции    
4711 -"imei": "", ~/~/ IMEI объекта ретрансляции
4712 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен  
4713 -}
4714 - ],
4715 -"id": "", ~/~/ Идентификатор ретранслятора   
4716 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4717 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4718 -}
4719 -
4720 -
4721 -== **Получение списка ретранслятора клиента** ==
4722 -
4723 -(% class="box infomessage" %)
4724 -(((
4725 -**POST /api/v3/retranslations/find**
4726 -)))
4727 -
4728 -Пример запроса:
4729 -
4730 -{  
4731 -"id": "", ~/~/ Идентификатор ретранслятора   
4732 -"search": "string", ~/~/ Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
4733 -"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (обязательный параметр).
4734 -}
4735 -
4736 -Ответ:
4737 -
4738 -[ 
4739 -{    
4740 -"description": "", ~/~/ Поле описания ретранслятора
4741 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4742 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4743 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4744 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4745 -"id": "", ~/~/ Идентификатор ретранслятора   
4746 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4747 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4748 -}
4749 -]
4750 -
4751 -
4752 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Отчеты**(%%) =
4753 -
4754 -== **API для отчета по выгрузке комбайнов** ==
4755 -
4756 -(% class="box infomessage" %)
4757 -(((
4758 -**POST /api/v3/Reports/harvesterUnloading**
4759 -)))
4760 -
4761 -Пример запроса:
4762 -
4763 -{
4764 - "byTime": 0, ~/~/ Объединение событий по времени
4765 - "byDist": 0, ~/~/ Объединение событий по расстоянию
4766 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
4767 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
4768 - "showNearestObjects": true, ~/~/Показывать объекты рядом?
4769 - "vehicleIds": [ ~/~/ Список id объектов для анализа
4770 - 0
4771 - ],
4772 - "from": "", ~/~/ Дата и время начало запроса
4773 - "to": "", ~/~/ Дата и время окончания запроса
4774 - "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
4775 -}
4776 -
4777 -Пример ответа:
4778 -
4779 -[ 
4780 - {
4781 - "harvesterName": "", ~/~/Комбайн, номер
4782 - "harvesterId": 0, ~/~/Комбайн, id
4783 -"harvesterModel": "", ~/~/ Модель комбайна
4784 -"hopperCapacity": 0, ~/~/ Объем бункера м3
4785 - "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек
4786 - "events": [ ~/~/Список событий в разрезе комбайна
4787 - {
4788 - "driverId": "", ~/~/Идентификатор водителя
4789 - "driverName": "", ~/~/Водитель комбайна, ФИО
4790 - "RFID": "", ~/~/ идентификатор карты-метки
4791 - "rfidName": "", ~/~/Водитель комбайна, имя метки
4792 - "vehicleId": 0, ~/~/идентификатор объекта
4793 - "vehicleName": "string", ~/~/ Имя объекта
4794 - "modelName": "string", ~/~/ Имя модели объекта
4795 - "nearestVehicles": [ ~/~/Объекты рядом
4796 - {
4797 - "vehicleId": 0, ~/~/идентификатор объекта
4798 - "vehicleName": "string" ~/~/ Имя объекта
4799 - }
4800 - ],
4801 - "fields": [ ~/~/Поля, где происходила выгрузка
4802 - {
4803 - "id": 0, ~/~/ идентификатор пользователя 
4804 - "name": "string" ~/~/ имя пользователя 
4805 - }
4806 - ],
4807 - "event": "string", ~/~/Событие
4808 - "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода
4809 - "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода
4810 - "durationSeconds": 0, ~/~/Продолжительность события, в секундах
4811 - "cultureName": "string", ~/~/ название культуры
4812 - "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события)
4813 - "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события)
4814 - "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события)
4815 - "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события)
4816 - "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события)
4817 - "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события)
4818 - "issued": 0, ~/~/Выдано, бункеров
4819 - "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера)
4820 - "latitude": 0, ~/~/Широта
4821 - "longitude": 0, ~/~/ Долгота
4822 - "litresAway": 0, ~/~/Отдано, л
4823 - "m3Away": 0 ~/~/Отдано, м3
4824 - }
4825 - ]
4826 - }
4827 -]
4828 -
4829 -
4830 -== **Отчет трек-датчики** ==
4831 -
4832 -(% class="box infomessage" %)
4833 -(((
4834 -**POST /api/v3/Reports/sensorsWorks**
4835 -)))
4836 -
4837 -**Пример запроса:**
4838 -
4839 -{
4840 - "vehicleIds": [ ~/~/ Список ID объектов
4841 - 0
4842 - ],
4843 - "from": "2025-02-20T06:39:23.888Z",  ~/~/ Начало периода (локальное время клиента)
4844 - "to": "2025-02-20T06:39:23.888Z", ~/~/  Конец периода (локальное время клиента)
4845 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4846 -}
4847 -
4848 -**Пример ответа:**
4849 -
4850 -(((
4851 -{
4852 - "vehicleSensorWorks": [  ~/~/ Интервалы работы оборудования для конкретного ТС
4853 - {
4854 - "vehicleId": 0, ~/~/ Идентификатор ТС
4855 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 
4856 - {
4857 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования.
4858 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования.
4859 - "duration": 0, ~/~/  Продолжительность интервала в секундах.
4860 - "name": "string", ~/~/ Наименование оборудования.
4861 - "mileage": 0, ~/~/ Пробег за время работы оборудования.
4862 - "totalMileage": 0, ~/~/ Общий пробег.
4863 - "avgSpeed": 0 ~/~/ Средняя скорость.
4864 - }
4865 - ]
4866 - }
4867 - ]
4868 -}
4869 -
4870 -
4871 -== **Превышение скорости** ==
4872 -
4873 -(% class="box infomessage" %)
4874 -(((
4875 -**POST /api/v3/Reports/overSpeedDuration**
4876 -)))
4877 -
4878 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение).
4879 -
4880 -Пример запроса:
4881 -
4882 -(((
4883 -{
4884 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства
4885 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента)
4886 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента)
4887 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4888 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 
4889 -}
4890 -)))
4891 -
4892 -(((
4893 -
4894 -)))
4895 -
4896 -(((
4897 -Пример ответа:
4898 -)))
4899 -
4900 -(((
4901 -(((
4902 -[
4903 - {
4904 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/  Дата и время события 
4905 - "duration": 0, ~/~/ Продолжительность события в секундах 
4906 - "maxSpeed": 0, ~/~/ Максимальная скорость 
4907 - "speedLimit": 0 ~/~/ Ограничение скорости 
4908 - }
4909 -]
4910 -)))
4911 -)))
4912 -)))
4913 -
4914 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
4915 -
4916 -
4917 -== **Запрос списка полей** ==
4918 -
4919 -(% class="box successmessage" %)
4920 -(((
4921 -**POST /api/v3/agroLands/find**
4922 -)))
4923 -
4924 -Пример запроса:
4925 -
4926 -(((
4927 -(((
4928 -(((
4929 -{
4930 - "year": 0, ~/~/ Фильтр по году
4931 - "name": "string", ~/~/ Фильтр по названию
4932 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению
4933 -}
4934 -)))
4935 -)))
4936 -
4937 -
4938 -)))
4939 -
4940 -Пример ответа:
4941 -
4942 -(((
4943 -[
4944 - {
4945 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
4946 - "year": 0, ~/~/ Год поля
4947 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая
4948 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая
4949 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
4950 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
4951 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
4952 - "counts": { ~/~/ Счётчики с/х поля 
4953 - "fieldOperations": 0, ~/~/ Количество операций на поле
4954 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
4955 - "facts": 0 ~/~/ Счётчик факта
4956 - },
4957 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4958 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4959 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4960 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4961 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
4962 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
4963 - "planComment": "string", ~/~/ Комментарий к полю
4964 - "productivity": 0, ~/~/ Урожайность.
4965 - "id": 0, ~/~/ Идентификатор объекта геозоны
4966 - "name": "string", ~/~/ Название объекта геозоны
4967 - "type": 0, ~/~/ Тип объекта геозоны
4968 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
4969 - "fname": "string", ~/~/ Имя файла
4970 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
4971 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны
4972 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны
4973 - "description": "string", ~/~/ Описание объекта геозоны
4974 - "area": 0, ~/~/ Площадь, м2
4975 - "perimetr": 0, ~/~/ Периметр, м
4976 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд
4977 - }
4978 -]
4979 -
4980 -
4981 -== **Создание нового поля ** ==
4982 -
4983 -(% class="box successmessage" %)
4984 -(((
4985 -**POST /api/v3/agroLands**
4986 -)))
4987 -
4988 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 
4989 -X-agent  - ID клиента
4990 -
4991 -Пример запроса:
4992 -
4993 -(((
4994 -{
4995 - "extId": "string", 
4996 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля
4997 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля
4998 - "display": "string", ~/~/ Настройки отображения
4999 - "year": 0, ~/~/ Год поля
5000 - "name": "string", ~/~/ Наименование
5001 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5002 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая
5003 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая
5004 - "planComment": "string", ~/~/ Комментарий к полю
5005 - "cropRotations": [ ~/~/ Данные по севообороту
5006 - {
5007 - "landId": 0, ~/~/ ID поля
5008 - "landName": "string", ~/~/ Название поля
5009 - "year": 0, ~/~/ Год урожая
5010 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5011 - "cultureName": "string", ~/~/ Название культуры
5012 - "productivity": 0, ~/~/ Урожайность
5013 - "area": 0, ~/~/ Площадь поля, Га
5014 - "total": 0, ~/~/ Валовый сбор
5015 - "productivityFact": 0, ~/~/ Фактическая урожайность
5016 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5017 - "totalFact": 0, ~/~/ Фактический валовый сбор
5018 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ
5019 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева
5020 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая
5021 - "isyearplan": true, ~/~/ Годовой план 
5022 - "comment": "string" ~/~/ Комментарий
5023 - }
5024 - ]
5025 -}
5026 -)))
5027 -
5028 -(((
5029 -
5030 -)))
5031 -
5032 -Пример ответа:
5033 -
5034 -(((
5035 -(((
5036 -{
5037 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
5038 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5039 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5040 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5041 - "cropRotations": [ ~/~/ Данные по севообороту
5042 - {
5043 - "landId": 0, ~/~/ ID поля
5044 - "landName": "string", ~/~/ Название поля
5045 - "year": 0, ~/~/ Год урожая 
5046 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5047 - "cultureName": "string", ~/~/ Название культуры
5048 - "productivity": 0, ~/~/ Урожайность
5049 - "area": 0, ~/~/ Площадь поля, Га.
5050 - "total": 0, ~/~/ Валовый сбор
5051 - "productivityFact": 0, ~/~/ Фактическая урожайность
5052 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5053 - "totalFact": 0, ~/~/ Фактический валовый сбор
5054 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ
5055 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева
5056 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая
5057 - "isyearplan": true, ~/~/ годовой план 
5058 - "comment": "string" ~/~/ Комментарий
5059 - }
5060 - ],
5061 - "cropVegetation": [ ~/~/ История вегетации поля
5062 - {
5063 - "values": [  ~/~/ Данные вегетации и состояния посева
5064 - {
5065 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5066 - "ndvi": 0 ~/~/ Индекс вегетации
5067 - }
5068 - ],
5069 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5070 - {
5071 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5072 - "type": "string", ~/~/ Тип
5073 - "pictureid": "string" ~/~/ Идентификатор ресурса
5074 - }
5075 - ],
5076 - "states": [ ~/~/ Ключевые даты развития поля
5077 - {
5078 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5079 - "state": 0 ~/~/ Статус  0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5080 - }
5081 - ]
5082 - }
5083 - ],
5084 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая
5085 - "counts": {
5086 - "fieldOperations": 0, ~/~/ Количество операций на поле
5087 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5088 - "facts": 0 ~/~/ Счётчик факта
5089 - },
5090 - "planComment": "string", ~/~/ Комментарий к полю
5091 -)))
5092 -
5093 -(((
5094 - "productivity": 0, ~/~/ Урожайность.
5095 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5096 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая
5097 - "year": 0, ~/~/ Год поля
5098 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5099 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5100 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5101 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5102 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто
5103 - "id": 0, ~/~/ Идентификатор объекта геозоны
5104 - "name": "string", ~/~/ Название объекта геозоны
5105 - "type": 0, ~/~/ Тип объекта геозоны
5106 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5107 - "fname": "string", ~/~/ Имя файла
5108 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5109 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны
5110 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны
5111 - "description": "string", ~/~/ Описание объекта геозоны
5112 - "area": 0, ~/~/ Площадь, м2
5113 - "perimetr": 0, ~/~/ Периметр, м
5114 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд
5115 -}
5116 -
5117 -
5118 -)))
5119 -)))
5120 -)))
5121 -
5122 -== **Получение поля по id** ==
5123 -
5124 -(% class="box infomessage" %)
5125 -(((
5126 -**GET /api/v3/agroLands/{id}**
5127 -)))
5128 -
5129 -Пример запроса:
5130 -id  ~/~/ Идентификатор поля
5131 -
5132 -Пример ответа:
5133 -
5134 -(((
5135 -{
5136 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
5137 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5138 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5139 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5140 - "cropRotations": [ ~/~/ Данные по севообороту
5141 - {
5142 - "landId": 0, ~/~/ ID поля
5143 - "landName": "string", ~/~/ Название поля
5144 - "year": 0, ~/~/ Год урожая
5145 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5146 - "cultureName": "string", ~/~/ Название культуры
5147 - "productivity": 0, ~/~/ Урожайность
5148 - "area": 0, ~/~/ Площадь поля, Га
5149 - "total": 0, ~/~/ Валовый сбор
5150 - "productivityFact": 0, ~/~/ Фактическая урожайность
5151 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5152 - "totalFact": 0, ~/~/ Фактический валовый сбор
5153 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ
5154 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева
5155 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая
5156 - "isyearplan": true, ~/~/ План года 
5157 - "comment": "string" ~/~/ Комментарий
5158 - }
5159 - ],
5160 - "cropVegetation": [ ~/~/ История вегетации поля
5161 - {
5162 - "values": [ ~/~/ Данные вегетации и состояния посева
5163 - {
5164 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
5165 - "ndvi": 0 ~/~/ Индекс вегетации
5166 - }
5167 - ],
5168 - "resources": [  ~/~/ Данные о снимках для каждого значения NDVI
5169 - {
5170 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
5171 - "type": "string", ~/~/ Тип 
5172 - "pictureid": "string" ~/~/ Идентификатор ресурса
5173 - }
5174 - ],
5175 - "states": [ ~/~/ Ключевые даты развития поля
5176 - {
5177 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 
5178 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая
5179 - }
5180 - ]
5181 - }
5182 - ],
5183 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая
5184 - "counts": {
5185 - "fieldOperations": 0, ~/~/ Количество операций на поле
5186 - "actualFieldOperations": 0,  ~/~/ Кол-во актуальных операций на поле
5187 - "facts": 0 ~/~/ Счётчик факта
5188 - },
5189 - "planComment": "string", ~/~/ Комментарий к полю
5190 - "productivity": 0, ~/~/ Урожайность.
5191 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5192 -)))
5193 -
5194 -(((
5195 -(((
5196 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая
5197 - "year": 0, ~/~/ Год поля
5198 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 
5199 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5200 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5201 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5202 - "status": 0,  ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5203 - "id": 0, ~/~/ Идентификатор объекта геозоны
5204 - "name": "string", ~/~/ Название объекта геозоны
5205 - "type": 0, ~/~/ Тип объекта геозоны 
5206 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5207 - "fname": "string", ~/~/ Имя файла
5208 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5209 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны
5210 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны
5211 - "description": "string", ~/~/ Описание объекта геозоны
5212 - "area": 0, ~/~/ Площадь, м2
5213 - "perimetr": 0, ~/~/ Периметр, м
5214 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд
5215 -}
5216 -)))
5217 -
5218 -
5219 -== **Удаление существующего поля** ==
5220 -
5221 -(% class="box errormessage" %)
5222 -(((
5223 -**DELETE /api/v3/agroLands/{id}**
5224 -)))
5225 -
5226 -Пример запроса:
5227 -id  ~/~/ Идентификатор поля
5228 -
5229 -Пример ответа:
5230 -
5231 -(((
5232 -200 ~/~/ Успех
5233 -)))
5234 -
5235 -(((
5236 -
5237 -)))
5238 -
5239 -(((
5240 -(((
5241 -(((
5242 -
5243 -)))
5244 -
5245 -(((
5246 -== **Изменение поля** ==
5247 -
5248 -(% class="box infomessage" %)
5249 -(((
5250 -**PUT /api/v3/agroLands**
5251 -)))
5252 -
5253 -Пример запроса:
5254 -
5255 -(((
5256 -(((
5257 -{
5258 - "id": 0, ~/~/ Идентификатор поля
5259 - "extId": "string", ~/~/ ExtId
5260 - "shape": "string", ~/~/ Форма поля
5261 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
5262 - "display": "string", ~/~/ Настройки отображения
5263 - "year": 0, ~/~/ Год поля
5264 - "name": "string", ~/~/ Наименование
5265 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5266 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая
5267 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая
5268 - "planComment": "string", ~/~/Комментарий к полю
5269 - "cropRotations": [  ~/~/ Данные по севообороту
5270 - {
5271 - "landId": 0, ~/~/ ID поля
5272 - "landName": "string", ~/~/ Название поля
5273 - "year": 0, ~/~/ Год урожая
5274 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5275 - "cultureName": "string", ~/~/ Название культуры
5276 - "productivity": 0, ~/~/ Урожайность
5277 - "area": 0, ~/~/ Площадь поля, Га.
5278 - "total": 0, ~/~/ Валовый сбор
5279 - "productivityFact": 0, ~/~/ Фактическая урожайность
5280 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5281 - "totalFact": 0, ~/~/ Фактический валовый сбор
5282 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ
5283 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева
5284 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая
5285 - "isyearplan": true, 
5286 - "comment": "string" ~/~/ Комментарий
5287 - }
5288 - ],
5289 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику
5290 -}
5291 -)))
5292 -)))
5293 -
5294 -(((
5295 -
5296 -)))
5297 -
5298 -Пример ответа:
5299 -
5300 -(((
5301 -(((
5302 -(((
5303 -{
5304 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
5305 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5306 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5307 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5308 - "cropRotations": [ ~/~/ Данные по севообороту
5309 - {
5310 - "landId": 0, ~/~/ ID поля
5311 - "landName": "string", ~/~/ Название поля
5312 - "year": 0, ~/~/  Год урожая
5313 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5314 - "cultureName": "string", ~/~/ Название культуры
5315 - "productivity": 0, ~/~/ Урожайность
5316 - "area": 0, ~/~/ Площадь поля, Га
5317 - "total": 0, ~/~/ Валовый сбор
5318 - "productivityFact": 0, ~/~/ Фактическая урожайность
5319 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5320 - "totalFact": 0, ~/~/ Фактический валовый сбор
5321 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ
5322 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева
5323 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая
5324 - "isyearplan": true, ~/~/ 
5325 - "comment": "string" ~/~/ Комментарий
5326 - }
5327 - ],
5328 - "cropVegetation": [ ~/~/ История вегетации поля
5329 - {
5330 - "values": [ ~/~/ Данные вегетации и состояния посева
5331 - {
5332 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5333 - "ndvi": 0 ~/~/ Индекс вегетации
5334 - }
5335 - ],
5336 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5337 - {
5338 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5339 - "type": "string", ~/~/ Тип
5340 - "pictureid": "string" ~/~/ Идентификатор ресурса
5341 - }
5342 - ],
5343 - "states": [ ~/~/ Ключевые даты развития поля 
5344 - {
5345 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5346 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5347 - }
5348 - ]
5349 - }
5350 - ],
5351 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая
5352 - "counts": { 
5353 - "fieldOperations": 0, ~/~/ Количество операций на поле
5354 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5355 - "facts": 0 ~/~/ Счётчик факта
5356 - },
5357 - "planComment": "string", ~/~/ Комментарий к полю
5358 - "productivity": 0, ~/~/ Урожайность.
5359 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5360 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая
5361 - "year": 0, ~/~/ Год поля
5362 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5363 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5364 - "factState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5365 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5366 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 
5367 - "id": 0, ~/~/ Идентификатор объекта геозоны
5368 - "name": "string", ~/~/ Название объекта геозоны
5369 - "type": 0, ~/~/ Тип объекта геозоны
5370 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5371 - "fname": "string", ~/~/ Имя файла
5372 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5373 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны
5374 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны
5375 - "description": "string", ~/~/ Описание объекта геозоны
5376 - "area": 0, ~/~/ Площадь, м2
5377 - "perimetr": 0, ~/~/ Периметр, м
5378 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд
5379 -}
5380 -)))
5381 -)))
5382 -)))
5383 -)))
5384 -)))
5385 -
5386 -
5387 -== **Редактирование года урожая ** ==
5388 -
5389 -(% class="box successmessage" %)
5390 -(((
5391 -**POST /api/v3/agroLands/updateOpenCloseYear**
5392 -)))
5393 -
5394 -Пример запроса:
5395 -
5396 -(((
5397 -(((
5398 -{
5399 - "agroLandIds": [  ~/~/ Идентификаторы полей для которых меняется год урожая
5400 - 0
5401 - ],
5402 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая
5403 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая
5404 -}
5405 -)))
5406 -
5407 -
5408 -)))
5409 -
5410 -Пример ответа:
5411 -
5412 -(((
5413 -(((
5414 -{
5415 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
5416 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5417 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5418 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5419 - "cropRotations": [ ~/~/ Данные по севообороту
5420 - {
5421 - "landId": 0, ~/~/ ID поля
5422 - "landName": "string", ~/~/ Название поля
5423 - "year": 0, ~/~/ Год урожая
5424 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5425 - "cultureName": "string", ~/~/ Название культуры
5426 - "productivity": 0, ~/~/ Урожайность
5427 - "area": 0, ~/~/ Площадь поля, Га.
5428 - "total": 0, ~/~/ Валовый сбор
5429 - "productivityFact": 0, ~/~/ Фактическая урожайность
5430 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5431 - "totalFact": 0, ~/~/ Фактический валовый сбор
5432 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ
5433 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева
5434 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая
5435 - "isyearplan": true, ~/~/ 
5436 - "comment": "string" ~/~/ Комментарий
5437 - }
5438 - ],
5439 - "cropVegetation": [ ~/~/ История вегетации поля
5440 - {
5441 - "values": [ ~/~/ Данные вегетации и состояния посева
5442 - {
5443 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
5444 - "ndvi": 0 ~/~/ Индекс вегетации
5445 - }
5446 - ],
5447 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5448 - {
5449 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
5450 - "type": "string", ~/~/ Тип
5451 - "pictureid": "string" ~/~/ Идентификатор ресурса
5452 - }
5453 - ],
5454 - "states": [ ~/~/ Ключевые даты развития поля
5455 - {
5456 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 
5457 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5458 - }
5459 - ]
5460 - }
5461 - ],
5462 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая
5463 - "counts": { 
5464 - "fieldOperations": 0, ~/~/ Количество операций на поле
5465 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5466 - "facts": 0 ~/~/ Счётчик факта
5467 - },
5468 - "planComment": "string", ~/~/ Комментарий к полю
5469 - "productivity": 0, ~/~/ Урожайность.
5470 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5471 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая
5472 - "year": 0, ~/~/ Год поля
5473 - "planState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5474 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5475 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5476 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5477 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
5478 - "id": 0, ~/~/ Идентификатор объекта геозоны
5479 - "name": "string", ~/~/ Название объекта геозоны
5480 - "type": 0, ~/~/ Тип объекта геозоны
5481 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5482 - "fname": "string", ~/~/ Имя файла
5483 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5484 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны
5485 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны
5486 - "description": "string", ~/~/ Описание объекта геозоны
5487 - "area": 0, ~/~/ Площадь, м2
5488 - "perimetr": 0, ~/~/ ериметр, м
5489 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
5490 -}
5491 -)))
5492 -
5493 -
5494 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
5495 -)))
5496 -)))
5497 -)))
5498 -
5499 -== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
5500 -
5501 -
5502 -(% class="box infomessage" %)
5503 -(((
5504 -**GET api/v3/Vehicles/recyclebin/all**
5505 -)))
5506 -
5507 -Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
5508 -
5509 -Параметр запроса: {parentId} - идентификатор агента
5510 -
5511 -В заголовках запроса: X-Auth: Токен авторизации
5512 -
5513 -Ответ:
5514 -
5515 -[ 
5516 - {
5517 - "recordTime": "", ~/~/Время записи
5518 - "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
5519 - "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
5520 - "objectId": 0, ~/~/ID объекта, помещённого в корзину
5521 - "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
5522 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5523 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5524 - "items": [ ~/~/ 
5525 -nullable: true ~/~/Детали
5526 - {
5527 - "name": "string", ~/~/наименование столбца
5528 - "value": "string" ~/~/содержание столбца
5529 - }
5530 - ]
5531 - },
5532 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5533 - "string"
5534 - ]
5535 - }
5536 -]
5537 -
5538 -
5539 -== (% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==
5540 -
5541 -(% class="box infomessage" %)
5542 -(((
5543 -**POST api/v3/Vehicles/recyclebin/erase**
5544 -)))
5545 -
5546 -В заголовках запроса: X-Auth: Токен авторизации
5547 -
5548 -Пример запроса:
5549 -
5550 -[
5551 -0
5552 -]
5553 -
5554 -
5555 -Пример ответа:
5556 -
5557 -[ 
5558 -{
5559 - "recordTime": "", ~/~/Время записи
5560 - "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
5561 - "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
5562 - "objectId": 0, ~/~/ID объекта, помещённого в корзин
5563 - "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
5564 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5565 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5566 - "items": [ ~/~/Детали
5567 - {
5568 - "name": "", ~/~/Имя свойства
5569 - "value": "" ~/~/Значение свойства
5570 - }
5571 - ]
5572 - },
5573 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5574 - ""
5575 - ]
5576 - }
5577 -]
5578 -
5579 -Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
5580 -
5581 -== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) ==
5582 -
5583 -(% class="box infomessage" %)
5584 -(((
5585 -**POST api/v3/Vehicles/recyclebin/restore**
5586 -)))
5587 -
5588 -В заголовках запроса: X-Auth: Токен авторизации
5589 -
5590 -Параметры в теле запроса (JSON):
5591 -
5592 -Восстанавливает объекты из корзины. Возвращает те объекты которые не получилось восстановить.
5593 -
5594 -В заголовках запроса: X-Auth: Токен авторизации
5595 -
5596 -
5597 -Пример запроса:
5598 -
5599 -(((
5600 -[
5601 -)))
5602 -
5603 -(((
5604 - 0
5605 -)))
5606 -
5607 -(((
5608 -]
5609 -)))
5610 -
5611 -
5612 -Пример ответа:
5613 -
5614 -[
5615 -{
5616 - "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи
5617 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину
5618 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину
5619 - "objectId": 0, ~/~/ID объекта, помещённого в корзину
5620 - "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину
5621 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5622 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5623 - "items": [ ~/~/Детали
5624 - {
5625 - "name": "string", ~/~/Имя свойства
5626 - "value": "string" ~/~/Значение свойства
5627 - }
5628 - ]
5629 - },
5630 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5631 - "string"
5632 - ]
5633 - }
5634 -]
5635 -
5636 -
5637 -= **Раздел: Журнал заданий ** =
5638 -
5639 -
5640 -== **Создание задания в Журнале заданий** ==
5641 -
5642 -(% class="box infomessage" %)
5643 -(((
5644 -**POST /api/v3/vehicletasks**
5645 -)))
5646 -
5647 -Пример запроса:
5648 -
5649 -(((
5650 -{
5651 - "vehicleId": 0, ~/~/ Идентификатор ТС
5652 - "description": "string", ~/~/ Описание
5653 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5654 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5655 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы
5656 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы
5657 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5658 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5659 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5660 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5661 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5662 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5663 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5664 - "cost": { 
5665 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5666 - "Name": "string", ~/~/ Наименование
5667 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection )
5668 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5669 - "Norm": 0 ~/~/ Норма внесения
5670 - },
5671 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 
5672 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5673 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания
5674 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления
5675 - "deleted": true, ~/~/ Признак удаления
5676 - "extId": "string", 
5677 - "GeoIds": [ ~/~/ Cвязанные поля
5678 - 0
5679 - ]
5680 -}
5681 -)))
5682 -
5683 -
5684 -Пример ответа:
5685 -
5686 -{
5687 - "vehicleId": 0, ~/~/ Идентификатор ТС
5688 - "description": "string", ~/~/ Описание
5689 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5690 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5691 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5692 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5693 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5694 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5695 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5696 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5697 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5698 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5699 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5700 - "cost": { 
5701 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5702 - "Name": "string", ~/~/ Наименование
5703 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5704 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5705 - "Norm": 0 ~/~/ Норма внесения
5706 - },
5707 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5708 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5709 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5710 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5711 - "deleted": true, ~/~/ Признак удаления
5712 - "extId": "string", ~/~/ ExtId
5713 - "GeoIds": [ ~/~/ Связанные поля
5714 - 0
5715 - ]
5716 -}
5717 -
5718 -
5719 -== **Редактирование задания в Журнале заданий** ==
5720 -
5721 -(% class="box successmessage" %)
5722 -(((
5723 -**PUT /api/v3/vehicletasks**
5724 -)))
5725 -
5726 -Пример запроса:
5727 -
5728 -(((
5729 -{
5730 - "vehicleId": 0, ~/~/ Идентификатор ТС
5731 - "description": "string", ~/~/ Описание
5732 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5733 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5734 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы
5735 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы
5736 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5737 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5738 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5739 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5740 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5741 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5742 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5743 - "cost": { 
5744 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5745 - "Name": "string", ~/~/ Наименование
5746 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5747 - "MeasureType": 0,  ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5748 - "Norm": 0 ~/~/ Норма внесения
5749 - },
5750 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5751 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5752 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания
5753 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления
5754 - "deleted": true, ~/~/ Признак удаления
5755 - "extId": "string", ~/~/ ExtId
5756 - "GeoIds": [ ~/~/ Связанные поля
5757 - 0
5758 - ]
5759 -}
5760 -)))
5761 -
5762 -
5763 -Пример ответа:
5764 -
5765 -{
5766 - "vehicleId": 0, ~/~/ Идентификатор ТС
5767 - "description": "string", ~/~/ Описание
5768 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5769 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5770 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5771 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5772 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5773 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5774 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5775 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5776 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5777 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5778 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5779 - "cost": { 
5780 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5781 - "Name": "string", ~/~/ Наименование
5782 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5783 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5784 - "Norm": 0 ~/~/ Норма внесения
5785 - },
5786 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5787 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5788 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5789 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5790 - "deleted": true, ~/~/ Признак удаления
5791 - "extId": "string", ~/~/ ExtId
5792 - "GeoIds": [ ~/~/ Связанные поля
5793 - 0
5794 - ]
5795 -}
5796 -
5797 -
5798 -== **Удаление задания в Журнале заданий** ==
5799 -
5800 -(% class="box warningmessage" %)
5801 -(((
5802 -**DELETE /api/v3/vehicletasks**
5803 -)))
5804 -
5805 -Пример запроса:
5806 -
5807 -(((
5808 -[
5809 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 
5810 -]
5811 -)))
5812 -
5813 -(((
5814 -
5815 -)))
5816 -
5817 -Пример ответа:
5818 -
5819 -{
5820 - "vehicleId": 0, ~/~/ Идентификатор ТС
5821 - "description": "string", ~/~/ Описание
5822 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5823 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5824 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5825 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5826 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5827 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5828 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5829 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5830 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5831 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5832 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5833 - "cost": { 
5834 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5835 - "Name": "string", ~/~/ Наименование
5836 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5837 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5838 - "Norm": 0 ~/~/ Норма внесения
5839 - },
5840 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5841 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5842 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5843 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5844 - "deleted": true, ~/~/ Признак удаления
5845 - "extId": "string", ~/~/ ExtId
5846 - "GeoIds": [ ~/~/ Связанные поля
5847 - 0
5848 - ]
5849 -}
5850 -
5851 -
5852 -== **Получение списка Журнала заданий** ==
5853 -
5854 -(% class="box infomessage" %)
5855 -(((
5856 -**POST /api/v3/vehicletasks/getbyperiod**
5857 -)))
5858 -
5859 -Пример запроса:
5860 -
5861 -(((
5862 -{
5863 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода.
5864 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода.
5865 - "TimeZone": 0, ~/~/ Часовой пояс.
5866 - "OperationsIds": [  ~/~/ Идентификаторы видов работ для фильтрации журнала
5867 - "3fa85f64-5717-4562-b3fc-2c963f66afa6"
5868 - ],
5869 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала
5870 - 0
5871 - ],
5872 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала
5873 - 0
5874 - ],
5875 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска.
5876 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 
5877 -}
5878 -)))
5879 -
5880 -
5881 -Пример ответа:
5882 -
5883 -(((
5884 -{
5885 - "total": 0,  ~/~/ Общее количество записей
5886 - "pages": 0,  ~/~/ Общее количество страниц
5887 - "currentPage": 0, ~/~/ Текущая страница
5888 - "items": [  ~/~/ Записи 
5889 - {
5890 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
5891 - "isGroup": true,  ~/~/ Вид задания (true - групповое, иначе - одиночное).
5892 - "name": "string", ~/~/ Название задания.
5893 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc
5894 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc
5895 - "workKind": "string", ~/~/ Вид работ
5896 - "techOp": "string", ~/~/ Тех. операция
5897 - "trailerModel": "string", ~/~/ Модель агрегата
5898 - "width": "string", ~/~/ Ширина, м
5899 - "speed": "string", ~/~/ Тех. скорость
5900 - "fields": "string", ~/~/ Поля
5901 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га)
5902 - "vehicles": "string", ~/~/ Объект-модель
5903 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов)
5904 - "drivers": "string", ~/~/ Водители
5905 - "tmc": "string", ~/~/ ТМЦ
5906 - "client": "string", ~/~/  Клиент
5907 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
5908 - "dep": "string", ~/~/ Подразделение
5909 - "geoIds": [ ~/~/  Связанные поля
5910 - 0
5911 - ]
5912 - }
5913 - ]
5914 -}
5915 -)))
5916 -
5917 -
5918 -= **Раздел: Локатор ** =
5919 -
5920 -
5921 -== **Получение списка локаторов, доступных пользователю ** ==
5922 -
5923 -(% class="box infomessage" %)
5924 -(((
5925 -**GET /api/v3/locators**
5926 -)))
5927 -
5928 -В заголовках запроса: X-Auth: Токен авторизации
5929 -
5930 -
5931 -Пример ответа:
5932 -
5933 -(((
5934 -[
5935 - {
5936 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор локатора.
5937 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
5938 - "agentName": "string", ~/~/ Наименование агента.
5939 - "isEnabled": true, ~/~/ Активен 
5940 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания
5941 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления
5942 - "name": "string", ~/~/ Наименование
5943 - "status": 0, ~/~/ 
5944 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 
5945 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 
5946 - "validity": 0, ~/~/ Срок действия в днях (1-90).
5947 - "autoProlongation": true, ~/~/ Автопродление срока действия.
5948 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
5949 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
5950 - "url": "string", ~/~/ Ссылка
5951 - "language": 0, ~/~/ Язык.
5952 - "vehiclesCount": 0, ~/~/ Количество объектов.
5953 - "geozonesCount": 0, ~/~/ Количество геозон.
5954 - "fieldsCount": 0 ~/~/ Количество полей.
5955 - }
5956 -]
5957 -)))
5958 -
5959 -
5960 -
5961 -== **Создание локатора** ==
5962 -
5963 -(% class="box successmessage" %)
5964 -(((
5965 -**POST /api/v3/locators**
5966 -)))
5967 -
5968 -Пример запроса:
5969 -
5970 -(((
5971 -{
5972 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
5973 - "isEnabled": true, ~/~/ Активность
5974 - "name": "string", ~/~/ Наименование локатора
5975 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени)
5976 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/  Время активации
5977 - "validity": 0, ~/~/ Срок действия в днях (1-90)
5978 - "autoProlongation": true, ~/~/ Автопродление срока действия.
5979 - "url": "string", ~/~/ Ссылка
5980 - "language": 0 ~/~/ Язык
5981 -}
5982 -)))
5983 -
5984 -
5985 -Пример ответа:
5986 -
5987 -(((
5988 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора
5989 -)))
5990 -
5991 -
5992 -
5993 -== **Изменение локатора** ==
5994 -
5995 -(% class="box infomessage" %)
5996 -(((
5997 -**PUT /api/v3/locators**
5998 -)))
5999 -
6000 -Пример запроса:
6001 -
6002 -(((
6003 -{
6004 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
6005 - "isEnabled": true, ~/~/ Активность 
6006 - "name": "string", ~/~/ Наименование
6007 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 
6008 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации
6009 - "validity": 0, ~/~/ Срок действия в днях (1-90)
6010 - "autoProlongation": true, ~/~/ Автопродление срока действия
6011 - "url": "string", ~/~/ Ссылка
6012 - "language": 0 ~/~/ Язык
6013 -}
6014 -)))
6015 -
6016 -
6017 -Пример ответа:
6018 -
6019 -200 ~/~/ Success
6020 -
6021 -
6022 -== **Удалить локатор** ==
6023 -
6024 -(% class="box warningmessage" %)
6025 -(((
6026 -**DELETE /api/v3/locators**
6027 -)))
6028 -
6029 -Пример запроса:
6030 -
6031 -(((
6032 -[
6033 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора
6034 -]
6035 -)))
6036 -
6037 -
6038 -
6039 -= **Раздел: Яндекс Маршруты** =
6040 -
6041 -
6042 -== **Возвращение списка маршрутов** ==
6043 -
6044 -(% class="box infomessage" %)
6045 -(((
6046 -**GET /api/v3/TransportRoutes**
6047 -)))
6048 -
6049 -Пример запроса:
6050 -Id  ~/~/ Идентификатор поля
6051 -
6052 -
6053 -Пример ответа:
6054 -
6055 -(((
6056 -[
6057 - {
6058 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 
6059 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6060 - "name": "string", ~/~/ Наименование маршрута.
6061 - "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6062 - "vehicles": [  ~/~/ Определяет список ТС для маршрута
6063 - 0
6064 - ]
6065 - }
6066 -]
6067 -)))
6068 -
6069 -
6070 -
6071 -== **Добавить маршрут** ==
6072 -
6073 -(% class="box infomessage" %)
6074 -(((
6075 -**POST /api/v3/TransportRoutes**
6076 -)))
6077 -
6078 -Пример запроса: 
6079 -{
6080 - "name": "string",  ~/~/  Опредлеляет наименование маршрута.
6081 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6082 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6083 - "vehicles": [  ~/~/ Определяет список ТС для маршрута
6084 - 0
6085 - ]
6086 -}
6087 -
6088 -
6089 -Пример ответа:
6090 -
6091 -(((
6092 -{
6093 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6094 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6095 - "name": "string", ~/~/ Определяет наименование маршрута 
6096 - "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 
6097 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6098 - 0
6099 - ]
6100 -}
6101 -)))
6102 -
6103 -
6104 -== **Обновление маршрута** ==
6105 -
6106 -(% class="box successmessage" %)
6107 -(((
6108 -**PUT /api/v3/TransportRoutes**
6109 -)))
6110 -
6111 -Пример запроса:
6112 -
6113 -(((
6114 -{
6115 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6116 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6117 - "name": "string", ~/~/ Опредлеляет наименование маршрута.
6118 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6119 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6120 - 0
6121 - ]
6122 -}
6123 -)))
6124 -
6125 -
6126 -Пример ответа:
6127 -
6128 -(((
6129 -{
6130 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6131 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6132 - "name": "string", ~/~/ Определяет наименование маршрута 
6133 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6134 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6135 - 0
6136 - ]
6137 -}
6138 -)))
6139 -
6140 -
6141 -== **Получить связки маршрутов ТС** ==
6142 -
6143 -(% class="box infomessage" %)
6144 -(((
6145 -**POST /api/v3/TransportRoutes/getroutesvehicles**
6146 -)))
6147 -
6148 -Пример запроса:
6149 -
6150 -(((
6151 -[
6152 - "3fa85f64-5717-4562-b3fc-2c963f66afa6"  ~/~/ идентификатор маршрута
6153 -]
6154 -)))
6155 -
6156 -
6157 -Пример ответа:
6158 -
6159 -(((
6160 -[
6161 - {
6162 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС
6163 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута
6164 - }
6165 -]
6166 -)))
6167 -
6168 -
6169 -== **Удалить маршрут** ==
6170 -
6171 -(% class="box warningmessage" %)
6172 -(((
6173 -**DELETE /api/v3/TransportRoutes/{id}**
6174 -)))
6175 -
6176 -Пример запроса:
6177 -Id  ~/~/ Идентификатор поля
6178 -
6179 -
6180 -==== ====
6181 -
6182 -= **Раздел: Управление доступа к машинам** =
6183 -
6184 -
6185 -== Получение списка транспортных средств видимых пользователю ==
6186 -
6187 -(% class="box infomessage" %)
6188 -(((
6189 -**GET /api/v3/UserVisibleVehicles/{userId}**
6190 -)))
6191 -
6192 -Пример ответа:
6193 -
6194 -(((
6195 -{
6196 - "vehicleIds": [  ~/~/ Идентификаторы ТС
6197 - 0
6198 - ]
6199 -}
6200 -)))
6201 -
6202 -
6203 -
6204 -== Задает видимость транспортных средств пользователю ==
6205 -
6206 -(% class="box infomessage" %)
6207 -(((
6208 -**POST /api/v3/UserVisibleVehicles**
6209 -)))
6210 -
6211 -Пример запроса:
6212 -
6213 -(((
6214 -(((
6215 -{
6216 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор пользователя
6217 - "vehicleIds": [ ~/~/ Идентификаторы ТС
6218 - 0
6219 - ]
6220 -}
6221 -)))
6222 -
6223 -(((
6224 -
6225 -)))
6226 -
6227 -(((
6228 -
6229 -)))
6230 -
6231 -(((
6232 -Пример ответа :
6233 -)))
6234 -
6235 -(((
6236 -
6237 -)))
6238 -
6239 -(((
6240 -200 ~/~/ Success
6241 -)))
6242 -)))
6243 -
6244 -
6245 -
6246 -
6247 -
6248 -
6249 6249  (% class="box" lang="en-US" style="text-align: center;" %)
6250 6250  (((
6251 6251  (% 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]] **

Меню

ГЛОНАССSoft wiki - 2024 г.