<
From version < 229.1 >
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,59 +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 -(% class="box infomessage" %)
4326 -(((
4327 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
4328 -)))
4329 -
4330 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4331 -
4332 -Метод запроса: **GET**
4333 -
4334 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
4335 -
4336 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
4337 -
4338 -
4339 -Ответ:
4340 -
4341 -{
4342 -
4343 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4344 -
4345 - "Status": 0, ~/~/ Перечисление состояний выполения запроса
4346 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
4347 -
4348 - "Message": "string", ~/~/ Информация о выполнении запроса
4349 -
4350 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
4351 -
4352 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
4353 -
4354 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4355 -
4356 - "Data": "string" ~/~/ Данные
4357 -
4358 -}
4359 -
4360 4360  == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==
4361 4361  
4362 4362  (% class="box infomessage" %)
... ... @@ -4438,67 +4438,64 @@
4438 4438  Тело запроса:
4439 4439  
4440 4440  {
4441 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов
4442 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса
4443 - "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"
4444 4444  }
4445 4445  
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 +
4446 4446  Ответ:
4447 4447  
4448 4448  {
4449 - "items": [  ~/~/ Список в разрезе ТС
3962 + "items": [
4450 4450   {
4451 - "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода
4452 - "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода
4453 - "vehicleId": 0, ~/~/ ID ТС
4454 - "vehicleName": "string", ~/~/ Название ТС
4455 - "vehicleModel": "string", ~/~/ Модель ТС
4456 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС
4457 - "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС
4458 - "totalViolations": 0, ~/~/ Нарушений всего
4459 - "violationsByType": { ~/~/ Информация о нарушениях по типу
4460 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости
4461 - "accelerationViolations": 0, ~/~/ Нарушений ускорения
4462 - "brakingViolations": 0, ~/~/ Нарушений торможения
4463 - "turningViolations": 0, ~/~/ Нарушений опасного поворота
4464 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения
4465 - "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
4466 4466   },
4467 -
4468 -(((
4469 -
4470 -)))
4471 -
4472 - "moveTime": 0, ~/~/ Продолжительность движения, сек
4473 - "mileage": 0, ~/~/ Пробег, м
4474 - "tripsCount": 0, ~/~/ Кол-во рейсов
4475 - "trips": [  ~/~/ Информация по рейсу
3980 + "moveTime": 0,
3981 + "mileage": 0,
3982 + "tripsCount": 0,
3983 + "trips": [
4476 4476   {
4477 - "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс
4478 - "score": 0, ~/~/ Рассчитанная оценка вождения за рейс
4479 - "violationsCount": 0, ~/~/ Всего нарушений
4480 - "violationsByType": { ~/~/ Информация о нарушениях по типу
4481 - "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости
4482 - "accelerationViolations": 0, ~/~/ Нарушений ускорения
4483 - "brakingViolations": 0, ~/~/ Нарушений торможения
4484 - "turningViolations": 0, ~/~/ Нарушений опасного поворота
4485 - "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения
4486 - "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
4487 4487   },
4488 -
4489 - "startDate": "2024-11-18T13:23:38.516Z",  ~/~/ Дата начала поездки
4490 - "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки
4491 - "moveTime": 0, ~/~/ Продолжительность движения, сек
4492 - "mileage": 0, ~/~/ Пробег, м
4493 - "motohours": 0, ~/~/ Моточасы, секунды
4494 - "maxSpeed": 0, ~/~/ Максимальная скорость за рейс
4495 - "startAddress": "string", ~/~/ Адрес начала рейса
4496 - "endAddress": "string", ~/~/ Адрес конца рейса
4497 - "drivers": [  ~/~/ Список водителей
3996 + "moveTime": 0,
3997 + "mileage": 0,
3998 + "motohours": 0,
3999 + "maxSpeed": 0,
4000 + "startAddress": "string",
4001 + "endAddress": "string",
4002 + "drivers": [
4498 4498   {
4499 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя
4500 - "driverName": "string", ~/~/ФИО водителя
4501 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки
4004 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4005 + "driverName": "string",
4006 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
4502 4502   }
4503 4503   ]
4504 4504   }
... ... @@ -4507,1747 +4507,34 @@
4507 4507   ]
4508 4508  }
4509 4509  
4510 -= (% 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|Номер Карты-метки
4511 4511  
4512 -== (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==
4513 -
4514 -Транзакции по топливным картам можно получить при наличии права «Транзакции ТК». Метод позволяет получить транзакции по нескольким топливным картам.
4515 -
4516 -(% class="box infomessage" %)
4517 -(((
4518 -**POST /api/v3/fuelcards/transactions**
4519 -)))
4520 -
4521 -Метод запроса: POST
4522 -
4523 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards/transactions
4524 -\\В заголовках запроса: X-Auth: Токен авторизации
4525 -
4526 -Параметры в теле запроса (JSON):
4527 -
4528 -{
4529 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ Начало периода
4530 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ Конец периода
4531 - "ids": [ 
4532 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы топливных карт
4533 - ],
4534 - "timezone": 0 ~/~/ Часовой пояс
4535 -}
4536 -
4537 -
4538 -Ответ:
4539 - {
4540 - "date": "2024-04-11T10:41:02.265Z", ~/~/ Дата и время транзакции
4541 - "driver": "string", ~/~/ Водители, привязанные к ТК
4542 - "object": "string", ~/~/ Наименование ТС
4543 - "amount": 0, ~/~/ Количество топлива
4544 - "amountDut": 0, ~/~/ Количество по ДУТ
4545 - "amountDiff": 0, ~/~/ Разница, л
4546 - "amountDiffPerc": 0, ~/~/ Разница, %
4547 - "summa": 0, ~/~/ Стоимость, руб
4548 - "serviceName": "string", ~/~/ Тип топлива
4549 - "price": 0, ~/~/ Цена за литр, руб
4550 - "cardName": "string", ~/~/ Наименование ТК
4551 - "cardNum": "string", ~/~/ Номер ТК
4552 - "operator": "string", ~/~/ Оператор ТК
4553 - "address": "string" ~/~/ Адрес АЗС
4554 - }
4555 -
4556 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) ==
4557 -
4558 -(% class="box infomessage" %)
4559 -(((
4560 -**GET /api/v3/fuelcards**
4561 -)))
4562 -
4563 -Метод запроса: GET
4564 -
4565 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список
4566 -
4567 -Ответ:
4568 -
4569 -[
4570 - {
4571 - "Name": "string", ~/~/ Определяет наименование карты.
4572 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора.
4573 - "Number": "string", ~/~/ Определяет № карты.
4574 - "Enabled": true, ~/~/ Определяет признак активности карты.
4575 - "Description": "string", ~/~/ Определяет описание карты.
4576 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты
4577 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
4578 - "deleted": true ~/~/ Признак удаления
4579 - }
4580 -]
4581 -
4582 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
4583 -
4584 -
4585 -== **Получение полных данных о ретрансляторе** ==
4586 -
4587 -(% class="box infomessage" %)
4588 -(((
4589 -**GET ** **/api/v3/retranslations/{id}**
4590 -)))
4591 -
4592 -id - Идентификатор ретранслятора
4593 -
4594 -
4595 -Пример ответа:
4596 -
4597 -{  
4598 -"description": "", ~/~/ Поле описания ретранслятора
4599 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4600 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4601 -"isEnabled": true, ~/~/ Признак включения ретранслятора, Включен, true - включен, false - отключен
4602 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4603 -"objects": [ ~/~/ Объекты для ретрансляции
4604 -{      
4605 -"id": "",  ~/~/ Идентификатор объекта ретрансляции
4606 -"name": "", ~/~/ Наименование объекта ретрансляции
4607 -"imei": "", ~/~/ IMEI объекта  ретрансляции
4608 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4609 -}
4610 - ],  
4611 -"id": "", ~/~/ Идентификатор ретранслятора 
4612 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4613 -"deleted": "" ~/~/ Признак удаления ретранслятора: true - включен, false - отключен
4614 -}
4615 -
4616 -
4617 -== **Удаление данных ретранслятора** ==
4618 -
4619 -(% class="box infomessage" %)
4620 -(((
4621 -**DELETE** **/api/v3/retranslations/{id}**
4622 -)))
4623 -
4624 -id - Идентификатор ретранслятора
4625 -
4626 -
4627 -== **Создание ретранслятора** ==
4628 -
4629 -(% class="box infomessage" %)
4630 -(((
4631 -**POST ** **/api/v3/retranslations/{id}**
4632 -)))
4633 -
4634 -Запрос:
4635 -
4636 -{  
4637 -"description": "", ~/~/ Поле описания ретранслятора
4638 -"subscriberId": "", ~/~/ Идентификатор подписчика
4639 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4640 -"address": "", ~/~/ Адрес и порт принимающего сервера
4641 -"isEnabled": "", ~/~/ Признак включения ретранслятора, true - включен, false - отключен
4642 -"objects": [ ~/~/Объекты для ретрансляции
4643 -{      
4644 -"id": "", ~/~/ Идентификатор ретранслятора 
4645 -"imei": "", ~/~/ IMEI объекта ретрансляции
4646 -"isEnabled": ""  ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4647 -}
4648 - ]
4649 -}
4650 -
4651 -
4652 -Ответ:
4653 -
4654 -{  
4655 -"description": "", ~/~/ Поле описания ретранслятора
4656 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4657 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4658 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4659 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4660 -"objects": [ ~/~/ Объекты для ретрансляции
4661 -{      
4662 -"id": "", ~/~/ Идентификатор объекта ретрансляции     
4663 -"name": "string", ~/~/ Наименование объекта ретрансляции    
4664 -"imei": "", ~/~/ IMEI объекта ретрансляции
4665 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен  
4666 -}
4667 - ],
4668 -"id": "", ~/~/ Идентификатор ретранслятора   
4669 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4670 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4671 -}
4672 -
4673 -
4674 -== **Редактирование ретранслятора** ==
4675 -
4676 -(% class="box infomessage" %)
4677 -(((
4678 -**PUT** **/api/v3/retranslations**
4679 -)))
4680 -
4681 -Пример запроса:
4682 -
4683 -{  
4684 -"id": "", ~/~/ Идентификатор ретранслятора   
4685 -"description": "string", ~/~/ Поле описания ретранслятора
4686 -"subscriberId": "", ~/~/ Идентификатор подписчика
4687 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4688 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4689 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4690 -"objects": ~/~/ Объекты для ретрансляции
4691 -[    
4692 -{      
4693 -"id": "",  ~/~/ Идентификатор объекта ретрансляции 
4694 -"imei": "", ~/~/ IMEI объекта ретрансляции
4695 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
4696 -}
4697 - ]
4698 -}
4699 -
4700 -
4701 -Пример ответа:
4702 -
4703 -{  
4704 -"description": "", ~/~/ Поле описания ретранслятора
4705 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4706 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4707 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4708 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4709 -"objects": [ ~/~/ Объекты для ретрансляции
4710 -{      
4711 -"id": "", ~/~/ Идентификатор объекта ретрансляции     
4712 -"name": "string", ~/~/ Наименование объекта ретрансляции    
4713 -"imei": "", ~/~/ IMEI объекта ретрансляции
4714 -"isEnabled": true ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен  
4715 -}
4716 - ],
4717 -"id": "", ~/~/ Идентификатор ретранслятора   
4718 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4719 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4720 -}
4721 -
4722 -
4723 -== **Получение списка ретранслятора клиента** ==
4724 -
4725 -(% class="box infomessage" %)
4726 -(((
4727 -**POST /api/v3/retranslations/find**
4728 -)))
4729 -
4730 -Пример запроса:
4731 -
4732 -{  
4733 -"id": "", ~/~/ Идентификатор ретранслятора   
4734 -"search": "string", ~/~/ Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
4735 -"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (обязательный параметр).
4736 -}
4737 -
4738 -Ответ:
4739 -
4740 -[ 
4741 -{    
4742 -"description": "", ~/~/ Поле описания ретранслятора
4743 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
4744 -"protocolType": 0, ~/~/ Тип протокола ретрансляции
4745 -"isEnabled": true, ~/~/ Признак включения ретранслятора: true - включен, false - отключен
4746 -"address": "string", ~/~/ Адрес и порт принимающего сервера
4747 -"id": "", ~/~/ Идентификатор ретранслятора   
4748 -"parentId": "", ~/~/ Идентификатор родителя (вышестоящего клиента)
4749 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
4750 -}
4751 -]
4752 -
4753 -
4754 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Отчеты**(%%) =
4755 -
4756 -== **API для отчета по выгрузке комбайнов** ==
4757 -
4758 -(% class="box infomessage" %)
4759 -(((
4760 -**POST /api/v3/Reports/harvesterUnloading**
4761 -)))
4762 -
4763 -Пример запроса:
4764 -
4765 -{
4766 - "byTime": 0, ~/~/ Объединение событий по времени
4767 - "byDist": 0, ~/~/ Объединение событий по расстоянию
4768 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
4769 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
4770 - "showNearestObjects": true, ~/~/Показывать объекты рядом?
4771 - "vehicleIds": [ ~/~/ Список id объектов для анализа
4772 - 0
4773 - ],
4774 - "from": "", ~/~/ Дата и время начало запроса
4775 - "to": "", ~/~/ Дата и время окончания запроса
4776 - "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
4777 -}
4778 -
4779 -Пример ответа:
4780 -
4781 -[ 
4782 - {
4783 - "harvesterName": "", ~/~/Комбайн, номер
4784 - "harvesterId": 0, ~/~/Комбайн, id
4785 -"harvesterModel": "", ~/~/ Модель комбайна
4786 -"hopperCapacity": 0, ~/~/ Объем бункера м3
4787 - "hopperDischargeSpeed": 0, ~/~/ Скорость выгрузки из бункера, л/сек
4788 - "events": [ ~/~/Список событий в разрезе комбайна
4789 - {
4790 - "driverId": "", ~/~/Идентификатор водителя
4791 - "driverName": "", ~/~/Водитель комбайна, ФИО
4792 - "RFID": "", ~/~/ идентификатор карты-метки
4793 - "rfidName": "", ~/~/Водитель комбайна, имя метки
4794 - "vehicleId": 0, ~/~/идентификатор объекта
4795 - "vehicleName": "string", ~/~/ Имя объекта
4796 - "modelName": "string", ~/~/ Имя модели объекта
4797 - "nearestVehicles": [ ~/~/Объекты рядом
4798 - {
4799 - "vehicleId": 0, ~/~/идентификатор объекта
4800 - "vehicleName": "string" ~/~/ Имя объекта
4801 - }
4802 - ],
4803 - "fields": [ ~/~/Поля, где происходила выгрузка
4804 - {
4805 - "id": 0, ~/~/ идентификатор пользователя 
4806 - "name": "string" ~/~/ имя пользователя 
4807 - }
4808 - ],
4809 - "event": "string", ~/~/Событие
4810 - "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода
4811 - "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода
4812 - "durationSeconds": 0, ~/~/Продолжительность события, в секундах
4813 - "cultureName": "string", ~/~/ название культуры
4814 - "bunkerLowLevelStart": 0, ~/~/Бункер, нижний уровень (на начало события)
4815 - "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события)
4816 - "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события)
4817 - "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события)
4818 - "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события)
4819 - "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события)
4820 - "issued": 0, ~/~/Выдано, бункеров
4821 - "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера)
4822 - "latitude": 0, ~/~/Широта
4823 - "longitude": 0, ~/~/ Долгота
4824 - "litresAway": 0, ~/~/Отдано, л
4825 - "m3Away": 0 ~/~/Отдано, м3
4826 - }
4827 - ]
4828 - }
4829 -]
4830 -
4831 -
4832 -== **Отчет трек-датчики** ==
4833 -
4834 -(% class="box infomessage" %)
4835 -(((
4836 -**POST /api/v3/Reports/sensorsWorks**
4837 -)))
4838 -
4839 -**Пример запроса:**
4840 -
4841 -{
4842 - "vehicleIds": [ ~/~/ Список ID объектов
4843 - 0
4844 - ],
4845 - "from": "2025-02-20T06:39:23.888Z",  ~/~/ Начало периода (локальное время клиента)
4846 - "to": "2025-02-20T06:39:23.888Z", ~/~/  Конец периода (локальное время клиента)
4847 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4848 -}
4849 -
4850 -**Пример ответа:**
4851 -
4852 -(((
4853 -{
4854 - "vehicleSensorWorks": [  ~/~/ Интервалы работы оборудования для конкретного ТС
4855 - {
4856 - "vehicleId": 0, ~/~/ Идентификатор ТС
4857 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 
4858 - {
4859 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования.
4860 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования.
4861 - "duration": 0, ~/~/  Продолжительность интервала в секундах.
4862 - "name": "string", ~/~/ Наименование оборудования.
4863 - "mileage": 0, ~/~/ Пробег за время работы оборудования.
4864 - "totalMileage": 0, ~/~/ Общий пробег.
4865 - "avgSpeed": 0 ~/~/ Средняя скорость.
4866 - }
4867 - ]
4868 - }
4869 - ]
4870 -}
4871 -
4872 -
4873 -== **Превышение скорости** ==
4874 -
4875 -(% class="box infomessage" %)
4876 -(((
4877 -**POST /api/v3/Reports/overSpeedDuration**
4878 -)))
4879 -
4880 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение).
4881 -
4882 -Пример запроса:
4883 -
4884 -(((
4885 -{
4886 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства
4887 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента)
4888 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента)
4889 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4890 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 
4891 -}
4892 -)))
4893 -
4894 -(((
4895 -
4896 -)))
4897 -
4898 -(((
4899 -Пример ответа:
4900 -)))
4901 -
4902 -(((
4903 -(((
4904 -[
4905 - {
4906 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/  Дата и время события 
4907 - "duration": 0, ~/~/ Продолжительность события в секундах 
4908 - "maxSpeed": 0, ~/~/ Максимальная скорость 
4909 - "speedLimit": 0 ~/~/ Ограничение скорости 
4910 - }
4911 -]
4912 -)))
4913 -)))
4914 -)))
4915 -
4916 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
4917 -
4918 -
4919 -== **Запрос списка полей** ==
4920 -
4921 -(% class="box successmessage" %)
4922 -(((
4923 -**POST /api/v3/agroLands/find**
4924 -)))
4925 -
4926 -Пример запроса:
4927 -
4928 -(((
4929 -(((
4930 -(((
4931 -{
4932 - "year": 0, ~/~/ Фильтр по году
4933 - "name": "string", ~/~/ Фильтр по названию
4934 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению
4935 -}
4936 -)))
4937 -)))
4938 -
4939 -
4940 -)))
4941 -
4942 -Пример ответа:
4943 -
4944 -(((
4945 -[
4946 - {
4947 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
4948 - "year": 0, ~/~/ Год поля
4949 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая
4950 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая
4951 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
4952 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
4953 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
4954 - "counts": { ~/~/ Счётчики с/х поля 
4955 - "fieldOperations": 0, ~/~/ Количество операций на поле
4956 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
4957 - "facts": 0 ~/~/ Счётчик факта
4958 - },
4959 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4960 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4961 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4962 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
4963 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
4964 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
4965 - "planComment": "string", ~/~/ Комментарий к полю
4966 - "productivity": 0, ~/~/ Урожайность.
4967 - "id": 0, ~/~/ Идентификатор объекта геозоны
4968 - "name": "string", ~/~/ Название объекта геозоны
4969 - "type": 0, ~/~/ Тип объекта геозоны
4970 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
4971 - "fname": "string", ~/~/ Имя файла
4972 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
4973 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны
4974 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны
4975 - "description": "string", ~/~/ Описание объекта геозоны
4976 - "area": 0, ~/~/ Площадь, м2
4977 - "perimetr": 0, ~/~/ Периметр, м
4978 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд
4979 - }
4980 -]
4981 -
4982 -
4983 -== **Создание нового поля ** ==
4984 -
4985 -(% class="box successmessage" %)
4986 -(((
4987 -**POST /api/v3/agroLands**
4988 -)))
4989 -
4990 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 
4991 -X-agent  - ID клиента
4992 -
4993 -Пример запроса:
4994 -
4995 -(((
4996 -{
4997 - "extId": "string", 
4998 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля
4999 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля
5000 - "display": "string", ~/~/ Настройки отображения
5001 - "year": 0, ~/~/ Год поля
5002 - "name": "string", ~/~/ Наименование
5003 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5004 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая
5005 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая
5006 - "planComment": "string", ~/~/ Комментарий к полю
5007 - "cropRotations": [ ~/~/ Данные по севообороту
5008 - {
5009 - "landId": 0, ~/~/ ID поля
5010 - "landName": "string", ~/~/ Название поля
5011 - "year": 0, ~/~/ Год урожая
5012 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5013 - "cultureName": "string", ~/~/ Название культуры
5014 - "productivity": 0, ~/~/ Урожайность
5015 - "area": 0, ~/~/ Площадь поля, Га
5016 - "total": 0, ~/~/ Валовый сбор
5017 - "productivityFact": 0, ~/~/ Фактическая урожайность
5018 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5019 - "totalFact": 0, ~/~/ Фактический валовый сбор
5020 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ
5021 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева
5022 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая
5023 - "isyearplan": true, ~/~/ Годовой план 
5024 - "comment": "string" ~/~/ Комментарий
5025 - }
5026 - ]
5027 -}
5028 -)))
5029 -
5030 -(((
5031 -
5032 -)))
5033 -
5034 -Пример ответа:
5035 -
5036 -(((
5037 -(((
5038 -{
5039 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
5040 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5041 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5042 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5043 - "cropRotations": [ ~/~/ Данные по севообороту
5044 - {
5045 - "landId": 0, ~/~/ ID поля
5046 - "landName": "string", ~/~/ Название поля
5047 - "year": 0, ~/~/ Год урожая 
5048 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5049 - "cultureName": "string", ~/~/ Название культуры
5050 - "productivity": 0, ~/~/ Урожайность
5051 - "area": 0, ~/~/ Площадь поля, Га.
5052 - "total": 0, ~/~/ Валовый сбор
5053 - "productivityFact": 0, ~/~/ Фактическая урожайность
5054 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5055 - "totalFact": 0, ~/~/ Фактический валовый сбор
5056 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ
5057 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева
5058 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая
5059 - "isyearplan": true, ~/~/ годовой план 
5060 - "comment": "string" ~/~/ Комментарий
5061 - }
5062 - ],
5063 - "cropVegetation": [ ~/~/ История вегетации поля
5064 - {
5065 - "values": [  ~/~/ Данные вегетации и состояния посева
5066 - {
5067 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5068 - "ndvi": 0 ~/~/ Индекс вегетации
5069 - }
5070 - ],
5071 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5072 - {
5073 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5074 - "type": "string", ~/~/ Тип
5075 - "pictureid": "string" ~/~/ Идентификатор ресурса
5076 - }
5077 - ],
5078 - "states": [ ~/~/ Ключевые даты развития поля
5079 - {
5080 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
5081 - "state": 0 ~/~/ Статус  0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5082 - }
5083 - ]
5084 - }
5085 - ],
5086 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая
5087 - "counts": {
5088 - "fieldOperations": 0, ~/~/ Количество операций на поле
5089 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5090 - "facts": 0 ~/~/ Счётчик факта
5091 - },
5092 - "planComment": "string", ~/~/ Комментарий к полю
5093 -)))
5094 -
5095 -(((
5096 - "productivity": 0, ~/~/ Урожайность.
5097 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5098 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая
5099 - "year": 0, ~/~/ Год поля
5100 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5101 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5102 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5103 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5104 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто
5105 - "id": 0, ~/~/ Идентификатор объекта геозоны
5106 - "name": "string", ~/~/ Название объекта геозоны
5107 - "type": 0, ~/~/ Тип объекта геозоны
5108 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5109 - "fname": "string", ~/~/ Имя файла
5110 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5111 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны
5112 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны
5113 - "description": "string", ~/~/ Описание объекта геозоны
5114 - "area": 0, ~/~/ Площадь, м2
5115 - "perimetr": 0, ~/~/ Периметр, м
5116 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд
5117 -}
5118 -
5119 -
5120 -)))
5121 -)))
5122 -)))
5123 -
5124 -== **Получение поля по id** ==
5125 -
5126 -(% class="box infomessage" %)
5127 -(((
5128 -**GET /api/v3/agroLands/{id}**
5129 -)))
5130 -
5131 -Пример запроса:
5132 -id  ~/~/ Идентификатор поля
5133 -
5134 -Пример ответа:
5135 -
5136 -(((
5137 -{
5138 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
5139 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5140 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5141 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5142 - "cropRotations": [ ~/~/ Данные по севообороту
5143 - {
5144 - "landId": 0, ~/~/ ID поля
5145 - "landName": "string", ~/~/ Название поля
5146 - "year": 0, ~/~/ Год урожая
5147 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5148 - "cultureName": "string", ~/~/ Название культуры
5149 - "productivity": 0, ~/~/ Урожайность
5150 - "area": 0, ~/~/ Площадь поля, Га
5151 - "total": 0, ~/~/ Валовый сбор
5152 - "productivityFact": 0, ~/~/ Фактическая урожайность
5153 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5154 - "totalFact": 0, ~/~/ Фактический валовый сбор
5155 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ
5156 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева
5157 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая
5158 - "isyearplan": true, ~/~/ План года 
5159 - "comment": "string" ~/~/ Комментарий
5160 - }
5161 - ],
5162 - "cropVegetation": [ ~/~/ История вегетации поля
5163 - {
5164 - "values": [ ~/~/ Данные вегетации и состояния посева
5165 - {
5166 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
5167 - "ndvi": 0 ~/~/ Индекс вегетации
5168 - }
5169 - ],
5170 - "resources": [  ~/~/ Данные о снимках для каждого значения NDVI
5171 - {
5172 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
5173 - "type": "string", ~/~/ Тип 
5174 - "pictureid": "string" ~/~/ Идентификатор ресурса
5175 - }
5176 - ],
5177 - "states": [ ~/~/ Ключевые даты развития поля
5178 - {
5179 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 
5180 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая
5181 - }
5182 - ]
5183 - }
5184 - ],
5185 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая
5186 - "counts": {
5187 - "fieldOperations": 0, ~/~/ Количество операций на поле
5188 - "actualFieldOperations": 0,  ~/~/ Кол-во актуальных операций на поле
5189 - "facts": 0 ~/~/ Счётчик факта
5190 - },
5191 - "planComment": "string", ~/~/ Комментарий к полю
5192 - "productivity": 0, ~/~/ Урожайность.
5193 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5194 -)))
5195 -
5196 -(((
5197 -(((
5198 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая
5199 - "year": 0, ~/~/ Год поля
5200 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 
5201 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5202 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5203 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5204 - "status": 0,  ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
5205 - "id": 0, ~/~/ Идентификатор объекта геозоны
5206 - "name": "string", ~/~/ Название объекта геозоны
5207 - "type": 0, ~/~/ Тип объекта геозоны 
5208 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5209 - "fname": "string", ~/~/ Имя файла
5210 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5211 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны
5212 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны
5213 - "description": "string", ~/~/ Описание объекта геозоны
5214 - "area": 0, ~/~/ Площадь, м2
5215 - "perimetr": 0, ~/~/ Периметр, м
5216 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд
5217 -}
5218 -)))
5219 -
5220 -
5221 -== **Удаление существующего поля** ==
5222 -
5223 -(% class="box errormessage" %)
5224 -(((
5225 -**DELETE /api/v3/agroLands/{id}**
5226 -)))
5227 -
5228 -Пример запроса:
5229 -id  ~/~/ Идентификатор поля
5230 -
5231 -Пример ответа:
5232 -
5233 -(((
5234 -200 ~/~/ Успех
5235 -)))
5236 -
5237 -(((
5238 -
5239 -)))
5240 -
5241 -(((
5242 -(((
5243 -(((
5244 -
5245 -)))
5246 -
5247 -(((
5248 -== **Изменение поля** ==
5249 -
5250 -(% class="box infomessage" %)
5251 -(((
5252 -**PUT /api/v3/agroLands**
5253 -)))
5254 -
5255 -Пример запроса:
5256 -
5257 -(((
5258 -(((
5259 -{
5260 - "id": 0, ~/~/ Идентификатор поля
5261 - "extId": "string", ~/~/ ExtId
5262 - "shape": "string", ~/~/ Форма поля
5263 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
5264 - "display": "string", ~/~/ Настройки отображения
5265 - "year": 0, ~/~/ Год поля
5266 - "name": "string", ~/~/ Наименование
5267 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5268 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая
5269 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая
5270 - "planComment": "string", ~/~/Комментарий к полю
5271 - "cropRotations": [  ~/~/ Данные по севообороту
5272 - {
5273 - "landId": 0, ~/~/ ID поля
5274 - "landName": "string", ~/~/ Название поля
5275 - "year": 0, ~/~/ Год урожая
5276 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5277 - "cultureName": "string", ~/~/ Название культуры
5278 - "productivity": 0, ~/~/ Урожайность
5279 - "area": 0, ~/~/ Площадь поля, Га.
5280 - "total": 0, ~/~/ Валовый сбор
5281 - "productivityFact": 0, ~/~/ Фактическая урожайность
5282 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5283 - "totalFact": 0, ~/~/ Фактический валовый сбор
5284 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ
5285 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева
5286 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая
5287 - "isyearplan": true, 
5288 - "comment": "string" ~/~/ Комментарий
5289 - }
5290 - ],
5291 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику
5292 -}
5293 -)))
5294 -)))
5295 -
5296 -(((
5297 -
5298 -)))
5299 -
5300 -Пример ответа:
5301 -
5302 -(((
5303 -(((
5304 -(((
5305 -{
5306 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
5307 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5308 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5309 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5310 - "cropRotations": [ ~/~/ Данные по севообороту
5311 - {
5312 - "landId": 0, ~/~/ ID поля
5313 - "landName": "string", ~/~/ Название поля
5314 - "year": 0, ~/~/  Год урожая
5315 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5316 - "cultureName": "string", ~/~/ Название культуры
5317 - "productivity": 0, ~/~/ Урожайность
5318 - "area": 0, ~/~/ Площадь поля, Га
5319 - "total": 0, ~/~/ Валовый сбор
5320 - "productivityFact": 0, ~/~/ Фактическая урожайность
5321 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5322 - "totalFact": 0, ~/~/ Фактический валовый сбор
5323 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ
5324 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева
5325 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая
5326 - "isyearplan": true, ~/~/ 
5327 - "comment": "string" ~/~/ Комментарий
5328 - }
5329 - ],
5330 - "cropVegetation": [ ~/~/ История вегетации поля
5331 - {
5332 - "values": [ ~/~/ Данные вегетации и состояния посева
5333 - {
5334 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5335 - "ndvi": 0 ~/~/ Индекс вегетации
5336 - }
5337 - ],
5338 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5339 - {
5340 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5341 - "type": "string", ~/~/ Тип
5342 - "pictureid": "string" ~/~/ Идентификатор ресурса
5343 - }
5344 - ],
5345 - "states": [ ~/~/ Ключевые даты развития поля 
5346 - {
5347 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
5348 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5349 - }
5350 - ]
5351 - }
5352 - ],
5353 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая
5354 - "counts": { 
5355 - "fieldOperations": 0, ~/~/ Количество операций на поле
5356 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5357 - "facts": 0 ~/~/ Счётчик факта
5358 - },
5359 - "planComment": "string", ~/~/ Комментарий к полю
5360 - "productivity": 0, ~/~/ Урожайность.
5361 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5362 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая
5363 - "year": 0, ~/~/ Год поля
5364 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5365 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5366 - "factState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5367 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
5368 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 
5369 - "id": 0, ~/~/ Идентификатор объекта геозоны
5370 - "name": "string", ~/~/ Название объекта геозоны
5371 - "type": 0, ~/~/ Тип объекта геозоны
5372 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5373 - "fname": "string", ~/~/ Имя файла
5374 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5375 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны
5376 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны
5377 - "description": "string", ~/~/ Описание объекта геозоны
5378 - "area": 0, ~/~/ Площадь, м2
5379 - "perimetr": 0, ~/~/ Периметр, м
5380 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд
5381 -}
5382 -)))
5383 -)))
5384 -)))
5385 -)))
5386 -)))
5387 -
5388 -
5389 -== **Редактирование года урожая ** ==
5390 -
5391 -(% class="box successmessage" %)
5392 -(((
5393 -**POST /api/v3/agroLands/updateOpenCloseYear**
5394 -)))
5395 -
5396 -Пример запроса:
5397 -
5398 -(((
5399 -(((
5400 -{
5401 - "agroLandIds": [  ~/~/ Идентификаторы полей для которых меняется год урожая
5402 - 0
5403 - ],
5404 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая
5405 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая
5406 -}
5407 -)))
5408 -
5409 -
5410 -)))
5411 -
5412 -Пример ответа:
5413 -
5414 -(((
5415 -(((
5416 -{
5417 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
5418 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
5419 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
5420 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
5421 - "cropRotations": [ ~/~/ Данные по севообороту
5422 - {
5423 - "landId": 0, ~/~/ ID поля
5424 - "landName": "string", ~/~/ Название поля
5425 - "year": 0, ~/~/ Год урожая
5426 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
5427 - "cultureName": "string", ~/~/ Название культуры
5428 - "productivity": 0, ~/~/ Урожайность
5429 - "area": 0, ~/~/ Площадь поля, Га.
5430 - "total": 0, ~/~/ Валовый сбор
5431 - "productivityFact": 0, ~/~/ Фактическая урожайность
5432 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
5433 - "totalFact": 0, ~/~/ Фактический валовый сбор
5434 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ
5435 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева
5436 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая
5437 - "isyearplan": true, ~/~/ 
5438 - "comment": "string" ~/~/ Комментарий
5439 - }
5440 - ],
5441 - "cropVegetation": [ ~/~/ История вегетации поля
5442 - {
5443 - "values": [ ~/~/ Данные вегетации и состояния посева
5444 - {
5445 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
5446 - "ndvi": 0 ~/~/ Индекс вегетации
5447 - }
5448 - ],
5449 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
5450 - {
5451 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
5452 - "type": "string", ~/~/ Тип
5453 - "pictureid": "string" ~/~/ Идентификатор ресурса
5454 - }
5455 - ],
5456 - "states": [ ~/~/ Ключевые даты развития поля
5457 - {
5458 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 
5459 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
5460 - }
5461 - ]
5462 - }
5463 - ],
5464 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая
5465 - "counts": { 
5466 - "fieldOperations": 0, ~/~/ Количество операций на поле
5467 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
5468 - "facts": 0 ~/~/ Счётчик факта
5469 - },
5470 - "planComment": "string", ~/~/ Комментарий к полю
5471 - "productivity": 0, ~/~/ Урожайность.
5472 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
5473 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая
5474 - "year": 0, ~/~/ Год поля
5475 - "planState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5476 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5477 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5478 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
5479 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
5480 - "id": 0, ~/~/ Идентификатор объекта геозоны
5481 - "name": "string", ~/~/ Название объекта геозоны
5482 - "type": 0, ~/~/ Тип объекта геозоны
5483 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
5484 - "fname": "string", ~/~/ Имя файла
5485 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
5486 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны
5487 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны
5488 - "description": "string", ~/~/ Описание объекта геозоны
5489 - "area": 0, ~/~/ Площадь, м2
5490 - "perimetr": 0, ~/~/ ериметр, м
5491 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
5492 -}
5493 -)))
5494 -
5495 -
5496 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
5497 -)))
5498 -)))
5499 -)))
5500 -
5501 -== (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
5502 -
5503 -
5504 -(% class="box infomessage" %)
5505 -(((
5506 -**GET api/v3/Vehicles/recyclebin/all**
5507 -)))
5508 -
5509 -Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
5510 -
5511 -Параметр запроса: {parentId} - идентификатор агента
5512 -
5513 -В заголовках запроса: X-Auth: Токен авторизации
5514 -
5515 -Ответ:
5516 -
5517 -[ 
5518 - {
5519 - "recordTime": "", ~/~/Время записи
5520 - "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
5521 - "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
5522 - "objectId": 0, ~/~/ID объекта, помещённого в корзину
5523 - "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
5524 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5525 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5526 - "items": [ ~/~/ 
5527 -nullable: true ~/~/Детали
5528 - {
5529 - "name": "string", ~/~/наименование столбца
5530 - "value": "string" ~/~/содержание столбца
5531 - }
5532 - ]
5533 - },
5534 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5535 - "string"
5536 - ]
5537 - }
5538 -]
5539 -
5540 -
5541 -== (% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==
5542 -
5543 -(% class="box infomessage" %)
5544 -(((
5545 -**POST api/v3/Vehicles/recyclebin/erase**
5546 -)))
5547 -
5548 -В заголовках запроса: X-Auth: Токен авторизации
5549 -
5550 -Пример запроса:
5551 -
5552 -[
5553 -0
5554 -]
5555 -
5556 -
5557 -Пример ответа:
5558 -
5559 -[ 
5560 -{
5561 - "recordTime": "", ~/~/Время записи
5562 - "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
5563 - "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
5564 - "objectId": 0, ~/~/ID объекта, помещённого в корзин
5565 - "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
5566 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5567 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5568 - "items": [ ~/~/Детали
5569 - {
5570 - "name": "", ~/~/Имя свойства
5571 - "value": "" ~/~/Значение свойства
5572 - }
5573 - ]
5574 - },
5575 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5576 - ""
5577 - ]
5578 - }
5579 -]
5580 -
5581 -Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
5582 -
5583 -== (% style="color:#000000; font-size:16px" %)**Запрос на восстановление объектов из корзины**(%%) ==
5584 -
5585 -(% class="box infomessage" %)
5586 -(((
5587 -**POST api/v3/Vehicles/recyclebin/restore**
5588 -)))
5589 -
5590 -В заголовках запроса: X-Auth: Токен авторизации
5591 -
5592 -Параметры в теле запроса (JSON):
5593 -
5594 -Восстанавливает объекты из корзины. Возвращает те объекты которые не получилось восстановить.
5595 -
5596 -В заголовках запроса: X-Auth: Токен авторизации
5597 -
5598 -
5599 -Пример запроса:
5600 -
5601 -(((
5602 -[
5603 -)))
5604 -
5605 -(((
5606 - 0
5607 -)))
5608 -
5609 -(((
5610 -]
5611 -)))
5612 -
5613 -
5614 -Пример ответа:
5615 -
5616 -[
5617 -{
5618 - "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи
5619 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid пользователя, добавившего объект в корзину
5620 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину
5621 - "objectId": 0, ~/~/ID объекта, помещённого в корзину
5622 - "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину
5623 - "objectType": 1, ~/~/Тип объекта, помещённого в корзину
5624 - "details": { ~/~/Список деталей объекта, помещённого в корзину
5625 - "items": [ ~/~/Детали
5626 - {
5627 - "name": "string", ~/~/Имя свойства
5628 - "value": "string" ~/~/Значение свойства
5629 - }
5630 - ]
5631 - },
5632 - "errors": [ ~/~/Список ошибок удаления/восстановления объекта
5633 - "string"
5634 - ]
5635 - }
5636 -]
5637 -
5638 -
5639 -= **Раздел: Журнал заданий ** =
5640 -
5641 -
5642 -== **Создание задания в Журнале заданий** ==
5643 -
5644 -(% class="box infomessage" %)
5645 -(((
5646 -**POST /api/v3/vehicletasks**
5647 -)))
5648 -
5649 -Пример запроса:
5650 -
5651 -(((
5652 -{
5653 - "vehicleId": 0, ~/~/ Идентификатор ТС
5654 - "description": "string", ~/~/ Описание
5655 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5656 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5657 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы
5658 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы
5659 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5660 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5661 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5662 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5663 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5664 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5665 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5666 - "cost": { 
5667 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5668 - "Name": "string", ~/~/ Наименование
5669 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection )
5670 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5671 - "Norm": 0 ~/~/ Норма внесения
5672 - },
5673 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 
5674 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5675 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания
5676 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления
5677 - "deleted": true, ~/~/ Признак удаления
5678 - "extId": "string", 
5679 - "GeoIds": [ ~/~/ Cвязанные поля
5680 - 0
5681 - ]
5682 -}
5683 -)))
5684 -
5685 -
5686 -Пример ответа:
5687 -
5688 -{
5689 - "vehicleId": 0, ~/~/ Идентификатор ТС
5690 - "description": "string", ~/~/ Описание
5691 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5692 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5693 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5694 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5695 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5696 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5697 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5698 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5699 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5700 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5701 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5702 - "cost": { 
5703 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5704 - "Name": "string", ~/~/ Наименование
5705 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5706 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5707 - "Norm": 0 ~/~/ Норма внесения
5708 - },
5709 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5710 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5711 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5712 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5713 - "deleted": true, ~/~/ Признак удаления
5714 - "extId": "string", ~/~/ ExtId
5715 - "GeoIds": [ ~/~/ Связанные поля
5716 - 0
5717 - ]
5718 -}
5719 -
5720 -
5721 -== **Редактирование задания в Журнале заданий** ==
5722 -
5723 -(% class="box successmessage" %)
5724 -(((
5725 -**PUT /api/v3/vehicletasks**
5726 -)))
5727 -
5728 -Пример запроса:
5729 -
5730 -(((
5731 -{
5732 - "vehicleId": 0, ~/~/ Идентификатор ТС
5733 - "description": "string", ~/~/ Описание
5734 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5735 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5736 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы
5737 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы
5738 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5739 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5740 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5741 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5742 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5743 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5744 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5745 - "cost": { 
5746 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5747 - "Name": "string", ~/~/ Наименование
5748 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5749 - "MeasureType": 0,  ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5750 - "Norm": 0 ~/~/ Норма внесения
5751 - },
5752 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5753 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5754 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания
5755 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления
5756 - "deleted": true, ~/~/ Признак удаления
5757 - "extId": "string", ~/~/ ExtId
5758 - "GeoIds": [ ~/~/ Связанные поля
5759 - 0
5760 - ]
5761 -}
5762 -)))
5763 -
5764 -
5765 -Пример ответа:
5766 -
5767 -{
5768 - "vehicleId": 0, ~/~/ Идентификатор ТС
5769 - "description": "string", ~/~/ Описание
5770 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5771 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5772 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5773 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5774 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5775 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5776 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5777 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5778 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5779 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5780 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5781 - "cost": { 
5782 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5783 - "Name": "string", ~/~/ Наименование
5784 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5785 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5786 - "Norm": 0 ~/~/ Норма внесения
5787 - },
5788 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5789 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5790 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5791 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5792 - "deleted": true, ~/~/ Признак удаления
5793 - "extId": "string", ~/~/ ExtId
5794 - "GeoIds": [ ~/~/ Связанные поля
5795 - 0
5796 - ]
5797 -}
5798 -
5799 -
5800 -== **Удаление задания в Журнале заданий** ==
5801 -
5802 -(% class="box warningmessage" %)
5803 -(((
5804 -**DELETE /api/v3/vehicletasks**
5805 -)))
5806 -
5807 -Пример запроса:
5808 -
5809 -(((
5810 -[
5811 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 
5812 -]
5813 -)))
5814 -
5815 -(((
5816 -
5817 -)))
5818 -
5819 -Пример ответа:
5820 -
5821 -{
5822 - "vehicleId": 0, ~/~/ Идентификатор ТС
5823 - "description": "string", ~/~/ Описание
5824 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5825 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5826 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5827 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5828 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5829 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5830 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5831 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5832 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5833 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5834 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5835 - "cost": { 
5836 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5837 - "Name": "string", ~/~/ Наименование
5838 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5839 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5840 - "Norm": 0 ~/~/ Норма внесения
5841 - },
5842 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5843 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5844 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5845 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5846 - "deleted": true, ~/~/ Признак удаления
5847 - "extId": "string", ~/~/ ExtId
5848 - "GeoIds": [ ~/~/ Связанные поля
5849 - 0
5850 - ]
5851 -}
5852 -
5853 -
5854 -== **Получение списка Журнала заданий** ==
5855 -
5856 -(% class="box infomessage" %)
5857 -(((
5858 -**POST /api/v3/vehicletasks/getbyperiod**
5859 -)))
5860 -
5861 -Пример запроса:
5862 -
5863 -(((
5864 -{
5865 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода.
5866 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода.
5867 - "TimeZone": 0, ~/~/ Часовой пояс.
5868 - "OperationsIds": [  ~/~/ Идентификаторы видов работ для фильтрации журнала
5869 - "3fa85f64-5717-4562-b3fc-2c963f66afa6"
5870 - ],
5871 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала
5872 - 0
5873 - ],
5874 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала
5875 - 0
5876 - ],
5877 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска.
5878 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 
5879 -}
5880 -)))
5881 -
5882 -
5883 -Пример ответа:
5884 -
5885 -(((
5886 -{
5887 - "total": 0,  ~/~/ Общее количество записей
5888 - "pages": 0,  ~/~/ Общее количество страниц
5889 - "currentPage": 0, ~/~/ Текущая страница
5890 - "items": [  ~/~/ Записи 
5891 - {
5892 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
5893 - "isGroup": true,  ~/~/ Вид задания (true - групповое, иначе - одиночное).
5894 - "name": "string", ~/~/ Название задания.
5895 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc
5896 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc
5897 - "workKind": "string", ~/~/ Вид работ
5898 - "techOp": "string", ~/~/ Тех. операция
5899 - "trailerModel": "string", ~/~/ Модель агрегата
5900 - "width": "string", ~/~/ Ширина, м
5901 - "speed": "string", ~/~/ Тех. скорость
5902 - "fields": "string", ~/~/ Поля
5903 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га)
5904 - "vehicles": "string", ~/~/ Объект-модель
5905 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов)
5906 - "drivers": "string", ~/~/ Водители
5907 - "tmc": "string", ~/~/ ТМЦ
5908 - "client": "string", ~/~/  Клиент
5909 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
5910 - "dep": "string", ~/~/ Подразделение
5911 - "geoIds": [ ~/~/  Связанные поля
5912 - 0
5913 - ]
5914 - }
5915 - ]
5916 -}
5917 -)))
5918 -
5919 -
5920 -= **Раздел: Локатор ** =
5921 -
5922 -
5923 -== **Получение списка локаторов, доступных пользователю ** ==
5924 -
5925 -(% class="box infomessage" %)
5926 -(((
5927 -**GET /api/v3/locators**
5928 -)))
5929 -
5930 -В заголовках запроса: X-Auth: Токен авторизации
5931 -
5932 -
5933 -Пример ответа:
5934 -
5935 -(((
5936 -[
5937 - {
5938 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор локатора.
5939 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
5940 - "agentName": "string", ~/~/ Наименование агента.
5941 - "isEnabled": true, ~/~/ Активен 
5942 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания
5943 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления
5944 - "name": "string", ~/~/ Наименование
5945 - "status": 0, ~/~/ 
5946 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 
5947 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 
5948 - "validity": 0, ~/~/ Срок действия в днях (1-90).
5949 - "autoProlongation": true, ~/~/ Автопродление срока действия.
5950 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
5951 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
5952 - "url": "string", ~/~/ Ссылка
5953 - "language": 0, ~/~/ Язык.
5954 - "vehiclesCount": 0, ~/~/ Количество объектов.
5955 - "geozonesCount": 0, ~/~/ Количество геозон.
5956 - "fieldsCount": 0 ~/~/ Количество полей.
5957 - }
5958 -]
5959 -)))
5960 -
5961 -
5962 -
5963 -== **Создание локатора** ==
5964 -
5965 -(% class="box successmessage" %)
5966 -(((
5967 -**POST /api/v3/locators**
5968 -)))
5969 -
5970 -Пример запроса:
5971 -
5972 -(((
5973 -{
5974 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
5975 - "isEnabled": true, ~/~/ Активность
5976 - "name": "string", ~/~/ Наименование локатора
5977 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени)
5978 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/  Время активации
5979 - "validity": 0, ~/~/ Срок действия в днях (1-90)
5980 - "autoProlongation": true, ~/~/ Автопродление срока действия.
5981 - "url": "string", ~/~/ Ссылка
5982 - "language": 0 ~/~/ Язык
5983 -}
5984 -)))
5985 -
5986 -
5987 -Пример ответа:
5988 -
5989 -(((
5990 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора
5991 -)))
5992 -
5993 -
5994 -
5995 -== **Изменение локатора** ==
5996 -
5997 -(% class="box infomessage" %)
5998 -(((
5999 -**PUT /api/v3/locators**
6000 -)))
6001 -
6002 -Пример запроса:
6003 -
6004 -(((
6005 -{
6006 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
6007 - "isEnabled": true, ~/~/ Активность 
6008 - "name": "string", ~/~/ Наименование
6009 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 
6010 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации
6011 - "validity": 0, ~/~/ Срок действия в днях (1-90)
6012 - "autoProlongation": true, ~/~/ Автопродление срока действия
6013 - "url": "string", ~/~/ Ссылка
6014 - "language": 0 ~/~/ Язык
6015 -}
6016 -)))
6017 -
6018 -
6019 -Пример ответа:
6020 -
6021 -200 ~/~/ Success
6022 -
6023 -
6024 -== **Удалить локатор** ==
6025 -
6026 -(% class="box warningmessage" %)
6027 -(((
6028 -**DELETE /api/v3/locators**
6029 -)))
6030 -
6031 -Пример запроса:
6032 -
6033 -(((
6034 -[
6035 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора
6036 -]
6037 -)))
6038 -
6039 -
6040 -
6041 -= **Раздел: Яндекс Маршруты** =
6042 -
6043 -
6044 -== **Возвращение списка маршрутов** ==
6045 -
6046 -(% class="box infomessage" %)
6047 -(((
6048 -**GET /api/v3/TransportRoutes**
6049 -)))
6050 -
6051 -Пример запроса:
6052 -Id  ~/~/ Идентификатор поля
6053 -
6054 -
6055 -Пример ответа:
6056 -
6057 -(((
6058 -[
6059 - {
6060 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 
6061 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6062 - "name": "string", ~/~/ Наименование маршрута.
6063 - "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6064 - "vehicles": [  ~/~/ Определяет список ТС для маршрута
6065 - 0
6066 - ]
6067 - }
6068 -]
6069 -)))
6070 -
6071 -
6072 -
6073 -== **Добавить маршрут** ==
6074 -
6075 -(% class="box infomessage" %)
6076 -(((
6077 -**POST /api/v3/TransportRoutes**
6078 -)))
6079 -
6080 -Пример запроса: 
6081 -{
6082 - "name": "string",  ~/~/  Опредлеляет наименование маршрута.
6083 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6084 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6085 - "vehicles": [  ~/~/ Определяет список ТС для маршрута
6086 - 0
6087 - ]
6088 -}
6089 -
6090 -
6091 -Пример ответа:
6092 -
6093 -(((
6094 -{
6095 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6096 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6097 - "name": "string", ~/~/ Определяет наименование маршрута 
6098 - "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 
6099 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6100 - 0
6101 - ]
6102 -}
6103 -)))
6104 -
6105 -
6106 -== **Обновление маршрута** ==
6107 -
6108 -(% class="box successmessage" %)
6109 -(((
6110 -**PUT /api/v3/TransportRoutes**
6111 -)))
6112 -
6113 -Пример запроса:
6114 -
6115 -(((
6116 -{
6117 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6118 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6119 - "name": "string", ~/~/ Опредлеляет наименование маршрута.
6120 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6121 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6122 - 0
6123 - ]
6124 -}
6125 -)))
6126 -
6127 -
6128 -Пример ответа:
6129 -
6130 -(((
6131 -{
6132 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6133 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6134 - "name": "string", ~/~/ Определяет наименование маршрута 
6135 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6136 - "vehicles": [ ~/~/ Определяет список ТС для маршрута
6137 - 0
6138 - ]
6139 -}
6140 -)))
6141 -
6142 -
6143 -== **Получить связки маршрутов ТС** ==
6144 -
6145 -(% class="box infomessage" %)
6146 -(((
6147 -**POST /api/v3/TransportRoutes/getroutesvehicles**
6148 -)))
6149 -
6150 -Пример запроса:
6151 -
6152 -(((
6153 -[
6154 - "3fa85f64-5717-4562-b3fc-2c963f66afa6"  ~/~/ идентификатор маршрута
6155 -]
6156 -)))
6157 -
6158 -
6159 -Пример ответа:
6160 -
6161 -(((
6162 -[
6163 - {
6164 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС
6165 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута
6166 - }
6167 -]
6168 -)))
6169 -
6170 -
6171 -== **Удалить маршрут** ==
6172 -
6173 -(% class="box warningmessage" %)
6174 -(((
6175 -**DELETE /api/v3/TransportRoutes/{id}**
6176 -)))
6177 -
6178 -Пример запроса:
6179 -Id  ~/~/ Идентификатор поля
6180 -
6181 -
6182 -==== ====
6183 -
6184 -= **Раздел: Управление доступа к машинам** =
6185 -
6186 -
6187 -== Получение списка транспортных средств видимых пользователю ==
6188 -
6189 -(% class="box infomessage" %)
6190 -(((
6191 -**GET /api/v3/UserVisibleVehicles/{userId}**
6192 -)))
6193 -
6194 -Пример ответа:
6195 -
6196 -(((
6197 -{
6198 - "vehicleIds": [  ~/~/ Идентификаторы ТС
6199 - 0
6200 - ]
6201 -}
6202 -)))
6203 -
6204 -
6205 -
6206 -== Задает видимость транспортных средств пользователю ==
6207 -
6208 -(% class="box infomessage" %)
6209 -(((
6210 -**POST /api/v3/UserVisibleVehicles**
6211 -)))
6212 -
6213 -Пример запроса:
6214 -
6215 -(((
6216 -(((
6217 -{
6218 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор пользователя
6219 - "vehicleIds": [ ~/~/ Идентификаторы ТС
6220 - 0
6221 - ]
6222 -}
6223 -)))
6224 -
6225 -(((
6226 -
6227 -)))
6228 -
6229 -(((
6230 -
6231 -)))
6232 -
6233 -(((
6234 -Пример ответа :
6235 -)))
6236 -
6237 -(((
6238 -
6239 -)))
6240 -
6241 -(((
6242 -200 ~/~/ Success
6243 -)))
6244 -)))
6245 -
6246 -
6247 -
6248 -
6249 -
6250 -
6251 6251  (% class="box" lang="en-US" style="text-align: center;" %)
6252 6252  (((
6253 6253  (% 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 г.