<
From version < 227.2 >
edited by Андрей Калиновский
on 2025/05/06 12:37
To version < 141.1 >
edited by Андрей Калиновский
on 2024/02/28 10:46
>
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,10 +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 -
1778 1778  == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==
1779 1779  
1780 1780  (% class="box warningmessage" %)
... ... @@ -1850,19 +1850,9 @@
1850 1850  
1851 1851  "drivers": [ ~/~/ Водители
1852 1852   {
1853 -
1854 -(((
1855 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор объекта.
1856 - "inputNumber": 0, ~/~/ № входа.
1857 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения.
1858 - "comment": "string", ~/~/ Комментарий.
1859 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения.
1860 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя.
1861 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения.
1862 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения.
1863 -)))
1864 -
1865 - } 
1627 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
1628 + "isDefault": true
1629 + }
1866 1866   ],
1867 1867   "commandTemplates": [ ~/~/ Шаблон команды
1868 1868   {
... ... @@ -1872,7 +1872,8 @@
1872 1872   "retries": 0
1873 1873   }
1874 1874   ],
1875 -"sensors": [ ~/~/ Датчики
1639 +
1640 + "sensors": [ ~/~/ Датчики
1876 1876   {
1877 1877   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
1878 1878   "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный
... ... @@ -1898,11 +1898,6 @@
1898 1898   ],
1899 1899   "showInTooltip": true, ~/~/ Отображать в подсказке
1900 1900   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1901 -
1902 -(((
1903 - "color": "string",** ~/~/ **Цвет датчика
1904 -)))
1905 -
1906 1906   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1907 1907   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1908 1908   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1915,225 +1915,95 @@
1915 1915   "additionalProp2": "string",
1916 1916   "additionalProp3": "string"
1917 1917   },
1678 +
1918 1918  ~/~/ Характерные для произвольного:
1680 +
1919 1919  ~/~/  "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
1682 +
1920 1920  ~/~/  "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
1684 +
1921 1921  ~/~/  "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
1686 +
1922 1922  ~/~/  "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
1688 +
1923 1923  ~/~/  "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
1690 +
1924 1924  ~/~/  "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
1692 +
1925 1925  ~/~/  "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
1694 +
1926 1926  ~/~/  "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
1696 +
1927 1927  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
1698 +
1928 1928  ~/~/ "ValueOn": "Вкл.",
1700 +
1929 1929  ~/~/ "ValueOff": "Выкл."
1930 1930   "summaryMaxValue": 0 ~/~/ Макс. значение
1931 -
1932 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге
1933 - {
1934 - "from": 0, ~/~/ С какого значения
1935 - "color": "string", ~/~/ Каким цветом
1936 - "text": "string" ~/~/ Текст подписи к этому интервалу
1937 - }
1938 - ]
1939 1939   }
1940 1940   ],
1941 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
1942 -
1943 1943   "customFields": [ ~/~/ Произвольные поля
1944 - {     
1945 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ System.Guid идентификатор элемента сущности
1946 - "name": "string", ~/~/ Наименование произвольного поля
1947 - "value": "string", ~/~/ Значение произвольного поля
1948 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента
1949 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
1950 - "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
1951 1951   }
1952 -
1953 -(((
1954 - ],
1955 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1956 -)))
1957 -
1714 + ]
1958 1958  }
1959 1959  
1960 -
1961 1961  (% style="color:#000000" %)Ответ:
1962 1962  
1963 -(((
1964 -{
1965 - "vehicleId": 0, ~/~/ ID ТС
1966 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС 
1967 - "name": "string", ~/~/ Имя объекта
1968 - "imei": "string", ~/~/ IMEI
1969 - "deviceTypeId": 0, ~/~/ ID типа устройства
1970 - "modelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID модели
1971 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения
1972 - "sim1": "string", ~/~/ SIM1
1973 - "sim2": "string", ~/~/ SIM2
1974 - "consumptionPer100Km": 0, ~/~/ Расход топлива на 100 км
1975 - "consumptionPerHour": 0, ~/~/ Расход топлива на моточас
1976 - "consumptionIdle": 0, ~/~/ Расход топлива на холостом ходу
1977 - "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км
1978 - "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас
1979 - "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу
1980 - "consumptionPer100KmSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км
1981 - "consumptionPer100KmSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км
1982 - "consumptionPerHourSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на моточас
1983 - "consumptionPerHourSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас
1984 - "consumptionIdleSeasonalBegin": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц начала работы сезонной нормы расхода на х/х
1985 - "consumptionIdleSeasonalEnd": "2024-10-30T10:31:17.196Z", ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х
1986 - "mileageCalcMethod": 0, ~/~/ Вид расчёта пробега. 0 - ByGps, 1 - ByMileageSensor
1987 - "mileageCoeff": 0, ~/~/ Коэффициент пробега при расчёте пробега по GPS (по умолчанию - 1)
1988 - "locationByCellId": true, ~/~/ Вычислять ли положение по базовым станциям, если координаты по GPS невалидны?
1989 - "dottedLineTrackWhenNoCoords": true, ~/~/ Обозначать пунктиром трек при отсутствии координат.
1990 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат.
1991 - "counters": { ~/~/ состояний счётчиков
1992 - "mileageEnabled": true,  ~/~/ Флаг включения счётчика "Пробег"
1993 - "motohoursEnabled": true, ~/~/ Флаг включения счётчика "Моточасы"
1994 - "mileage": 0, ~/~/ Пробег
1995 - "motohours": 0 ~/~/ Моточасы 
1996 - },
1997 - "cmsv6Parameters": { ~/~/ Dto для CMSv6
1998 - "id": "string", ~/~/ CMSV6 Идентификатор
1999 - "enabled": true, ~/~/ Признак включения
2000 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 
2001 -)))
1719 +(% lang="en-US" style="text-align:left" %)
1720 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){    
2002 2002  
2003 -
2004 -(((
2005 -~/~/ Порт также можно указать. В случае использования безопасного соединения необходимо указать протокол.
2006 - "login": "string", ~/~/ CMSV6 имя учетной записи
2007 - "password": "string" ~/~/ CMSV6 — пароль учетной записи
2008 - },
2009 - "inspectionTasks": [ ~/~/ Задания на ТО
2010 - {
2011 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID задачи
2012 - "enabled": true, ~/~/ Признак включения
2013 - "name": "string", ~/~/ Имя задания
2014 - "description": "string", ~/~/ Описание задания
2015 - "mileageCondition": 0, ~/~/ Условие по пробегу (в метрах)
2016 - "lastMileage": 0, ~/~/ Пробег (в метрах) на момент последнего ТО
2017 - "motohoursCondition": 0, ~/~/ Условие по моточасам (в секундах)
2018 - "lastMotohours": 0, ~/~/ Моточасы (в секундах) на момент последнего ТО
2019 - "periodicCondition": 0, ~/~/ Условие периодичности по времени
2020 - "kind": 0, ~/~/ Определяет вид периодичности ТО. 0 - Дни, 1 - Месяца, 2 - Годы
2021 - "lastInspectionDate": "2024-10-30T10:31:17.196Z", ~/~/ Дата последнего ТО
2022 - "maxQuantity": 0  ~/~/ Условие по количеству записей для деактивации
2023 - }
2024 - ],
2025 - "drivers": [  ~/~/ Список водителей
2026 - {
2027 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта.
2028 - "inputNumber": 0, ~/~/ № входа.
2029 - "createTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени создания назначения.
2030 - "comment": "string", ~/~/ Комментарий.
2031 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения.
2032 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя.
2033 - "beginTime": "2024-10-30T10:31:17.196Z", ~/~/ Момент времени начала назначения.
2034 - "endTime": "2024-10-30T10:31:17.196Z" ~/~/ Момент времени окончания назначения.
2035 - }
2036 - ],
2037 - "commandTemplates": [ ~/~/ Список шаблонов команд
2038 - {
2039 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID шаблона
2040 - "name": "string", ~/~/ Название шаблона команд
2041 - "command": "string", ~/~/ Команда на выполнение
2042 - "retries": 0 ~/~/ Лимит попыток отправки
2043 - }
2044 - ],
2045 - "sensors": [  ~/~/ Список датчиков 
2046 - {
2047 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
2048 - "kind": 0, ~/~/ Определяет виды датчиков. 0 - Simple, 1 - Composite
2049 - "type": 0, ~/~/ Определяет типы датчиков. 0 - None, 1 - FuelLvl, 2 - PowerLevel, 3 - Consumption, 4 - Ignition,
2050 -)))
2051 -
2052 -(((
2053 -~/~/ 5 - Crane, 6 - Greider, 8 - Power, 11 - Arrow, 14 - Otval, 15 - Sand, 17 - MixerLand, 18 - MixerMove, 20 - Temperature,
2054 -)))
2055 -
2056 -(((
2057 -~/~/ 21 - Warning, 22 - Metla, 23 - Kosilka, 24 - DriverRFID, 25 - ReFueller, 27 - GrainLvl, 28 - EngineRPM, 29 - BodyUp,
2058 -)))
2059 -
2060 -(((
2061 -~/~/ 31 - EngineTemperature, 32 - TrailerRFID, 33 - Tank, 34 - Unloading, 35 - Custom, 36 - GNSS, 37 - WeighingTerminal,
2062 -)))
2063 -
2064 -(((
2065 -~/~/ 38 - RelativeMotohours, 39 - MileageSensor, 40 - Motohours, 41 - BunkerLowLevel, 42 - BunkerHighLevel,
2066 -)))
2067 -
2068 -(((
2069 -~/~/ 43 - AppliedKg, 44 - TreatedHa, 45 - RateKgHa, 46 - FertilizerLevel, 47 - FactOfWork, 48 - ReapingAggregate, 49 - AverageRateKgHa, 50 - Speed
2070 - "name": "string", ~/~/ Имя датчика
2071 - "inputType": 0, ~/~/ Тип входа, на который подключается определенный тип датчика. 0 - Digital, 1 - Analog, 2 - Impulse,
2072 -)))
2073 -
2074 -(((
2075 -~/~/ 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Diagnosis, 7 - Wire, 8 - ImpulseFrequency, 9 - BLE, 255 - Virtual
2076 - "inputNumber": 0, ~/~/ Номер входа
2077 - "pseudonym": "string", ~/~/ Псевдоним
2078 - "medianDegree": 0, ~/~/ Степень медианной фильтрации
2079 - "isInverted": true, ~/~/ Признак инверсии
2080 - "disabled": true, ~/~/ Датчик не участвует в обработке
2081 - "gradeType": 0, ~/~/ Способ тарировки показаний датчика.  0 - Default, 1 - Digital, 2 - GradeTable, 3 - CounterSummary, 4 - CounterDiffs
2082 - "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
2083 2083   {
2084 - "grades": [ ~/~/ Таблицы тарировки
2085 - {
2086 - "input": 0, ~/~/ Вход
2087 - "output": 0 ~/~/ Выход
2088 - }
2089 - ],
2090 - "relevanceTime": "2024-10-30T10:31:17.196Z"  ~/~/ Время, с которого наступает актуальность таблицы тарировки
2091 - }
2092 - ],
2093 - "showInTooltip": true, ~/~/ Отображение в подсказке
2094 - "showLastValid": true, ~/~/ Отображать последнее валидное значение
2095 -
2096 -(((
2097 - "color": "string", ~/~/ цвет уведомлений
2098 -)))
2099 -
2100 - "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
2101 - "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
2102 - "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 
2103 - "expr": "string", ~/~/ Выражение
2104 - "children": [ ~/~/ Cписок добавленных в агрегацию физ. датчиков
2105 - "string" 
2106 - ],
2107 - "customParams": { ~/~/ Дополнительные настройки
2108 - "additionalProp1": "string",
2109 - "additionalProp2": "string",
2110 - "additionalProp3": "string"
2111 - },
2112 - "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления.
2113 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге
1743 + "id": ~/~/ идентификатор
1744 + "enabled": true, ~/~/ флаг включения
1745 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
1746 + "login": "", ~/~/ имя учетной записи
1747 + "password": "", ~/~/ пароль учетной записи
1748 + }
1749 + "inspectionTasks": ~/~/ задания на ТО
2114 2114   {
2115 - "from": 0, ~/~/ С какого значения
2116 - "color": "string", ~/~/ Каким цветом
2117 - "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": "", ~/~/ Сколько раз выполнить задание
2118 2118   }
2119 - ]
2120 - }
2121 - ],
2122 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
2123 - "customFields": [ ~/~/ Список произвольных полей
2124 - {
2125 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности
2126 - "name": "string", ~/~/ Наименование произвольного поля
2127 - "value": "string", ~/~/ Значение произвольного поля
2128 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента
2129 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
2130 - "forReport": true ~/~/ Отобразить произвольное поле в отчете
2131 - }
2132 - ],
2133 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor
2134 -}
2135 -)))
2136 2136  
1764 +(% lang="en-US" style="text-align:left" %)
1765 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
1766 +
2137 2137  **Валидация:**
2138 2138  - сезонный параметр может быть задан только если задана соответствующая обычная норма;
2139 2139  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
... ... @@ -2178,9 +2178,12 @@
2178 2178  
2179 2179  (% style="color:#000000" %)Ответ:
2180 2180  
2181 -(% style="color:#000000" %){(%%)
1811 +(% style="color:#000000" %){
1812 +
2182 2182   "deviceTypeId" : "", ~/~/ ID типа устройства
2183 2183   "deviceTypeName" : "" ~/~/ Название типа устройства
1815 +
1816 +(% style="text-align:left" %)
2184 2184  (% style="color:#000000" %)}
2185 2185  
2186 2186  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) =
... ... @@ -2202,10 +2202,13 @@
2202 2202  
2203 2203  (% style="color:#000000" %)Ответ:
2204 2204  
2205 -(% style="color:#000000" %){(%%)
1838 +(% style="color:#000000" %){
1839 +
2206 2206   "id": "", ~/~/ ID типа датчика 
2207 2207   "name": "", ~/~/ Название
2208 2208   "description": "", ~/~/ Описание
1843 +
1844 +(% style="text-align:left" %)
2209 2209  (% style="color:#000000" %)}
2210 2210  
2211 2211  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) =
... ... @@ -2292,13 +2292,8 @@
2292 2292  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
2293 2293  |protocolType|Тип протокола
2294 2294  |inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный
2295 -|inputNumber|(((
2296 -Номер входа
2297 -)))
1931 +|inputNumber|Номер входа
2298 2298  
2299 -(% class="wikigeneratedid" %)
2300 -Перечень 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/]]
2301 -
2302 2302  == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) ==
2303 2303  
2304 2304  (% class="box infomessage" %)
... ... @@ -2407,14 +2407,10 @@
2407 2407   {
2408 2408   "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 
2409 2409   "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 
2410 - "mileage": 0, ~/~/ Пробег за период, километры
2411 - "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 
2412 - "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры
2413 - "motohours": 0, ~/~/ Моточасы за период, секунды
2414 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды
2415 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды
2416 - "idlingTime": 0 ~/~/  Холостой ход за период, секунд
2417 -
2041 + "mileageBegin": 0, ~/~/ Пробег на начало периода
2042 + "mileageEnd": 0, ~/~/ Пробег на окончание периода
2043 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода
2044 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода
2418 2418   }
2419 2419   ]
2420 2420   }
... ... @@ -2458,19 +2458,11 @@
2458 2458   "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода
2459 2459   "fuelConsumption": 0, ~/~/ Расход топлива
2460 2460   "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении
2461 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне
2462 -
2463 2463   }
2464 2464   ]
2465 2465   }
2466 2466  ]
2467 2467  
2468 -(% class="box warningmessage" %)
2469 -(((
2470 -Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"".
2471 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling".
2472 -)))
2473 -
2474 2474  == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) ==
2475 2475  
2476 2476  (% class="box infomessage" %)
... ... @@ -2505,8 +2505,7 @@
2505 2505   "model": "string", ~/~/ Модель объекта
2506 2506   "fuels": [ ~/~/ Массив данным по заправкам и сливам
2507 2507   {
2508 - "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
2509 -
2127 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив
2510 2510   "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало
2511 2511   "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание
2512 2512   "valueFuel": 0, ~/~/ Количество
... ... @@ -2535,42 +2535,74 @@
2535 2535  Тело запроса:
2536 2536  
2537 2537  {
2156 +
2538 2538   "vehicleIds": [ ], ~/~/ Список ID объектов
2158 +
2539 2539   "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса
2160 +
2540 2540   "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса
2162 +
2541 2541   "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
2164 +
2542 2542  }
2543 2543  
2544 2544  Ответ:
2545 2545  
2546 -[ 
2169 +[
2170 +
2547 2547   {
2172 +
2548 2548   "vehicleId": 0, ~/~/ ID объекта
2174 +
2549 2549   "vehicleName": "string", ~/~/ Имя объекта
2176 +
2550 2550   "moves": [ ~/~/ Событие движения
2178 +
2551 2551   {
2180 +
2552 2552   "mileage": 0, ~/~/ Пробег, км
2182 +
2553 2553   "eventId": 0, ~/~/ Идентификатор события
2184 +
2554 2554   "eventName": "string", ~/~/ Название события
2186 +
2555 2555   "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события
2188 +
2556 2556   "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события
2190 +
2557 2557   "duration": 0 ~/~/ Продолжительность события, секунд
2192 +
2558 2558   }
2194 +
2559 2559   ],
2196 +
2560 2560   "stops": [ ~/~/ События стоянок
2198 +
2561 2561   {
2562 - "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты
2200 +
2201 + "address": "string", ~/~/ Адрес события
2202 +
2563 2563   "eventId": 0, ~/~/ Идентификатор события
2204 +
2564 2564   "eventName": "string", ~/~/ Название события
2206 +
2565 2565   "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события
2208 +
2566 2566   "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события
2210 +
2567 2567   "duration": 0 ~/~/ Продолжительность события, секунд
2212 +
2213 +
2568 2568   }
2215 +
2569 2569   ]
2217 +
2570 2570   }
2219 +
2571 2571  ]
2572 2572  
2573 2573  
2223 +
2574 2574  == (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) ==
2575 2575  
2576 2576  (% class="box infomessage" %)
... ... @@ -2584,8 +2584,8 @@
2584 2584  
2585 2585  В заголовках запроса: X-Auth: Токен авторизации
2586 2586  
2237 +В теле запроса перечисляете массив id объектов
2587 2587  
2588 -В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую.
2589 2589  
2590 2590  Ответ:
2591 2591   {
... ... @@ -2594,7 +2594,7 @@
2594 2594   "vehicleNumber": "string",~/~/Номер объекта.
2595 2595   "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер
2596 2596   "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве.
2597 - "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
2247 + "state": 0,~/~/Определяет состояния объекта в мониторинге: в движении, остановка, стоянка, отключена, нет данных.
2598 2598   "speed": 0,~/~/Скорость объекта.
2599 2599   "course": 0,~/~/Курс движения [0;360]
2600 2600   "latitude": 0,~/~/Широта [-90°;90°].
... ... @@ -2607,6 +2607,7 @@
2607 2607   }
2608 2608  
2609 2609  
2260 +
2610 2610  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =
2611 2611  
2612 2612  == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) ==
... ... @@ -2735,35 +2735,6 @@
2735 2735   }
2736 2736  ]
2737 2737  
2738 -
2739 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) ==
2740 -
2741 -(% class="box successmessage" %)
2742 -(((
2743 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis**
2744 -)))
2745 -
2746 -(% style="color:#000000" %)Метод запроса: **PUT**
2747 -
2748 -Пример запроса:
2749 -
2750 -(((
2751 -{
2752 - "id": 0,  ~/~/ Идентификатор объекта геозоны
2753 - "name": "string",  ~/~/ Наименование объекта геозоны
2754 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Подразделение
2755 - "description": "string", ~/~/ Описание объекта геозоны
2756 - "beginCalc": "2025-04-24T12:10:28.751Z",  ~/~/ Дата начала расчетов для геозоны
2757 - "endCalc": "2025-04-24T12:10:28.751Z",  ~/~/ Дата окончания расчетов для геозоны
2758 - "settingsData": "string"  ~/~/ Параметры отображения в формате XML.
2759 -}
2760 -)))
2761 -
2762 -
2763 -Пример ответа:
2764 -
2765 -200 ~/~/ Success
2766 -
2767 2767  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =
2768 2768  
2769 2769  == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==
... ... @@ -2943,32 +2943,6 @@
2943 2943  
2944 2944  Success
2945 2945  
2946 -
2947 -== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) ==
2948 -
2949 -(% class="box warningmessage" %)
2950 -(((
2951 -**PUT** /api/v3/notifications/prolongation
2952 -)))
2953 -
2954 -Метод позволяет продлить уведомления.
2955 -
2956 -Метод запроса **PUT**
2957 -
2958 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation
2959 -
2960 -В заголовках запроса: X-Auth: Токен авторизации.
2961 -
2962 -Тело запроса:
2963 -
2964 -[
2965 -
2966 -0
2967 -
2968 -]
2969 -
2970 -где 0 идентификатор ids.
2971 -
2972 2972  == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) ==
2973 2973  
2974 2974  (% class="box errormessage" %)
... ... @@ -4159,7 +4159,7 @@
4159 4159  **POST /api/v3/vehicles/import/{agentId}**
4160 4160  )))
4161 4161  
4162 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).**
3758 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.**
4163 4163  
4164 4164  В пути указывается **agentId** - id клиента.
4165 4165  
... ... @@ -4171,7 +4171,7 @@
4171 4171  
4172 4172  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4173 4173  |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать.
4174 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление
3770 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление
4175 4175  
4176 4176  В теле использовать тип **form-data,** тип значения** file**
4177 4177  
... ... @@ -4248,45 +4248,6 @@
4248 4248  |producedCount|Кол-во успешно отправленных в шину данных сообщений
4249 4249  |msgCount|Кол-во обработанных сообщений всего
4250 4250  
4251 -== ==
4252 -
4253 -== **Импортировать историю ТС (Асинхронный запрос)** ==
4254 -
4255 -(% class="box successmessage" %)
4256 -(((
4257 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
4258 -)))
4259 -
4260 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4261 -
4262 -Метод запроса: **POST**
4263 -
4264 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
4265 -
4266 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
4267 -
4268 -
4269 -Ответ:
4270 -
4271 -{
4272 -
4273 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4274 -
4275 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса
4276 -
4277 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
4278 -
4279 - "Message": "string", ~/~/ Информация о выполнении запроса
4280 -
4281 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
4282 -
4283 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4284 -
4285 - "Data": "string" ~/~/ Данные
4286 -
4287 -}
4288 -
4289 -
4290 4290  == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) ==
4291 4291  
4292 4292  (% class="box infomessage" %)
... ... @@ -4304,60 +4304,10 @@
4304 4304   "message": "string"
4305 4305  }
4306 4306  
4307 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)(((
4308 -**Параметр**
4309 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)(((
4310 -**Описание**
4311 -)))
4312 -|(((
4313 -activity
4314 -)))|(((
4315 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет
4316 -)))
4317 -|(((
4318 -progress
4319 -)))|(((
4320 -Guid ТС
4321 -)))
3864 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3865 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет
3866 +|progress|Guid ТС
4322 4322  
4323 -
4324 -== **Возвращает статус асинхронного запроса импорта истории ТС** ==
4325 -
4326 -(% class="box infomessage" %)
4327 -(((
4328 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
4329 -)))
4330 -
4331 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4332 -
4333 -Метод запроса: **GET**
4334 -
4335 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
4336 -
4337 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
4338 -
4339 -
4340 -Ответ:
4341 -
4342 -{
4343 -
4344 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4345 -
4346 - "Status": 0, ~/~/ Перечисление состояний выполения запроса
4347 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
4348 -
4349 - "Message": "string", ~/~/ Информация о выполнении запроса
4350 -
4351 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
4352 -
4353 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
4354 -
4355 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4356 -
4357 - "Data": "string" ~/~/ Данные
4358 -
4359 -}
4360 -
4361 4361  == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==
4362 4362  
4363 4363  (% class="box infomessage" %)
... ... @@ -4439,67 +4439,64 @@
4439 4439  Тело запроса:
4440 4440  
4441 4441  {
4442 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов
4443 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса
4444 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса
3949 + "vehicleIds": [vehicleId],
3950 + "from": "2023-11-22T09:29:48.051Z",
3951 + "to": "2023-11-22T09:29:48.051Z"
4445 4445  }
4446 4446  
3954 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
3955 +|vehicleIds|Массив ID объектов
3956 +|from|Дата начала запроса
3957 +|to|Дата окончания запроса
3958 +
4447 4447  Ответ:
4448 4448  
4449 4449  {
4450 - "items": [  ~/~/ Список в разрезе ТС
3962 + "items": [
4451 4451   {
4452 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода
4453 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода
4454 - "vehicleId": 0, ~/~/ ID ТС
4455 - "vehicleName": "string", ~/~/ Название ТС
4456 - "vehicleModel": "string", ~/~/ Модель ТС
4457 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС
4458 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС
4459 - "totalViolations": 0, ~/~/ Нарушений всего
4460 - "violationsByType": { ~/~/ Информация о нарушениях по типу
4461 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости
4462 - "accelerationViolations": 0, ~/~/ Нарушений ускорения
4463 - "brakingViolations": 0, ~/~/ Нарушений торможения
4464 - "turningViolations": 0, ~/~/ Нарушений опасного поворота
4465 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения
4466 - "sensorViolations": 0 ~/~/ Нарушений по датчику
3964 + "from": "2023-11-22T09:29:48.052Z",
3965 + "to": "2023-11-22T09:29:48.052Z",
3966 + "vehicleId": 0,
3967 + "vehicleName": "string",
3968 + "vehicleModel": "string",
3969 + "penalty": 0,
3970 + "score": 0,
3971 + "totalViolations": 0,
3972 + "violationsByType": {
3973 + "overspeedingViolations": 0,
3974 + "accelerationViolations": 0,
3975 + "brakingViolations": 0,
3976 + "turningViolations": 0,
3977 + "dangerousDrivingViolations": 0,
3978 + "sensorViolations": 0
4467 4467   },
4468 -
4469 -(((
4470 -
4471 -)))
4472 -
4473 - "moveTime": 0, ~/~/ Продолжительность движения, сек
4474 - "mileage": 0, ~/~/ Пробег, м
4475 - "tripsCount": 0, ~/~/ Кол-во рейсов
4476 - "trips": [  ~/~/ Информация по рейсу
3980 + "moveTime": 0,
3981 + "mileage": 0,
3982 + "tripsCount": 0,
3983 + "trips": [
4477 4477   {
4478 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс
4479 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс
4480 - "violationsCount": 0, ~/~/ Всего нарушений
4481 - "violationsByType": { ~/~/ Информация о нарушениях по типу
4482 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости
4483 - "accelerationViolations": 0, ~/~/ Нарушений ускорения
4484 - "brakingViolations": 0, ~/~/ Нарушений торможения
4485 - "turningViolations": 0, ~/~/ Нарушений опасного поворота
4486 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения
4487 - "sensorViolations": 0 ~/~/ Нарушений по датчику
3985 + "penalty": 0,
3986 + "score": 0,
3987 + "violationsCount": 0,
3988 + "violationsByType": {
3989 + "overspeedingViolations": 0,
3990 + "accelerationViolations": 0,
3991 + "brakingViolations": 0,
3992 + "turningViolations": 0,
3993 + "dangerousDrivingViolations": 0,
3994 + "sensorViolations": 0
4488 4488   },
4489 -
4490 - "startDate": "2024-11-18T13:23:38.516Z",  ~/~/ Дата начала поездки
4491 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки
4492 - "moveTime": 0, ~/~/ Продолжительность движения, сек
4493 - "mileage": 0, ~/~/ Пробег, м
4494 - "motohours": 0, ~/~/ Моточасы, секунды
4495 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс
4496 - "startAddress": "string", ~/~/ Адрес начала рейса
4497 - "endAddress": "string", ~/~/ Адрес конца рейса
4498 - "drivers": [  ~/~/ Список водителей
3996 + "moveTime": 0,
3997 + "mileage": 0,
3998 + "motohours": 0,
3999 + "maxSpeed": 0,
4000 + "startAddress": "string",
4001 + "endAddress": "string",
4002 + "drivers": [
4499 4499   {
4500 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя
4501 - "driverName": "string", ~/~/ФИО водителя
4502 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки
4004 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4005 + "driverName": "string",
4006 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
4503 4503   }
4504 4504   ]
4505 4505   }
... ... @@ -4508,1747 +4508,34 @@
4508 4508   ]
4509 4509  }
4510 4510  
4511 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) =
4015 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4016 +|from|Дата начала запроса
4017 +|to|Дата  окончания
4018 +|vehicleId|ID объекта
4019 +|vehicleName|Имя объекта
4020 +|vehicleModel|Модель объекта
4021 +|penalty|Сумма штрафных баллов
4022 +|score|Оценка
4023 +|totalViolations|Суммарное количество нарушений
4024 +|violationsByType|Список типов нарушений и количество нарушений для каждого типа
4025 +|overspeedingViolations|Превышение скорости
4026 +|accelerationViolations|Ускорение
4027 +|brakingViolations|Торможение
4028 +|turningViolations|Резкий поворот
4029 +|dangerousDrivingViolations|Резкое вождение
4030 +|sensorViolations|Нарушение по датчику
4031 +|moveTime|Время в движении
4032 +|mileage|Пробег
4033 +|tripsCount|Количество рейсов
4034 +|motohours|Моточасы
4035 +|maxSpeed|Максимальная скорость
4036 +|startAddress|Адрес начала рейса
4037 +|endAddress|Адрес окончания рейса
4038 +|drivers|Список водителей, которые были на объекте в течениии рейса
4039 +|driverGuid|Guid водителя
4040 +|driverName|Имя водителя
4041 +|driverRfid|Номер Карты-метки
4512 4512  
4513 -== (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==
4514 -
4515 -Транзакции по топливным картам можно получить при наличии права «Транзакции ТК». Метод позволяет получить транзакции по нескольким топливным картам.
4516 -
4517 -(% class="box infomessage" %)
4518 -(((
4519 -**POST /api/v3/fuelcards/transactions**
4520 -)))
4521 -
4522 -Метод запроса: POST
4523 -
4524 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards/transactions
4525 -\\В заголовках запроса: X-Auth: Токен авторизации
4526 -
4527 -Параметры в теле запроса (JSON):
4528 -
4529 -{
4530 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ Начало периода
4531 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ Конец периода
4532 - "ids": [ 
4533 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы топливных карт
4534 - ],
4535 - "timezone": 0 ~/~/ Часовой пояс
4536 -}
4537 -
4538 -
4539 -Ответ:
4540 - {
4541 - "date": "2024-04-11T10:41:02.265Z", ~/~/ Дата и время транзакции
4542 - "driver": "string", ~/~/ Водители, привязанные к ТК
4543 - "object": "string", ~/~/ Наименование ТС
4544 - "amount": 0, ~/~/ Количество топлива
4545 - "amountDut": 0, ~/~/ Количество по ДУТ
4546 - "amountDiff": 0, ~/~/ Разница, л
4547 - "amountDiffPerc": 0, ~/~/ Разница, %
4548 - "summa": 0, ~/~/ Стоимость, руб
4549 - "serviceName": "string", ~/~/ Тип топлива
4550 - "price": 0, ~/~/ Цена за литр, руб
4551 - "cardName": "string", ~/~/ Наименование ТК
4552 - "cardNum": "string", ~/~/ Номер ТК
4553 - "operator": "string", ~/~/ Оператор ТК
4554 - "address": "string" ~/~/ Адрес АЗС
4555 - }
4556 -
4557 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) ==
4558 -
4559 -(% class="box infomessage" %)
4560 -(((
4561 -**GET /api/v3/fuelcards**
4562 -)))
4563 -
4564 -Метод запроса: GET
4565 -
4566 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список
4567 -
4568 -Ответ:
4569 -
4570 -[
4571 - {
4572 - "Name": "string", ~/~/ Определяет наименование карты.
4573 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора.
4574 - "Number": "string", ~/~/ Определяет № карты.
4575 - "Enabled": true, ~/~/ Определяет признак активности карты.
4576 - "Description": "string", ~/~/ Определяет описание карты.
4577 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты
4578 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
4579 - "deleted": true ~/~/ Признак удаления
4580 - }
4581 -]
4582 -
4583 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
4584 -
4585 -
4586 -== **Получение полных данных о ретрансляторе** ==
4587 -
4588 -(% class="box infomessage" %)
4589 -(((
4590 -**GET ** **/api/v3/retranslations/{id}**
4591 -)))
4592 -
4593 -id - Идентификатор ретранслятора
4594 -
4595 -
4596 -Пример ответа:
4597 -
4598 -{  
4599 -"description": "", ~/~/ Поле описания ретранслятора
4600 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4601 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4602 -"isEnabled": true, ~/~/ Признак включения ретранслятора, Включен, true - включен, false - отключен
4603 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4604 -"objects": [ ~/~/ Объекты для ретрансляции
4605 -{      
4606 -"id": "",  ~/~/ Идентификатор объекта ретрансляции
4607 -"name": "", ~/~/ Наименование объекта ретрансляции
4608 -"imei": "", ~/~/ IMEI объекта  ретрансляции
4609 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4610 -}
4611 - ],  
4612 -"id": "", ~/~/ Идентификатор ретранслятора 
4613 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4614 -"deleted": "" ~/~/ Признак удаления ретранслятора: true - включен, false - отключен
4615 -}
4616 -
4617 -
4618 -== **Удаление данных ретранслятора** ==
4619 -
4620 -(% class="box infomessage" %)
4621 -(((
4622 -**DELETE** **/api/v3/retranslations/{id}**
4623 -)))
4624 -
4625 -id - Идентификатор ретранслятора
4626 -
4627 -
4628 -== **Создание ретранслятора** ==
4629 -
4630 -(% class="box infomessage" %)
4631 -(((
4632 -**POST ** **/api/v3/retranslations/{id}**
4633 -)))
4634 -
4635 -Запрос:
4636 -
4637 -{  
4638 -"description": "", ~/~/ Поле описания ретранслятора
4639 -"subscriberId": "", ~/~/ Идентификатор подписчика
4640 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4641 -"address": "", ~/~/ Адрес и порт принимающего сервера
4642 -"isEnabled": "", ~/~/ Признак включения ретранслятора, true - включен, false - отключен
4643 -"objects": [ ~/~/Объекты для ретрансляции
4644 -{      
4645 -"id": "", ~/~/ Идентификатор ретранслятора 
4646 -"imei": "", ~/~/ IMEI объекта ретрансляции
4647 -"isEnabled": ""  ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4648 -}
4649 - ]
4650 -}
4651 -
4652 -
4653 -Ответ:
4654 -
4655 -{  
4656 -"description": "", ~/~/ Поле описания ретранслятора
4657 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4658 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4659 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4660 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4661 -"objects": [ ~/~/ Объекты для ретрансляции
4662 -{      
4663 -"id": "", ~/~/ Идентификатор объекта ретрансляции     
4664 -"name": "string", ~/~/ Наименование объекта ретрансляции    
4665 -"imei": "", ~/~/ IMEI объекта ретрансляции
4666 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен  
4667 -}
4668 - ],
4669 -"id": "", ~/~/ Идентификатор ретранслятора   
4670 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4671 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4672 -}
4673 -
4674 -
4675 -== **Редактирование ретранслятора** ==
4676 -
4677 -(% class="box infomessage" %)
4678 -(((
4679 -**PUT** **/api/v3/retranslations**
4680 -)))
4681 -
4682 -Пример запроса:
4683 -
4684 -{  
4685 -"id": "", ~/~/ Идентификатор ретранслятора   
4686 -"description": "string", ~/~/ Поле описания ретранслятора
4687 -"subscriberId": "", ~/~/ Идентификатор подписчика
4688 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4689 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4690 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4691 -"objects": ~/~/ Объекты для ретрансляции
4692 -[    
4693 -{      
4694 -"id": "",  ~/~/ Идентификатор объекта ретрансляции 
4695 -"imei": "", ~/~/ IMEI объекта ретрансляции
4696 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4697 -}
4698 - ]
4699 -}
4700 -
4701 -
4702 -Пример ответа:
4703 -
4704 -{  
4705 -"description": "", ~/~/ Поле описания ретранслятора
4706 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4707 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4708 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4709 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4710 -"objects": [ ~/~/ Объекты для ретрансляции
4711 -{      
4712 -"id": "", ~/~/ Идентификатор объекта ретрансляции     
4713 -"name": "string", ~/~/ Наименование объекта ретрансляции    
4714 -"imei": "", ~/~/ IMEI объекта ретрансляции
4715 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен  
4716 -}
4717 - ],
4718 -"id": "", ~/~/ Идентификатор ретранслятора   
4719 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4720 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4721 -}
4722 -
4723 -
4724 -== **Получение списка ретранслятора клиента** ==
4725 -
4726 -(% class="box infomessage" %)
4727 -(((
4728 -**POST /api/v3/retranslations/find**
4729 -)))
4730 -
4731 -Пример запроса:
4732 -
4733 -{  
4734 -"id": "", ~/~/ Идентификатор ретранслятора   
4735 -"search": "string", ~/~/ Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
4736 -"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (обязательный параметр).
4737 -}
4738 -
4739 -Ответ:
4740 -
4741 -[ 
4742 -{    
4743 -"description": "", ~/~/ Поле описания ретранслятора
4744 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4745 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4746 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4747 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4748 -"id": "", ~/~/ Идентификатор ретранслятора   
4749 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4750 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4751 -}
4752 -]
4753 -
4754 -
4755 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Отчеты**(%%) =
4756 -
4757 -== **API для отчета по выгрузке комбайнов** ==
4758 -
4759 -(% class="box infomessage" %)
4760 -(((
4761 -**POST /api/v3/Reports/harvesterUnloading**
4762 -)))
4763 -
4764 -Пример запроса:
4765 -
4766 -{
4767 - "byTime": 0, ~/~/ Объединение событий по времени
4768 - "byDist": 0, ~/~/ Объединение событий по расстоянию
4769 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
4770 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
4771 - "showNearestObjects": true, ~/~/Показывать объекты рядом?
4772 - "vehicleIds": [ ~/~/ Список id объектов для анализа
4773 - 0
4774 - ],
4775 - "from": "", ~/~/ Дата и время начало запроса
4776 - "to": "", ~/~/ Дата и время окончания запроса
4777 - "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
4778 -}
4779 -
4780 -Пример ответа:
4781 -
4782 -[ 
4783 - {
4784 - "harvesterName": "", ~/~/Комбайн, номер
4785 - "harvesterId": 0, ~/~/Комбайн, id
4786 -"harvesterModel": "", ~/~/ Модель комбайна
4787 -"hopperCapacity": 0, ~/~/ Объем бункера м3
4788 - "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек
4789 - "events": [ ~/~/Список событий в разрезе комбайна
4790 - {
4791 - "driverId": "", ~/~/Идентификатор водителя
4792 - "driverName": "", ~/~/Водитель комбайна, ФИО
4793 - "RFID": "", ~/~/ идентификатор карты-метки
4794 - "rfidName": "", ~/~/Водитель комбайна, имя метки
4795 - "vehicleId": 0, ~/~/идентификатор объекта
4796 - "vehicleName": "string", ~/~/ Имя объекта
4797 - "modelName": "string", ~/~/ Имя модели объекта
4798 - "nearestVehicles": [ ~/~/Объекты рядом
4799 - {
4800 - "vehicleId": 0, ~/~/идентификатор объекта
4801 - "vehicleName": "string" ~/~/ Имя объекта
4802 - }
4803 - ],
4804 - "fields": [ ~/~/Поля, где происходила выгрузка
4805 - {
4806 - "id": 0, ~/~/ идентификатор пользователя 
4807 - "name": "string" ~/~/ имя пользователя 
4808 - }
4809 - ],
4810 - "event": "string", ~/~/Событие
4811 - "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода
4812 - "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода
4813 - "durationSeconds": 0, ~/~/Продолжительность события, в секундах
4814 - "cultureName": "string", ~/~/ название культуры
4815 - "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события)
4816 - "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события)
4817 - "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события)
4818 - "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события)
4819 - "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события)
4820 - "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события)
4821 - "issued": 0, ~/~/Выдано, бункеров
4822 - "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера)
4823 - "latitude": 0, ~/~/Широта
4824 - "longitude": 0, ~/~/ Долгота
4825 - "litresAway": 0, ~/~/Отдано, л
4826 - "m3Away": 0 ~/~/Отдано, м3
4827 - }
4828 - ]
4829 - }
4830 -]
4831 -
4832 -
4833 -== **Отчет трек-датчики** ==
4834 -
4835 -(% class="box infomessage" %)
4836 -(((
4837 -**POST /api/v3/Reports/sensorsWorks**
4838 -)))
4839 -
4840 -**Пример запроса:**
4841 -
4842 -{
4843 - "vehicleIds": [ ~/~/ Список ID объектов
4844 - 0
4845 - ],
4846 - "from": "2025-02-20T06:39:23.888Z",  ~/~/ Начало периода (локальное время клиента)
4847 - "to": "2025-02-20T06:39:23.888Z", ~/~/  Конец периода (локальное время клиента)
4848 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4849 -}
4850 -
4851 -**Пример ответа:**
4852 -
4853 -(((
4854 -{
4855 - "vehicleSensorWorks": [  ~/~/ Интервалы работы оборудования для конкретного ТС
4856 - {
4857 - "vehicleId": 0, ~/~/ Идентификатор ТС
4858 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 
4859 - {
4860 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования.
4861 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования.
4862 - "duration": 0, ~/~/  Продолжительность интервала в секундах.
4863 - "name": "string", ~/~/ Наименование оборудования.
4864 - "mileage": 0, ~/~/ Пробег за время работы оборудования.
4865 - "totalMileage": 0, ~/~/ Общий пробег.
4866 - "avgSpeed": 0 ~/~/ Средняя скорость.
4867 - }
4868 - ]
4869 - }
4870 - ]
4871 -}
4872 -
4873 -
4874 -== **Превышение скорости** ==
4875 -
4876 -(% class="box infomessage" %)
4877 -(((
4878 -**POST /api/v3/Reports/overSpeedDuration**
4879 -)))
4880 -
4881 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение).
4882 -
4883 -Пример запроса:
4884 -
4885 -(((
4886 -{
4887 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства
4888 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента)
4889 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента)
4890 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4891 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 
4892 -}
4893 -)))
4894 -
4895 -(((
4896 -
4897 -)))
4898 -
4899 -(((
4900 -Пример ответа:
4901 -)))
4902 -
4903 -(((
4904 -(((
4905 -[
4906 - {
4907 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/  Дата и время события 
4908 - "duration": 0, ~/~/ Продолжительность события в секундах 
4909 - "maxSpeed": 0, ~/~/ Максимальная скорость 
4910 - "speedLimit": 0 ~/~/ Ограничение скорости 
4911 - }
4912 -]
4913 -)))
4914 -)))
4915 -)))
4916 -
4917 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
4918 -
4919 -
4920 -== **Запрос списка полей** ==
4921 -
4922 -(% class="box successmessage" %)
4923 -(((
4924 -**POST /api/v3/agroLands/find**
4925 -)))
4926 -
4927 -Пример запроса:
4928 -
4929 -(((
4930 -(((
4931 -(((
4932 -{
4933 - "year": 0, ~/~/ Фильтр по году
4934 - "name": "string", ~/~/ Фильтр по названию
4935 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению
4936 -}
4937 -)))
4938 -)))
4939 -
4940 -
4941 -)))
4942 -
4943 -Пример ответа:
4944 -
4945 -(((
4946 -[
4947 - {
4948 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
4949 - "year": 0, ~/~/ Год поля
4950 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая
4951 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая
4952 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
4953 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
4954 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
4955 - "counts": { ~/~/ Счётчики с/х поля 
4956 - "fieldOperations": 0, ~/~/ Количество операций на поле
4957 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
4958 - "facts": 0 ~/~/ Счётчик факта
4959 - },
4960 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4961 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4962 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4963 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4964 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
4965 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
4966 - "planComment": "string", ~/~/ Комментарий к полю
4967 - "productivity": 0, ~/~/ Урожайность.
4968 - "id": 0, ~/~/ Идентификатор объекта геозоны
4969 - "name": "string", ~/~/ Название объекта геозоны
4970 - "type": 0, ~/~/ Тип объекта геозоны
4971 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
4972 - "fname": "string", ~/~/ Имя файла
4973 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
4974 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны
4975 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны
4976 - "description": "string", ~/~/ Описание объекта геозоны
4977 - "area": 0, ~/~/ Площадь, м2
4978 - "perimetr": 0, ~/~/ Периметр, м
4979 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд
4980 - }
4981 -]
4982 -
4983 -
4984 -== **Создание нового поля ** ==
4985 -
4986 -(% class="box successmessage" %)
4987 -(((
4988 -**POST /api/v3/agroLands**
4989 -)))
4990 -
4991 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 
4992 -X-agent  - ID клиента
4993 -
4994 -Пример запроса:
4995 -
4996 -(((
4997 -{
4998 - "extId": "string", 
4999 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля
5000 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля
5001 - "display": "string", ~/~/ Настройки отображения
5002 - "year": 0, ~/~/ Год поля
5003 - "name": "string", ~/~/ Наименование
5004 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5005 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая
5006 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая
5007 - "planComment": "string", ~/~/ Комментарий к полю
5008 - "cropRotations": [ ~/~/ Данные по севообороту
5009 - {
5010 - "landId": 0, ~/~/ ID поля
5011 - "landName": "string", ~/~/ Название поля
5012 - "year": 0, ~/~/ Год урожая
5013 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5014 - "cultureName": "string", ~/~/ Название культуры
5015 - "productivity": 0, ~/~/ Урожайность
5016 - "area": 0, ~/~/ Площадь поля, Га
5017 - "total": 0, ~/~/ Валовый сбор
5018 - "productivityFact": 0, ~/~/ Фактическая урожайность
5019 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5020 - "totalFact": 0, ~/~/ Фактический валовый сбор
5021 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ
5022 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева
5023 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая
5024 - "isyearplan": true, ~/~/ Годовой план 
5025 - "comment": "string" ~/~/ Комментарий
5026 - }
5027 - ]
5028 -}
5029 -)))
5030 -
5031 -(((
5032 -
5033 -)))
5034 -
5035 -Пример ответа:
5036 -
5037 -(((
5038 -(((
5039 -{
5040 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
5041 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5042 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5043 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5044 - "cropRotations": [ ~/~/ Данные по севообороту
5045 - {
5046 - "landId": 0, ~/~/ ID поля
5047 - "landName": "string", ~/~/ Название поля
5048 - "year": 0, ~/~/ Год урожая 
5049 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5050 - "cultureName": "string", ~/~/ Название культуры
5051 - "productivity": 0, ~/~/ Урожайность
5052 - "area": 0, ~/~/ Площадь поля, Га.
5053 - "total": 0, ~/~/ Валовый сбор
5054 - "productivityFact": 0, ~/~/ Фактическая урожайность
5055 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5056 - "totalFact": 0, ~/~/ Фактический валовый сбор
5057 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ
5058 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева
5059 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая
5060 - "isyearplan": true, ~/~/ годовой план 
5061 - "comment": "string" ~/~/ Комментарий
5062 - }
5063 - ],
5064 - "cropVegetation": [ ~/~/ История вегетации поля
5065 - {
5066 - "values": [  ~/~/ Данные вегетации и состояния посева
5067 - {
5068 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5069 - "ndvi": 0 ~/~/ Индекс вегетации
5070 - }
5071 - ],
5072 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5073 - {
5074 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5075 - "type": "string", ~/~/ Тип
5076 - "pictureid": "string" ~/~/ Идентификатор ресурса
5077 - }
5078 - ],
5079 - "states": [ ~/~/ Ключевые даты развития поля
5080 - {
5081 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5082 - "state": 0 ~/~/ Статус  0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5083 - }
5084 - ]
5085 - }
5086 - ],
5087 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая
5088 - "counts": {
5089 - "fieldOperations": 0, ~/~/ Количество операций на поле
5090 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5091 - "facts": 0 ~/~/ Счётчик факта
5092 - },
5093 - "planComment": "string", ~/~/ Комментарий к полю
5094 -)))
5095 -
5096 -(((
5097 - "productivity": 0, ~/~/ Урожайность.
5098 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5099 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая
5100 - "year": 0, ~/~/ Год поля
5101 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5102 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5103 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5104 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5105 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто
5106 - "id": 0, ~/~/ Идентификатор объекта геозоны
5107 - "name": "string", ~/~/ Название объекта геозоны
5108 - "type": 0, ~/~/ Тип объекта геозоны
5109 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5110 - "fname": "string", ~/~/ Имя файла
5111 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5112 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны
5113 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны
5114 - "description": "string", ~/~/ Описание объекта геозоны
5115 - "area": 0, ~/~/ Площадь, м2
5116 - "perimetr": 0, ~/~/ Периметр, м
5117 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд
5118 -}
5119 -
5120 -
5121 -)))
5122 -)))
5123 -)))
5124 -
5125 -== **Получение поля по id** ==
5126 -
5127 -(% class="box infomessage" %)
5128 -(((
5129 -**GET /api/v3/agroLands/{id}**
5130 -)))
5131 -
5132 -Пример запроса:
5133 -id  ~/~/ Идентификатор поля
5134 -
5135 -Пример ответа:
5136 -
5137 -(((
5138 -{
5139 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
5140 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5141 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5142 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5143 - "cropRotations": [ ~/~/ Данные по севообороту
5144 - {
5145 - "landId": 0, ~/~/ ID поля
5146 - "landName": "string", ~/~/ Название поля
5147 - "year": 0, ~/~/ Год урожая
5148 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5149 - "cultureName": "string", ~/~/ Название культуры
5150 - "productivity": 0, ~/~/ Урожайность
5151 - "area": 0, ~/~/ Площадь поля, Га
5152 - "total": 0, ~/~/ Валовый сбор
5153 - "productivityFact": 0, ~/~/ Фактическая урожайность
5154 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5155 - "totalFact": 0, ~/~/ Фактический валовый сбор
5156 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ
5157 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева
5158 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая
5159 - "isyearplan": true, ~/~/ План года 
5160 - "comment": "string" ~/~/ Комментарий
5161 - }
5162 - ],
5163 - "cropVegetation": [ ~/~/ История вегетации поля
5164 - {
5165 - "values": [ ~/~/ Данные вегетации и состояния посева
5166 - {
5167 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
5168 - "ndvi": 0 ~/~/ Индекс вегетации
5169 - }
5170 - ],
5171 - "resources": [  ~/~/ Данные о снимках для каждого значения NDVI
5172 - {
5173 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
5174 - "type": "string", ~/~/ Тип 
5175 - "pictureid": "string" ~/~/ Идентификатор ресурса
5176 - }
5177 - ],
5178 - "states": [ ~/~/ Ключевые даты развития поля
5179 - {
5180 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 
5181 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая
5182 - }
5183 - ]
5184 - }
5185 - ],
5186 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая
5187 - "counts": {
5188 - "fieldOperations": 0, ~/~/ Количество операций на поле
5189 - "actualFieldOperations": 0,  ~/~/ Кол-во актуальных операций на поле
5190 - "facts": 0 ~/~/ Счётчик факта
5191 - },
5192 - "planComment": "string", ~/~/ Комментарий к полю
5193 - "productivity": 0, ~/~/ Урожайность.
5194 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5195 -)))
5196 -
5197 -(((
5198 -(((
5199 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая
5200 - "year": 0, ~/~/ Год поля
5201 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 
5202 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5203 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5204 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5205 - "status": 0,  ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5206 - "id": 0, ~/~/ Идентификатор объекта геозоны
5207 - "name": "string", ~/~/ Название объекта геозоны
5208 - "type": 0, ~/~/ Тип объекта геозоны 
5209 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5210 - "fname": "string", ~/~/ Имя файла
5211 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5212 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны
5213 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны
5214 - "description": "string", ~/~/ Описание объекта геозоны
5215 - "area": 0, ~/~/ Площадь, м2
5216 - "perimetr": 0, ~/~/ Периметр, м
5217 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд
5218 -}
5219 -)))
5220 -
5221 -
5222 -== **Удаление существующего поля** ==
5223 -
5224 -(% class="box errormessage" %)
5225 -(((
5226 -**DELETE /api/v3/agroLands/{id}**
5227 -)))
5228 -
5229 -Пример запроса:
5230 -id  ~/~/ Идентификатор поля
5231 -
5232 -Пример ответа:
5233 -
5234 -(((
5235 -200 ~/~/ Успех
5236 -)))
5237 -
5238 -(((
5239 -
5240 -)))
5241 -
5242 -(((
5243 -(((
5244 -(((
5245 -
5246 -)))
5247 -
5248 -(((
5249 -== **Изменение поля** ==
5250 -
5251 -(% class="box infomessage" %)
5252 -(((
5253 -**PUT /api/v3/agroLands**
5254 -)))
5255 -
5256 -Пример запроса:
5257 -
5258 -(((
5259 -(((
5260 -{
5261 - "id": 0, ~/~/ Идентификатор поля
5262 - "extId": "string", ~/~/ ExtId
5263 - "shape": "string", ~/~/ Форма поля
5264 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
5265 - "display": "string", ~/~/ Настройки отображения
5266 - "year": 0, ~/~/ Год поля
5267 - "name": "string", ~/~/ Наименование
5268 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5269 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая
5270 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая
5271 - "planComment": "string", ~/~/Комментарий к полю
5272 - "cropRotations": [  ~/~/ Данные по севообороту
5273 - {
5274 - "landId": 0, ~/~/ ID поля
5275 - "landName": "string", ~/~/ Название поля
5276 - "year": 0, ~/~/ Год урожая
5277 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5278 - "cultureName": "string", ~/~/ Название культуры
5279 - "productivity": 0, ~/~/ Урожайность
5280 - "area": 0, ~/~/ Площадь поля, Га.
5281 - "total": 0, ~/~/ Валовый сбор
5282 - "productivityFact": 0, ~/~/ Фактическая урожайность
5283 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5284 - "totalFact": 0, ~/~/ Фактический валовый сбор
5285 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ
5286 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева
5287 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая
5288 - "isyearplan": true, 
5289 - "comment": "string" ~/~/ Комментарий
5290 - }
5291 - ],
5292 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику
5293 -}
5294 -)))
5295 -)))
5296 -
5297 -(((
5298 -
5299 -)))
5300 -
5301 -Пример ответа:
5302 -
5303 -(((
5304 -(((
5305 -(((
5306 -{
5307 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
5308 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5309 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5310 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5311 - "cropRotations": [ ~/~/ Данные по севообороту
5312 - {
5313 - "landId": 0, ~/~/ ID поля
5314 - "landName": "string", ~/~/ Название поля
5315 - "year": 0, ~/~/  Год урожая
5316 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5317 - "cultureName": "string", ~/~/ Название культуры
5318 - "productivity": 0, ~/~/ Урожайность
5319 - "area": 0, ~/~/ Площадь поля, Га
5320 - "total": 0, ~/~/ Валовый сбор
5321 - "productivityFact": 0, ~/~/ Фактическая урожайность
5322 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5323 - "totalFact": 0, ~/~/ Фактический валовый сбор
5324 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ
5325 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева
5326 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая
5327 - "isyearplan": true, ~/~/ 
5328 - "comment": "string" ~/~/ Комментарий
5329 - }
5330 - ],
5331 - "cropVegetation": [ ~/~/ История вегетации поля
5332 - {
5333 - "values": [ ~/~/ Данные вегетации и состояния посева
5334 - {
5335 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5336 - "ndvi": 0 ~/~/ Индекс вегетации
5337 - }
5338 - ],
5339 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5340 - {
5341 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5342 - "type": "string", ~/~/ Тип
5343 - "pictureid": "string" ~/~/ Идентификатор ресурса
5344 - }
5345 - ],
5346 - "states": [ ~/~/ Ключевые даты развития поля 
5347 - {
5348 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5349 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5350 - }
5351 - ]
5352 - }
5353 - ],
5354 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая
5355 - "counts": { 
5356 - "fieldOperations": 0, ~/~/ Количество операций на поле
5357 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5358 - "facts": 0 ~/~/ Счётчик факта
5359 - },
5360 - "planComment": "string", ~/~/ Комментарий к полю
5361 - "productivity": 0, ~/~/ Урожайность.
5362 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5363 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая
5364 - "year": 0, ~/~/ Год поля
5365 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5366 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5367 - "factState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5368 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5369 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 
5370 - "id": 0, ~/~/ Идентификатор объекта геозоны
5371 - "name": "string", ~/~/ Название объекта геозоны
5372 - "type": 0, ~/~/ Тип объекта геозоны
5373 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5374 - "fname": "string", ~/~/ Имя файла
5375 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5376 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны
5377 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны
5378 - "description": "string", ~/~/ Описание объекта геозоны
5379 - "area": 0, ~/~/ Площадь, м2
5380 - "perimetr": 0, ~/~/ Периметр, м
5381 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд
5382 -}
5383 -)))
5384 -)))
5385 -)))
5386 -)))
5387 -)))
5388 -
5389 -
5390 -== **Редактирование года урожая ** ==
5391 -
5392 -(% class="box successmessage" %)
5393 -(((
5394 -**POST /api/v3/agroLands/updateOpenCloseYear**
5395 -)))
5396 -
5397 -Пример запроса:
5398 -
5399 -(((
5400 -(((
5401 -{
5402 - "agroLandIds": [  ~/~/ Идентификаторы полей для которых меняется год урожая
5403 - 0
5404 - ],
5405 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая
5406 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая
5407 -}
5408 -)))
5409 -
5410 -
5411 -)))
5412 -
5413 -Пример ответа:
5414 -
5415 -(((
5416 -(((
5417 -{
5418 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
5419 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5420 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5421 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5422 - "cropRotations": [ ~/~/ Данные по севообороту
5423 - {
5424 - "landId": 0, ~/~/ ID поля
5425 - "landName": "string", ~/~/ Название поля
5426 - "year": 0, ~/~/ Год урожая
5427 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5428 - "cultureName": "string", ~/~/ Название культуры
5429 - "productivity": 0, ~/~/ Урожайность
5430 - "area": 0, ~/~/ Площадь поля, Га.
5431 - "total": 0, ~/~/ Валовый сбор
5432 - "productivityFact": 0, ~/~/ Фактическая урожайность
5433 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5434 - "totalFact": 0, ~/~/ Фактический валовый сбор
5435 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ
5436 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева
5437 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая
5438 - "isyearplan": true, ~/~/ 
5439 - "comment": "string" ~/~/ Комментарий
5440 - }
5441 - ],
5442 - "cropVegetation": [ ~/~/ История вегетации поля
5443 - {
5444 - "values": [ ~/~/ Данные вегетации и состояния посева
5445 - {
5446 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
5447 - "ndvi": 0 ~/~/ Индекс вегетации
5448 - }
5449 - ],
5450 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5451 - {
5452 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
5453 - "type": "string", ~/~/ Тип
5454 - "pictureid": "string" ~/~/ Идентификатор ресурса
5455 - }
5456 - ],
5457 - "states": [ ~/~/ Ключевые даты развития поля
5458 - {
5459 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 
5460 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5461 - }
5462 - ]
5463 - }
5464 - ],
5465 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая
5466 - "counts": { 
5467 - "fieldOperations": 0, ~/~/ Количество операций на поле
5468 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5469 - "facts": 0 ~/~/ Счётчик факта
5470 - },
5471 - "planComment": "string", ~/~/ Комментарий к полю
5472 - "productivity": 0, ~/~/ Урожайность.
5473 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5474 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая
5475 - "year": 0, ~/~/ Год поля
5476 - "planState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5477 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5478 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5479 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5480 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
5481 - "id": 0, ~/~/ Идентификатор объекта геозоны
5482 - "name": "string", ~/~/ Название объекта геозоны
5483 - "type": 0, ~/~/ Тип объекта геозоны
5484 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5485 - "fname": "string", ~/~/ Имя файла
5486 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5487 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны
5488 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны
5489 - "description": "string", ~/~/ Описание объекта геозоны
5490 - "area": 0, ~/~/ Площадь, м2
5491 - "perimetr": 0, ~/~/ ериметр, м
5492 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
5493 -}
5494 -)))
5495 -
5496 -
5497 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
5498 -)))
5499 -)))
5500 -)))
5501 -
5502 -== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
5503 -
5504 -
5505 -(% class="box infomessage" %)
5506 -(((
5507 -**GET api/v3/Vehicles/recyclebin/all**
5508 -)))
5509 -
5510 -Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
5511 -
5512 -Параметр запроса: {parentId} - идентификатор агента
5513 -
5514 -В заголовках запроса: X-Auth: Токен авторизации
5515 -
5516 -Ответ:
5517 -
5518 -[ 
5519 - {
5520 - "recordTime": "", ~/~/Время записи
5521 - "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
5522 - "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
5523 - "objectId": 0, ~/~/ID объекта, помещённого в корзину
5524 - "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
5525 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5526 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5527 - "items": [ ~/~/ 
5528 -nullable: true ~/~/Детали
5529 - {
5530 - "name": "string", ~/~/наименование столбца
5531 - "value": "string" ~/~/содержание столбца
5532 - }
5533 - ]
5534 - },
5535 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5536 - "string"
5537 - ]
5538 - }
5539 -]
5540 -
5541 -
5542 -== (% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==
5543 -
5544 -(% class="box infomessage" %)
5545 -(((
5546 -**POST api/v3/Vehicles/recyclebin/erase**
5547 -)))
5548 -
5549 -В заголовках запроса: X-Auth: Токен авторизации
5550 -
5551 -Пример запроса:
5552 -
5553 -[
5554 -0
5555 -]
5556 -
5557 -
5558 -Пример ответа:
5559 -
5560 -[ 
5561 -{
5562 - "recordTime": "", ~/~/Время записи
5563 - "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
5564 - "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
5565 - "objectId": 0, ~/~/ID объекта, помещённого в корзин
5566 - "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
5567 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5568 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5569 - "items": [ ~/~/Детали
5570 - {
5571 - "name": "", ~/~/Имя свойства
5572 - "value": "" ~/~/Значение свойства
5573 - }
5574 - ]
5575 - },
5576 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5577 - ""
5578 - ]
5579 - }
5580 -]
5581 -
5582 -Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
5583 -
5584 -== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) ==
5585 -
5586 -(% class="box infomessage" %)
5587 -(((
5588 -**POST api/v3/Vehicles/recyclebin/restore**
5589 -)))
5590 -
5591 -В заголовках запроса: X-Auth: Токен авторизации
5592 -
5593 -Параметры в теле запроса (JSON):
5594 -
5595 -Восстанавливает объекты из корзины. Возвращает те объекты которые не получилось восстановить.
5596 -
5597 -В заголовках запроса: X-Auth: Токен авторизации
5598 -
5599 -
5600 -Пример запроса:
5601 -
5602 -(((
5603 -[
5604 -)))
5605 -
5606 -(((
5607 - 0
5608 -)))
5609 -
5610 -(((
5611 -]
5612 -)))
5613 -
5614 -
5615 -Пример ответа:
5616 -
5617 -[
5618 -{
5619 - "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи
5620 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину
5621 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину
5622 - "objectId": 0, ~/~/ID объекта, помещённого в корзину
5623 - "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину
5624 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5625 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5626 - "items": [ ~/~/Детали
5627 - {
5628 - "name": "string", ~/~/Имя свойства
5629 - "value": "string" ~/~/Значение свойства
5630 - }
5631 - ]
5632 - },
5633 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5634 - "string"
5635 - ]
5636 - }
5637 -]
5638 -
5639 -
5640 -= **Раздел: Журнал заданий ** =
5641 -
5642 -
5643 -== **Создание задания в Журнале заданий** ==
5644 -
5645 -(% class="box infomessage" %)
5646 -(((
5647 -**POST /api/v3/vehicletasks**
5648 -)))
5649 -
5650 -Пример запроса:
5651 -
5652 -(((
5653 -{
5654 - "vehicleId": 0, ~/~/ Идентификатор ТС
5655 - "description": "string", ~/~/ Описание
5656 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5657 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5658 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы
5659 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы
5660 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5661 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5662 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5663 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5664 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5665 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5666 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5667 - "cost": { 
5668 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5669 - "Name": "string", ~/~/ Наименование
5670 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection )
5671 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5672 - "Norm": 0 ~/~/ Норма внесения
5673 - },
5674 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 
5675 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5676 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания
5677 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления
5678 - "deleted": true, ~/~/ Признак удаления
5679 - "extId": "string", 
5680 - "GeoIds": [ ~/~/ Cвязанные поля
5681 - 0
5682 - ]
5683 -}
5684 -)))
5685 -
5686 -
5687 -Пример ответа:
5688 -
5689 -{
5690 - "vehicleId": 0, ~/~/ Идентификатор ТС
5691 - "description": "string", ~/~/ Описание
5692 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5693 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5694 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5695 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5696 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5697 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5698 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5699 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5700 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5701 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5702 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5703 - "cost": { 
5704 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5705 - "Name": "string", ~/~/ Наименование
5706 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5707 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5708 - "Norm": 0 ~/~/ Норма внесения
5709 - },
5710 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5711 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5712 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5713 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5714 - "deleted": true, ~/~/ Признак удаления
5715 - "extId": "string", ~/~/ ExtId
5716 - "GeoIds": [ ~/~/ Связанные поля
5717 - 0
5718 - ]
5719 -}
5720 -
5721 -
5722 -== **Редактирование задания в Журнале заданий** ==
5723 -
5724 -(% class="box successmessage" %)
5725 -(((
5726 -**PUT /api/v3/vehicletasks**
5727 -)))
5728 -
5729 -Пример запроса:
5730 -
5731 -(((
5732 -{
5733 - "vehicleId": 0, ~/~/ Идентификатор ТС
5734 - "description": "string", ~/~/ Описание
5735 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5736 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5737 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы
5738 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы
5739 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5740 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5741 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5742 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5743 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5744 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5745 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5746 - "cost": { 
5747 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5748 - "Name": "string", ~/~/ Наименование
5749 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5750 - "MeasureType": 0,  ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5751 - "Norm": 0 ~/~/ Норма внесения
5752 - },
5753 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5754 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5755 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания
5756 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления
5757 - "deleted": true, ~/~/ Признак удаления
5758 - "extId": "string", ~/~/ ExtId
5759 - "GeoIds": [ ~/~/ Связанные поля
5760 - 0
5761 - ]
5762 -}
5763 -)))
5764 -
5765 -
5766 -Пример ответа:
5767 -
5768 -{
5769 - "vehicleId": 0, ~/~/ Идентификатор ТС
5770 - "description": "string", ~/~/ Описание
5771 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5772 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5773 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5774 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5775 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5776 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5777 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5778 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5779 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5780 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5781 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5782 - "cost": { 
5783 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5784 - "Name": "string", ~/~/ Наименование
5785 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5786 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5787 - "Norm": 0 ~/~/ Норма внесения
5788 - },
5789 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5790 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5791 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5792 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5793 - "deleted": true, ~/~/ Признак удаления
5794 - "extId": "string", ~/~/ ExtId
5795 - "GeoIds": [ ~/~/ Связанные поля
5796 - 0
5797 - ]
5798 -}
5799 -
5800 -
5801 -== **Удаление задания в Журнале заданий** ==
5802 -
5803 -(% class="box warningmessage" %)
5804 -(((
5805 -**DELETE /api/v3/vehicletasks**
5806 -)))
5807 -
5808 -Пример запроса:
5809 -
5810 -(((
5811 -[
5812 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 
5813 -]
5814 -)))
5815 -
5816 -(((
5817 -
5818 -)))
5819 -
5820 -Пример ответа:
5821 -
5822 -{
5823 - "vehicleId": 0, ~/~/ Идентификатор ТС
5824 - "description": "string", ~/~/ Описание
5825 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5826 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5827 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5828 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5829 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5830 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5831 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5832 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5833 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5834 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5835 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5836 - "cost": { 
5837 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5838 - "Name": "string", ~/~/ Наименование
5839 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5840 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5841 - "Norm": 0 ~/~/ Норма внесения
5842 - },
5843 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5844 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5845 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5846 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5847 - "deleted": true, ~/~/ Признак удаления
5848 - "extId": "string", ~/~/ ExtId
5849 - "GeoIds": [ ~/~/ Связанные поля
5850 - 0
5851 - ]
5852 -}
5853 -
5854 -
5855 -== **Получение списка Журнала заданий** ==
5856 -
5857 -(% class="box infomessage" %)
5858 -(((
5859 -**POST /api/v3/vehicletasks/getbyperiod**
5860 -)))
5861 -
5862 -Пример запроса:
5863 -
5864 -(((
5865 -{
5866 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода.
5867 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода.
5868 - "TimeZone": 0, ~/~/ Часовой пояс.
5869 - "OperationsIds": [  ~/~/ Идентификаторы видов работ для фильтрации журнала
5870 - "3fa85f64-5717-4562-b3fc-2c963f66afa6"
5871 - ],
5872 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала
5873 - 0
5874 - ],
5875 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала
5876 - 0
5877 - ],
5878 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска.
5879 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 
5880 -}
5881 -)))
5882 -
5883 -
5884 -Пример ответа:
5885 -
5886 -(((
5887 -{
5888 - "total": 0,  ~/~/ Общее количество записей
5889 - "pages": 0,  ~/~/ Общее количество страниц
5890 - "currentPage": 0, ~/~/ Текущая страница
5891 - "items": [  ~/~/ Записи 
5892 - {
5893 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
5894 - "isGroup": true,  ~/~/ Вид задания (true - групповое, иначе - одиночное).
5895 - "name": "string", ~/~/ Название задания.
5896 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc
5897 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc
5898 - "workKind": "string", ~/~/ Вид работ
5899 - "techOp": "string", ~/~/ Тех. операция
5900 - "trailerModel": "string", ~/~/ Модель агрегата
5901 - "width": "string", ~/~/ Ширина, м
5902 - "speed": "string", ~/~/ Тех. скорость
5903 - "fields": "string", ~/~/ Поля
5904 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га)
5905 - "vehicles": "string", ~/~/ Объект-модель
5906 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов)
5907 - "drivers": "string", ~/~/ Водители
5908 - "tmc": "string", ~/~/ ТМЦ
5909 - "client": "string", ~/~/  Клиент
5910 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
5911 - "dep": "string", ~/~/ Подразделение
5912 - "geoIds": [ ~/~/  Связанные поля
5913 - 0
5914 - ]
5915 - }
5916 - ]
5917 -}
5918 -)))
5919 -
5920 -
5921 -= **Раздел: Локатор ** =
5922 -
5923 -
5924 -== **Получение списка локаторов, доступных пользователю ** ==
5925 -
5926 -(% class="box infomessage" %)
5927 -(((
5928 -**GET /api/v3/locators**
5929 -)))
5930 -
5931 -В заголовках запроса: X-Auth: Токен авторизации
5932 -
5933 -
5934 -Пример ответа:
5935 -
5936 -(((
5937 -[
5938 - {
5939 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор локатора.
5940 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
5941 - "agentName": "string", ~/~/ Наименование агента.
5942 - "isEnabled": true, ~/~/ Активен 
5943 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания
5944 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления
5945 - "name": "string", ~/~/ Наименование
5946 - "status": 0, ~/~/ 
5947 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 
5948 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 
5949 - "validity": 0, ~/~/ Срок действия в днях (1-90).
5950 - "autoProlongation": true, ~/~/ Автопродление срока действия.
5951 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
5952 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
5953 - "url": "string", ~/~/ Ссылка
5954 - "language": 0, ~/~/ Язык.
5955 - "vehiclesCount": 0, ~/~/ Количество объектов.
5956 - "geozonesCount": 0, ~/~/ Количество геозон.
5957 - "fieldsCount": 0 ~/~/ Количество полей.
5958 - }
5959 -]
5960 -)))
5961 -
5962 -
5963 -
5964 -== **Создание локатора** ==
5965 -
5966 -(% class="box successmessage" %)
5967 -(((
5968 -**POST /api/v3/locators**
5969 -)))
5970 -
5971 -Пример запроса:
5972 -
5973 -(((
5974 -{
5975 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
5976 - "isEnabled": true, ~/~/ Активность
5977 - "name": "string", ~/~/ Наименование локатора
5978 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени)
5979 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/  Время активации
5980 - "validity": 0, ~/~/ Срок действия в днях (1-90)
5981 - "autoProlongation": true, ~/~/ Автопродление срока действия.
5982 - "url": "string", ~/~/ Ссылка
5983 - "language": 0 ~/~/ Язык
5984 -}
5985 -)))
5986 -
5987 -
5988 -Пример ответа:
5989 -
5990 -(((
5991 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора
5992 -)))
5993 -
5994 -
5995 -
5996 -== **Изменение локатора** ==
5997 -
5998 -(% class="box infomessage" %)
5999 -(((
6000 -**PUT /api/v3/locators**
6001 -)))
6002 -
6003 -Пример запроса:
6004 -
6005 -(((
6006 -{
6007 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
6008 - "isEnabled": true, ~/~/ Активность 
6009 - "name": "string", ~/~/ Наименование
6010 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 
6011 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации
6012 - "validity": 0, ~/~/ Срок действия в днях (1-90)
6013 - "autoProlongation": true, ~/~/ Автопродление срока действия
6014 - "url": "string", ~/~/ Ссылка
6015 - "language": 0 ~/~/ Язык
6016 -}
6017 -)))
6018 -
6019 -
6020 -Пример ответа:
6021 -
6022 -200 ~/~/ Success
6023 -
6024 -
6025 -== **Удалить локатор** ==
6026 -
6027 -(% class="box warningmessage" %)
6028 -(((
6029 -**DELETE /api/v3/locators**
6030 -)))
6031 -
6032 -Пример запроса:
6033 -
6034 -(((
6035 -[
6036 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора
6037 -]
6038 -)))
6039 -
6040 -
6041 -
6042 -= **Раздел: Яндекс Маршруты** =
6043 -
6044 -
6045 -== **Возвращение списка маршрутов** ==
6046 -
6047 -(% class="box infomessage" %)
6048 -(((
6049 -**GET /api/v3/TransportRoutes**
6050 -)))
6051 -
6052 -Пример запроса:
6053 -Id  ~/~/ Идентификатор поля
6054 -
6055 -
6056 -Пример ответа:
6057 -
6058 -(((
6059 -[
6060 - {
6061 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 
6062 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6063 - "name": "string", ~/~/ Наименование маршрута.
6064 - "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6065 - "vehicles": [  ~/~/ Определяет список ТС для маршрута
6066 - 0
6067 - ]
6068 - }
6069 -]
6070 -)))
6071 -
6072 -
6073 -
6074 -== **Добавить маршрут** ==
6075 -
6076 -(% class="box infomessage" %)
6077 -(((
6078 -**POST /api/v3/TransportRoutes**
6079 -)))
6080 -
6081 -Пример запроса: 
6082 -{
6083 - "name": "string",  ~/~/  Опредлеляет наименование маршрута.
6084 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6085 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6086 - "vehicles": [  ~/~/ Определяет список ТС для маршрута
6087 - 0
6088 - ]
6089 -}
6090 -
6091 -
6092 -Пример ответа:
6093 -
6094 -(((
6095 -{
6096 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6097 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6098 - "name": "string", ~/~/ Определяет наименование маршрута 
6099 - "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 
6100 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6101 - 0
6102 - ]
6103 -}
6104 -)))
6105 -
6106 -
6107 -== **Обновление маршрута** ==
6108 -
6109 -(% class="box successmessage" %)
6110 -(((
6111 -**PUT /api/v3/TransportRoutes**
6112 -)))
6113 -
6114 -Пример запроса:
6115 -
6116 -(((
6117 -{
6118 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6119 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6120 - "name": "string", ~/~/ Опредлеляет наименование маршрута.
6121 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6122 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6123 - 0
6124 - ]
6125 -}
6126 -)))
6127 -
6128 -
6129 -Пример ответа:
6130 -
6131 -(((
6132 -{
6133 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6134 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6135 - "name": "string", ~/~/ Определяет наименование маршрута 
6136 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6137 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6138 - 0
6139 - ]
6140 -}
6141 -)))
6142 -
6143 -
6144 -== **Получить связки маршрутов ТС** ==
6145 -
6146 -(% class="box infomessage" %)
6147 -(((
6148 -**POST /api/v3/TransportRoutes/getroutesvehicles**
6149 -)))
6150 -
6151 -Пример запроса:
6152 -
6153 -(((
6154 -[
6155 - "3fa85f64-5717-4562-b3fc-2c963f66afa6"  ~/~/ идентификатор маршрута
6156 -]
6157 -)))
6158 -
6159 -
6160 -Пример ответа:
6161 -
6162 -(((
6163 -[
6164 - {
6165 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС
6166 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута
6167 - }
6168 -]
6169 -)))
6170 -
6171 -
6172 -== **Удалить маршрут** ==
6173 -
6174 -(% class="box warningmessage" %)
6175 -(((
6176 -**DELETE /api/v3/TransportRoutes/{id}**
6177 -)))
6178 -
6179 -Пример запроса:
6180 -Id  ~/~/ Идентификатор поля
6181 -
6182 -
6183 -==== ====
6184 -
6185 -= **Раздел: Управление доступа к машинам** =
6186 -
6187 -
6188 -== Получение списка транспортных средств видимых пользователю ==
6189 -
6190 -(% class="box infomessage" %)
6191 -(((
6192 -**GET /api/v3/UserVisibleVehicles/{userId}**
6193 -)))
6194 -
6195 -Пример ответа:
6196 -
6197 -(((
6198 -{
6199 - "vehicleIds": [  ~/~/ Идентификаторы ТС
6200 - 0
6201 - ]
6202 -}
6203 -)))
6204 -
6205 -
6206 -
6207 -== Задает видимость транспортных средств пользователю ==
6208 -
6209 -(% class="box infomessage" %)
6210 -(((
6211 -**POST /api/v3/UserVisibleVehicles**
6212 -)))
6213 -
6214 -Пример запроса:
6215 -
6216 -(((
6217 -(((
6218 -{
6219 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор пользователя
6220 - "vehicleIds": [ ~/~/ Идентификаторы ТС
6221 - 0
6222 - ]
6223 -}
6224 -)))
6225 -
6226 -(((
6227 -
6228 -)))
6229 -
6230 -(((
6231 -
6232 -)))
6233 -
6234 -(((
6235 -Пример ответа :
6236 -)))
6237 -
6238 -(((
6239 -
6240 -)))
6241 -
6242 -(((
6243 -200 ~/~/ Success
6244 -)))
6245 -)))
6246 -
6247 -
6248 -
6249 -
6250 -
6251 -
6252 6252  (% class="box" lang="en-US" style="text-align: center;" %)
6253 6253  (((
6254 6254  (% 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 г.