Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/04/21 14:13
<
>
edited by Андрей Калиновский
on 2025/03/17 16:44
on 2025/03/17 16:44
edited by Андрей Калиновский
on 2024/11/22 14:30
on 2024/11/22 14:30
Change comment:
Откат к версии 183.1
Summary
Details
- Page properties
-
- Content
-
... ... @@ -1,23 +1,9 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -(% class="box warningmessage" %) 4 -((( 5 -(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 -просим вас соблюдать несколько простых правил при использовании API-команд:## 3 +**Содержание страницы:**\ 7 7 ))) 8 8 9 -* Формировать не более 3 отчётов одновременно. 10 -* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 11 12 -В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 - 14 - 15 -**Содержание страницы:** 16 -))) 17 - 18 -{{toc/}} 19 - 20 - 21 21 = (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) = 22 22 23 23 (% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов). ... ... @@ -1021,17 +1021,6 @@ 1021 1021 1022 1022 ((( 1023 1023 { 1024 - 1025 -((( 1026 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1027 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1028 -))) 1029 - 1030 -((( 1031 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1032 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1033 -))) 1034 - 1035 1035 "vehicleId": "", ~/~/ ID объекта 1036 1036 "name": "", ~/~/ Имя объекта 1037 1037 "imei": "", ~/~/ IMEI объекта ... ... @@ -1126,7 +1126,6 @@ 1126 1126 ], 1127 1127 "showInTooltip": true, ~/~/ Отображать в подсказке 1128 1128 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1129 - "color": "string", ~/~/ Код цвета датчиков 1130 1130 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1131 1131 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1132 1132 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1184,21 +1184,11 @@ 1184 1184 "date": "2023-05-22T09:57:39.562Z", 1185 1185 "description": "string", 1186 1186 "additionalInfo": "string" 1187 - 1188 - (((1161 + } 1162 + ] 1189 1189 } 1190 - ], 1191 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1192 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1193 1193 ))) 1194 1194 1195 -((( 1196 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1197 -} 1198 - 1199 -))) 1200 -))) 1201 - 1202 1202 (% style="text-align:left" %) 1203 1203 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1204 1204 ... ... @@ -1206,6 +1206,41 @@ 1206 1206 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1207 1207 1208 1208 1173 +== **Импортировать историю ТС (Асинхронный запрос)** == 1174 + 1175 +(% class="box successmessage" %) 1176 +((( 1177 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1178 +))) 1179 + 1180 +(% style="color:#000000" %)Метод запроса: **POST** 1181 + 1182 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} 1183 + 1184 +(% style="color:#000000" %)Параметр запроса: {__**vehicleid}**__ - идентификатор транспортного средства 1185 + 1186 + 1187 +Ответ: 1188 + 1189 +{ 1190 + 1191 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1192 + 1193 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1194 + 1195 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1196 + 1197 + "Message": "string", ~/~/ Информация о выполнении запроса 1198 + 1199 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1200 + 1201 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1202 + 1203 + "Data": "string" ~/~/ Данные 1204 + 1205 +} 1206 + 1207 + 1209 1209 == **Отправить команду на терминал** == 1210 1210 1211 1211 (% class="box successmessage" %) ... ... @@ -1216,15 +1216,13 @@ 1216 1216 Команда для отправки на тс. 1217 1217 1218 1218 { 1219 -"id": "", ~/~/идентификатор о бъекта (онже идентификаторТС: vehicleId)1220 -"command": "", ~/~/ Текст отправляемойкоманды1221 -"retries": "", ~/~/ Количество попыток отправки на терминал1222 -"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов).1218 +"id": "", ~/~/идентификатор произвольного поля 1219 +"command": "", ~/~/ Текст команды 1220 +"retries": "", ~/~/ Количество попыток 1221 +"idTemplate": "" ~/~/ ID шаблона команды 1223 1223 } 1224 1224 1225 -В ответ получаем cmdid 1226 1226 1227 - 1228 1228 == **Получить ответ на отправленную на ТС команду** == 1229 1229 1230 1230 (% class="box infomessage" %) ... ... @@ -1232,13 +1232,13 @@ 1232 1232 (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer** 1233 1233 ))) 1234 1234 1235 -Идентификатор команды: cmd Id1232 +Идентификатор команды: cmdid 1236 1236 1237 1237 Запрос от терминала на ответ команды 1238 1238 1239 1239 Пример ответ от терминала: 1240 1240 1241 -ID= "" ~/~/ идентификатор о бъекта1238 +ID= "" ~/~/ идентификатор произвольного поля 1242 1242 Soft="" ~/~/ версия софта 1243 1243 GPS=4 ~/~/ тип трекера 1244 1244 Time=11:05:43 28.06.24 ~/~/ время запроса ... ... @@ -1291,13 +1291,7 @@ 1291 1291 1292 1292 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1293 1293 1294 -(% style="color:#000000" %){ 1295 - 1296 - 1297 -((( 1298 - "vehicleId": 0, ~/~/ ID ТС 1299 -))) 1300 - 1291 +(% style="color:#000000" %){(%%) 1301 1301 "parentId": "" , ~/~/ ID клиента 1302 1302 "name": "" , ~/~/ имя ТС 1303 1303 "imei": "" , ~/~/ IMEI ... ... @@ -1390,7 +1390,6 @@ 1390 1390 ], 1391 1391 "showInTooltip": true, ~/~/ Отображать в подсказке 1392 1392 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1393 - "color": "string", ~/~/ код цвета датчиков 1394 1394 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1395 1395 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1396 1396 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1440,19 +1440,10 @@ 1440 1440 "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1441 1441 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1442 1442 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1443 - 1444 -((( 1445 - } 1446 - ], 1447 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1448 -))) 1449 - 1450 -((( 1451 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1433 + } 1434 + ] 1452 1452 } 1453 -))) 1454 1454 1455 - 1456 1456 (% style="color:#000000" %)Ответ: 1457 1457 1458 1458 ... ... @@ -1561,7 +1561,6 @@ 1561 1561 ], 1562 1562 "showInTooltip": true, ~/~/ Отображение в подсказке 1563 1563 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1564 - "color": "string", ~/~/ код цвета датчиков 1565 1565 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1566 1566 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1567 1567 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -1598,7 +1598,7 @@ 1598 1598 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1599 1599 } 1600 1600 ], 1601 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 -По датчику Моточасов, 2 -По датчику относительных Моточасов1581 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1602 1602 } 1603 1603 ))) 1604 1604 ))) ... ... @@ -1610,78 +1610,6 @@ 1610 1610 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1611 1611 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1612 1612 1613 - 1614 -== **Импортировать историю ТС (Асинхронный запрос)** == 1615 - 1616 -(% class="box successmessage" %) 1617 -((( 1618 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1619 -))) 1620 - 1621 -Метод запроса: **POST** 1622 - 1623 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1624 - 1625 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1626 - 1627 - 1628 -Ответ: 1629 - 1630 -{ 1631 - 1632 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1633 - 1634 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1635 - 1636 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1637 - 1638 - "Message": "string", ~/~/ Информация о выполнении запроса 1639 - 1640 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1641 - 1642 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1643 - 1644 - "Data": "string" ~/~/ Данные 1645 - 1646 -} 1647 - 1648 - 1649 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 1650 - 1651 -(% class="box infomessage" %) 1652 -((( 1653 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1654 -))) 1655 - 1656 -Метод запроса: **GET** 1657 - 1658 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1659 - 1660 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1661 - 1662 - 1663 -Ответ: 1664 - 1665 -{ 1666 - 1667 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1668 - 1669 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 1670 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1671 - 1672 - "Message": "string", ~/~/ Информация о выполнении запроса 1673 - 1674 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1675 - 1676 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1677 - 1678 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1679 - 1680 - "Data": "string" ~/~/ Данные 1681 - 1682 -} 1683 - 1684 - 1685 1685 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1686 1686 1687 1687 (% class="box infomessage" %) ... ... @@ -1904,19 +1904,9 @@ 1904 1904 1905 1905 "drivers": [ ~/~/ Водители 1906 1906 { 1907 - 1908 -((( 1909 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1910 - "inputNumber": 0, ~/~/ № входа. 1911 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1912 - "comment": "string", ~/~/ Комментарий. 1913 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1914 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1915 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1916 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1917 -))) 1918 - 1919 - } 1815 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1816 + "isDefault": true 1817 + } 1920 1920 ], 1921 1921 "commandTemplates": [ ~/~/ Шаблон команды 1922 1922 { ... ... @@ -1952,11 +1952,6 @@ 1952 1952 ], 1953 1953 "showInTooltip": true, ~/~/ Отображать в подсказке 1954 1954 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1955 - 1956 -((( 1957 - "color": "string",** ~/~/ **Цвет датчика 1958 -))) 1959 - 1960 1960 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1961 1961 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1962 1962 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -2003,12 +2003,7 @@ 2003 2003 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2004 2004 "forReport": true ~/~/ Отобразить произвольное поле в отчете 2005 2005 } 2006 - 2007 -((( 2008 - ], 2009 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 2010 -))) 2011 - 1899 + ] 2012 2012 } 2013 2013 2014 2014 ... ... @@ -2146,11 +2146,6 @@ 2146 2146 ], 2147 2147 "showInTooltip": true, ~/~/ Отображение в подсказке 2148 2148 "showLastValid": true, ~/~/ Отображать последнее валидное значение 2149 - 2150 -((( 2151 - "color": "string", ~/~/ цвет уведомлений 2152 -))) 2153 - 2154 2154 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2155 2155 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2156 2156 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -2467,8 +2467,6 @@ 2467 2467 "motohours": 0, ~/~/ Моточасы за период, секунды 2468 2468 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2469 2469 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2470 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2471 - 2472 2472 } 2473 2473 ] 2474 2474 } ... ... @@ -4449,7 +4449,7 @@ 4449 4449 4450 4450 (% class="box infomessage" %) 4451 4451 ((( 4452 - **POST /api/v3/fuelcards/transactions**4333 +POST /api/v3/fuelcards/transactions 4453 4453 ))) 4454 4454 4455 4455 Метод запроса: POST ... ... @@ -4460,59 +4460,34 @@ 4460 4460 Параметры в теле запроса (JSON): 4461 4461 4462 4462 { 4463 - "startDate": "2024-04-11T10:32:02.395Z", ~/~/ 4464 - "endDate": "2024-04-11T10:32:02.395Z", ~/~/ 4344 + "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода 4345 + "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода 4465 4465 "ids": [ 4466 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы4347 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт 4467 4467 ], 4468 - "timezone": 0 ~/~/ Часовойпояс4349 + "timezone": 0 ~/~/Таймзона 4469 4469 } 4470 4470 4471 4471 4472 4472 Ответ: 4473 4473 { 4474 - "date": "2024-04-11T10:41:02.265Z", ~/~/ 4475 - "driver": "string", ~/~/ 4476 - "object": "string", ~/~/ 4477 - "amount": 0, ~/~/ 4478 - "amountDut": 0, ~/~/ 4479 - "amountDiff": 0, ~/~/ 4480 - "amountDiffPerc": 0, ~/~/ 4481 - "summa": 0, ~/~/ 4482 - "serviceName": "string", ~/~/ 4483 - "price": 0, ~/~/ 4484 - "cardName": "string", ~/~/ 4485 - "cardNum": "string", ~/~/ 4486 - "operator": "string", ~/~/ 4487 - "address": "string" ~/~/ 4355 + "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции 4356 + "driver": "string", ~/~/Водители, привязанные к ТК 4357 + "object": "string", ~/~/Наименование ТС 4358 + "amount": 0, ~/~/Количество топлива 4359 + "amountDut": 0, ~/~/Количество по ДУТ 4360 + "amountDiff": 0, ~/~/Разница, л 4361 + "amountDiffPerc": 0, ~/~/Разница, % 4362 + "summa": 0, ~/~/Стоимость, руб 4363 + "serviceName": "string", ~/~/Тип топлива 4364 + "price": 0, ~/~/Цена за литр, руб 4365 + "cardName": "string", ~/~/Наименование ТК 4366 + "cardNum": "string", ~/~/Номер ТК 4367 + "operator": "string", ~/~/Оператор ТК 4368 + "address": "string" ~/~/Адрес АЗС 4488 4488 } 4489 4489 4490 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4491 4491 4492 -(% class="box infomessage" %) 4493 -((( 4494 -**GET /api/v3/fuelcards** 4495 -))) 4496 - 4497 -Метод запроса: GET 4498 - 4499 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4500 - 4501 -Ответ: 4502 - 4503 -[ 4504 - { 4505 - "Name": "string", ~/~/ Определяет наименование карты. 4506 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4507 - "Number": "string", ~/~/ Определяет № карты. 4508 - "Enabled": true, ~/~/ Определяет признак активности карты. 4509 - "Description": "string", ~/~/ Определяет описание карты. 4510 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4511 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4512 - "deleted": true ~/~/ Признак удаления 4513 - } 4514 -] 4515 - 4516 4516 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4517 4517 4518 4518 ... ... @@ -4523,28 +4523,28 @@ 4523 4523 **GET ** **/api/v3/retranslations/{id}** 4524 4524 ))) 4525 4525 4526 - id -Идентификаторретранслятора4382 +Идентификатор запроса: ID 4527 4527 4528 4528 4529 4529 Пример ответа: 4530 4530 4531 4531 { 4532 -"description": "", ~/~/ Поле описания ретранслятора4533 -"subscriberId": "", ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)4534 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4535 -"isEnabled": true, ~/~/ Признак включенияретранслятора, Включен, true - включен, false - отключен4536 -"address": "string", ~/~/ Адрес и портпринимающего сервера4537 -"objects": [ ~/~/ 4388 +"description": "", ~/~/ Определяет описание 4389 +"subscriberId": "", ~/~/ Подписчик 4390 +"protocolType": 0, ~/~/ Тип протокола 4391 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4392 +"address": "string", ~/~/ Адрес события 4393 +"objects": [ ~/~/Объекты для ретрансляции 4538 4538 { 4539 4539 "id": "", ~/~/ Идентификатор объекта ретрансляции 4540 4540 "name": "", ~/~/ Наименование объекта ретрансляции 4541 -"imei": "", ~/~/ IMEI объекта ретрансляции4542 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4397 +"imei": "", ~/~/ IMEI объекта 4398 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4543 4543 } 4544 4544 ], 4545 -"id": "", ~/~/ Идентификаторретранслятора4546 -"parentId": "", ~/~/ Идентификаторродителя(вышестоящего клиента)4547 -"deleted": "" ~/~/ Признак удаления ретранслятора:true - включен, false - отключен4401 +"id": "", ~/~/ идентификатор пользователя 4402 +"parentId": "", ~/~/Guid родителя 4403 +"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен 4548 4548 } 4549 4549 4550 4550 ... ... @@ -4555,7 +4555,7 @@ 4555 4555 **DELETE** **/api/v3/retranslations/{id}** 4556 4556 ))) 4557 4557 4558 - id - Идентификаторретранслятора4414 +Параметр запроса: ID 4559 4559 4560 4560 4561 4561 == **Создание ретранслятора** == ... ... @@ -4568,16 +4568,16 @@ 4568 4568 Запрос: 4569 4569 4570 4570 { 4571 -"description": "", ~/~/ Поле описания ретранслятора4572 -"subscriberId": "", ~/~/ Идентификатор подписчика4573 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4574 -"address": "", ~/~/ Адрес и портпринимающегосервера4575 -"isEnabled": "", ~/~/ Признакретранслятора, true - включен, false - отключен4427 +"description": "", ~/~/ Описание 4428 +"subscriberId": "", ~/~/ Подписчик 4429 +"protocolType": 0, ~/~/ Тип протокола 4430 +"address": "", ~/~/ Адрес ретрансляции 4431 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4576 4576 "objects": [ ~/~/Объекты для ретрансляции 4577 4577 { 4578 -"id": "", ~/~/ Идентификаторретранслятора4579 -"imei": "", ~/~/ ретрансляции4580 -"isEnabled": "" ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4434 +"id": "", ~/~/ идентификатор пользователя 4435 +"imei": "", ~/~/IMEI объекта 4436 +"isEnabled": "" ~/~/ признак включения, Включен, true - включен, false - отключен 4581 4581 } 4582 4582 ] 4583 4583 } ... ... @@ -4586,22 +4586,22 @@ 4586 4586 Ответ: 4587 4587 4588 4588 { 4589 -"description": "", ~/~/ Поле описания ретранслятора4590 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4591 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4592 -"isEnabled": true, ~/~/Признакретранслятора:true - включен, false - отключен4593 -"address": " string", ~/~/ Адреси портпринимающего сервера4594 -"objects": [ 4445 +"description": "string", ~/~/ Определяет описание 4446 +"subscriberId": "", ~/~/ идентификатор запроса 4447 +"protocolType": 0, ~/~/ Тип протокола 4448 +"isEnabled": "", ~/~/ признак включения, Включен, true - включен, false - отключен 4449 +"address": "", ~/~/ Адрес события 4450 +"objects": [ ~/~/Объекты для ретрансляции 4595 4595 { 4596 -"id": "", ~/~/ Идентификатор объектаретрансляции4597 -"name": "string", ~/~/ На именование объекта ретрансляции4598 -"imei": "", ретрансляции4599 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4452 +"id": "", ~/~/ идентификатор пользователя 4453 +"name": "string", ~/~/ Название уведомления 4454 +"imei": "string", ~/~/IMEI объекта 4455 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4600 4600 } 4601 - ], 4602 -"id": "", ~/~/ Идентификаторретранслятора4603 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4604 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4457 + ], 4458 +"id": "", ~/~/ идентификатор пользователя 4459 +"parentId": "", ~/~/ Guid идентификатор родителя 4460 +"deleted": true ~/~/ Признак удаления 4605 4605 } 4606 4606 4607 4607 ... ... @@ -4615,18 +4615,18 @@ 4615 4615 Пример запроса: 4616 4616 4617 4617 { 4618 -"id": "", ~/~/ Идентификаторретранслятора4619 -"description": "string", ~/~/ Поле описания ретранслятора4620 -"subscriberId": "", ~/~/ Идентификатор подписчика4621 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4622 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4623 -"address": "string", ~/~/ Адрес и портпринимающего сервера4624 -"objects": ~/~/ 4474 +"id": "", ~/~/ идентификатор пользователя 4475 +"description": "string", ~/~/ Определяет описание 4476 +"subscriberId": "", ~/~/ идентификатор запроса 4477 +"protocolType": 0, ~/~/ Тип протокола 4478 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4479 +"address": "string", ~/~/ Адрес события 4480 +"objects": ~/~/Объекты для ретрансляции 4625 4625 [ 4626 4626 { 4627 -"id": "", ~/~/ Идентификатор объектаретрансляции4628 -"imei": "", ~/~/ ретрансляции4629 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4483 +"id": "", ~/~/ идентификатор пользователя 4484 +"imei": "", ~/~/IMEI объекта 4485 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4630 4630 } 4631 4631 ] 4632 4632 } ... ... @@ -4635,22 +4635,22 @@ 4635 4635 Пример ответа: 4636 4636 4637 4637 { 4638 -"description": "", ~/~/ Поле описания ретранслятора4639 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4640 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4641 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4642 -"address": "string", ~/~/ Адрес и портпринимающего сервера4643 -"objects": [ ~/~/ 4494 +"description": "", ~/~/ Определяет описание 4495 +"subscriberId": "", ~/~/ идентификатор запроса 4496 +"protocolType": 0, ~/~/ Тип протокола 4497 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4498 +"address": "string", ~/~/ Адрес события 4499 +"objects": [ ~/~/Объекты для ретрансляции 4644 4644 { 4645 -"id": "", ~/~/ Идентификатор объектаретрансляции4646 -"name": "string", ~/~/ На именование объекта ретрансляции4647 -"imei": "", ~/~/ ретрансляции4648 -"isEnabled": true ~/~/ Признакобъекта ретрансляции:true - включен, false - отключен4501 +"id": "", ~/~/ идентификатор пользователя 4502 +"name": "string", ~/~/ Название уведомления 4503 +"imei": "", ~/~/IMEI объекта 4504 +"isEnabled": true ~/~/ признак включения, Включен, true - включен, false - отключен 4649 4649 } 4650 4650 ], 4651 -"id": "", ~/~/ Идентификаторретранслятора4652 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4653 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4507 +"id": "", ~/~/ идентификатор пользователя 4508 +"parentId": "", ~/~/ Guid идентификатор родителя 4509 +"deleted": true ~/~/ Признак удаления 4654 4654 } 4655 4655 4656 4656 ... ... @@ -4664,9 +4664,9 @@ 4664 4664 Пример запроса: 4665 4665 4666 4666 { 4667 -"id": "", ~/~/ Идентификаторретранслятора4668 -"search": "string", ~/~/ 4669 -"parentId": "" ~/~/ Идентификатор родительскогоагента, для которого надо получить данные(обязательный параметр).4523 +"id": "", ~/~/ идентификатор пользователя 4524 +"search": "string", ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу 4525 +"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные. 4670 4670 } 4671 4671 4672 4672 Ответ: ... ... @@ -4673,14 +4673,14 @@ 4673 4673 4674 4674 [ 4675 4675 { 4676 -"description": "", ~/~/ Поле описания ретранслятора4677 -"subscriberId": "", ~/~/ Идентификаторподписчика(клиента, чьи объекты будутретранслироваться)4678 -"protocolType": 0, ~/~/ Тип протокола ретрансляции4679 -"isEnabled": true, ~/~/ Признакретранслятора:true - включен, false - отключен4680 -"address": "string", ~/~/ Адрес и портпринимающего сервера4681 -"id": "", ~/~/ Идентификаторретранслятора4682 -"parentId": "", ~/~/ Идентификатор родителя(вышестоящего клиента)4683 -"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален4532 +"description": "", ~/~/ Определяет описание 4533 +"subscriberId": "", ~/~/ идентификатор запроса 4534 +"protocolType": 0, ~/~/ Тип протокола 4535 +"isEnabled": true, ~/~/ признак включения, Включен, true - включен, false - отключен 4536 +"address": "string", ~/~/ Адрес события 4537 +"id": "", ~/~/ идентификатор пользователя 4538 +"parentId": "", ~/~/ Guid идентификатор родителя 4539 +"deleted": true ~/~/ Признак удаления 4684 4684 } 4685 4685 ] 4686 4686 ... ... @@ -4691,7 +4691,7 @@ 4691 4691 4692 4692 (% class="box infomessage" %) 4693 4693 ((( 4694 - **POST /api/v3/Reports/harvesterUnloading**4550 +POST **/api/v3/Reports/harvesterUnloading** 4695 4695 ))) 4696 4696 4697 4697 Пример запроса: ... ... @@ -4763,631 +4763,7 @@ 4763 4763 ] 4764 4764 4765 4765 4766 -== **Отчет трек-датчики** == 4767 - 4768 -(% class="box infomessage" %) 4769 -((( 4770 -**POST /api/v3/Reports/sensorsWorks** 4771 -))) 4772 - 4773 -**Пример запроса:** 4774 - 4775 -{ 4776 - "vehicleIds": [ ~/~/ Список ID объектов 4777 - 0 4778 - ], 4779 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4780 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4781 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4782 -} 4783 - 4784 -**Пример ответа:** 4785 - 4786 -((( 4787 -{ 4788 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4789 - { 4790 - "vehicleId": 0, ~/~/ Идентификатор ТС 4791 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4792 - { 4793 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4794 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4795 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4796 - "name": "string", ~/~/ Наименование оборудования. 4797 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4798 - "totalMileage": 0, ~/~/ Общий пробег. 4799 - "avgSpeed": 0 ~/~/ Средняя скорость. 4800 - } 4801 - ] 4802 - } 4803 - ] 4804 -} 4805 -))) 4806 - 4807 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4808 - 4809 - 4810 -== **Запрос списка полей** == 4811 - 4812 -(% class="box successmessage" %) 4813 -((( 4814 -**POST /api/v3/agroLands/find** 4815 -))) 4816 - 4817 -Пример запроса: 4818 - 4819 -((( 4820 -((( 4821 -((( 4822 -{ 4823 - "year": 0, ~/~/ Фильтр по году 4824 - "name": "string", ~/~/ Фильтр по названию 4825 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 4826 -} 4827 -))) 4828 -))) 4829 - 4830 - 4831 -))) 4832 - 4833 -Пример ответа: 4834 - 4835 -((( 4836 -[ 4837 - { 4838 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4839 - "year": 0, ~/~/ Год поля 4840 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 4841 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 4842 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 4843 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4844 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4845 - "counts": { ~/~/ Счётчики с/х поля 4846 - "fieldOperations": 0, ~/~/ Количество операций на поле 4847 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4848 - "facts": 0 ~/~/ Счётчик факта 4849 - }, 4850 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4851 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4852 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4853 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4854 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4855 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4856 - "planComment": "string", ~/~/ Комментарий к полю 4857 - "productivity": 0, ~/~/ Урожайность. 4858 - "id": 0, ~/~/ Идентификатор объекта геозоны 4859 - "name": "string", ~/~/ Название объекта геозоны 4860 - "type": 0, ~/~/ Тип объекта геозоны 4861 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4862 - "fname": "string", ~/~/ Имя файла 4863 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4864 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 4865 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 4866 - "description": "string", ~/~/ Описание объекта геозоны 4867 - "area": 0, ~/~/ Площадь, м2 4868 - "perimetr": 0, ~/~/ Периметр, м 4869 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 4870 - } 4871 -] 4872 - 4873 - 4874 -== **Создание нового поля ** == 4875 - 4876 -(% class="box successmessage" %) 4877 -((( 4878 -**POST /api/v3/agroLands** 4879 -))) 4880 - 4881 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 4882 -X-agent - ID клиента 4883 - 4884 -Пример запроса: 4885 - 4886 -((( 4887 -{ 4888 - "extId": "string", 4889 - "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля 4890 - "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля 4891 - "display": "string", ~/~/ Настройки отображения 4892 - "year": 0, ~/~/ Год поля 4893 - "name": "string", ~/~/ Наименование 4894 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4895 - "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая 4896 - "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая 4897 - "planComment": "string", ~/~/ Комментарий к полю 4898 - "cropRotations": [ ~/~/ Данные по севообороту 4899 - { 4900 - "landId": 0, ~/~/ ID поля 4901 - "landName": "string", ~/~/ Название поля 4902 - "year": 0, ~/~/ Год урожая 4903 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4904 - "cultureName": "string", ~/~/ Название культуры 4905 - "productivity": 0, ~/~/ Урожайность 4906 - "area": 0, ~/~/ Площадь поля, Га 4907 - "total": 0, ~/~/ Валовый сбор 4908 - "productivityFact": 0, ~/~/ Фактическая урожайность 4909 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4910 - "totalFact": 0, ~/~/ Фактический валовый сбор 4911 - "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ 4912 - "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева 4913 - "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая 4914 - "isyearplan": true, ~/~/ Годовой план 4915 - "comment": "string" ~/~/ Комментарий 4916 - } 4917 - ] 4918 -} 4919 -))) 4920 - 4921 -((( 4922 - 4923 -))) 4924 - 4925 -Пример ответа: 4926 - 4927 -((( 4928 -((( 4929 -{ 4930 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4931 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4932 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4933 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4934 - "cropRotations": [ ~/~/ Данные по севообороту 4935 - { 4936 - "landId": 0, ~/~/ ID поля 4937 - "landName": "string", ~/~/ Название поля 4938 - "year": 0, ~/~/ Год урожая 4939 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4940 - "cultureName": "string", ~/~/ Название культуры 4941 - "productivity": 0, ~/~/ Урожайность 4942 - "area": 0, ~/~/ Площадь поля, Га. 4943 - "total": 0, ~/~/ Валовый сбор 4944 - "productivityFact": 0, ~/~/ Фактическая урожайность 4945 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4946 - "totalFact": 0, ~/~/ Фактический валовый сбор 4947 - "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ 4948 - "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева 4949 - "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая 4950 - "isyearplan": true, ~/~/ годовой план 4951 - "comment": "string" ~/~/ Комментарий 4952 - } 4953 - ], 4954 - "cropVegetation": [ ~/~/ История вегетации поля 4955 - { 4956 - "values": [ ~/~/ Данные вегетации и состояния посева 4957 - { 4958 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 4959 - "ndvi": 0 ~/~/ Индекс вегетации 4960 - } 4961 - ], 4962 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 4963 - { 4964 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 4965 - "type": "string", ~/~/ Тип 4966 - "pictureid": "string" ~/~/ Идентификатор ресурса 4967 - } 4968 - ], 4969 - "states": [ ~/~/ Ключевые даты развития поля 4970 - { 4971 - "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата 4972 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 4973 - } 4974 - ] 4975 - } 4976 - ], 4977 - "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая 4978 - "counts": { 4979 - "fieldOperations": 0, ~/~/ Количество операций на поле 4980 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4981 - "facts": 0 ~/~/ Счётчик факта 4982 - }, 4983 - "planComment": "string", ~/~/ Комментарий к полю 4984 -))) 4985 - 4986 -((( 4987 - "productivity": 0, ~/~/ Урожайность. 4988 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4989 - "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая 4990 - "year": 0, ~/~/ Год поля 4991 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 4992 - "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 4993 - "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 4994 - "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 4995 - "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто 4996 - "id": 0, ~/~/ Идентификатор объекта геозоны 4997 - "name": "string", ~/~/ Название объекта геозоны 4998 - "type": 0, ~/~/ Тип объекта геозоны 4999 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5000 - "fname": "string", ~/~/ Имя файла 5001 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5002 - "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны 5003 - "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны 5004 - "description": "string", ~/~/ Описание объекта геозоны 5005 - "area": 0, ~/~/ Площадь, м2 5006 - "perimetr": 0, ~/~/ Периметр, м 5007 - "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5008 -} 5009 - 5010 - 5011 -))) 5012 -))) 5013 -))) 5014 - 5015 -== **Получение поля по id** == 5016 - 5017 -(% class="box infomessage" %) 5018 -((( 5019 -**GET /api/v3/agroLands/{id}** 5020 -))) 5021 - 5022 -Пример запроса: 5023 -id ~/~/ Идентификатор поля 5024 - 5025 -Пример ответа: 5026 - 5027 -((( 5028 -{ 5029 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5030 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5031 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5032 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5033 - "cropRotations": [ ~/~/ Данные по севообороту 5034 - { 5035 - "landId": 0, ~/~/ ID поля 5036 - "landName": "string", ~/~/ Название поля 5037 - "year": 0, ~/~/ Год урожая 5038 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5039 - "cultureName": "string", ~/~/ Название культуры 5040 - "productivity": 0, ~/~/ Урожайность 5041 - "area": 0, ~/~/ Площадь поля, Га 5042 - "total": 0, ~/~/ Валовый сбор 5043 - "productivityFact": 0, ~/~/ Фактическая урожайность 5044 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5045 - "totalFact": 0, ~/~/ Фактический валовый сбор 5046 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5047 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5048 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5049 - "isyearplan": true, ~/~/ План года 5050 - "comment": "string" ~/~/ Комментарий 5051 - } 5052 - ], 5053 - "cropVegetation": [ ~/~/ История вегетации поля 5054 - { 5055 - "values": [ ~/~/ Данные вегетации и состояния посева 5056 - { 5057 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5058 - "ndvi": 0 ~/~/ Индекс вегетации 5059 - } 5060 - ], 5061 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5062 - { 5063 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5064 - "type": "string", ~/~/ Тип 5065 - "pictureid": "string" ~/~/ Идентификатор ресурса 5066 - } 5067 - ], 5068 - "states": [ ~/~/ Ключевые даты развития поля 5069 - { 5070 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5071 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5072 - } 5073 - ] 5074 - } 5075 - ], 5076 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5077 - "counts": { 5078 - "fieldOperations": 0, ~/~/ Количество операций на поле 5079 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5080 - "facts": 0 ~/~/ Счётчик факта 5081 - }, 5082 - "planComment": "string", ~/~/ Комментарий к полю 5083 - "productivity": 0, ~/~/ Урожайность. 5084 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5085 -))) 5086 - 5087 -((( 5088 -((( 5089 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5090 - "year": 0, ~/~/ Год поля 5091 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5092 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5093 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5094 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5095 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5096 - "id": 0, ~/~/ Идентификатор объекта геозоны 5097 - "name": "string", ~/~/ Название объекта геозоны 5098 - "type": 0, ~/~/ Тип объекта геозоны 5099 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5100 - "fname": "string", ~/~/ Имя файла 5101 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5102 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5103 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5104 - "description": "string", ~/~/ Описание объекта геозоны 5105 - "area": 0, ~/~/ Площадь, м2 5106 - "perimetr": 0, ~/~/ Периметр, м 5107 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5108 -} 5109 -))) 5110 - 5111 - 5112 -== **Удаление существующего поля** == 5113 - 5114 -(% class="box errormessage" %) 5115 -((( 5116 -**DELETE /api/v3/agroLands/{id}** 5117 -))) 5118 - 5119 -Пример запроса: 5120 -id ~/~/ Идентификатор поля 5121 - 5122 -Пример ответа: 5123 - 5124 -((( 5125 -200 ~/~/ Успех 5126 -))) 5127 - 5128 -((( 5129 - 5130 -))) 5131 - 5132 -((( 5133 -((( 5134 -((( 5135 - 5136 -))) 5137 - 5138 -((( 5139 -== **Изменение поля** == 5140 - 5141 -(% class="box infomessage" %) 5142 -((( 5143 -**PUT /api/v3/agroLands** 5144 -))) 5145 - 5146 -Пример запроса: 5147 - 5148 -((( 5149 -((( 5150 -{ 5151 - "id": 0, ~/~/ Идентификатор поля 5152 - "extId": "string", ~/~/ ExtId 5153 - "shape": "string", ~/~/ Форма поля 5154 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5155 - "display": "string", ~/~/ Настройки отображения 5156 - "year": 0, ~/~/ Год поля 5157 - "name": "string", ~/~/ Наименование 5158 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5159 - "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая 5160 - "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая 5161 - "planComment": "string", ~/~/Комментарий к полю 5162 - "cropRotations": [ ~/~/ Данные по севообороту 5163 - { 5164 - "landId": 0, ~/~/ ID поля 5165 - "landName": "string", ~/~/ Название поля 5166 - "year": 0, ~/~/ Год урожая 5167 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5168 - "cultureName": "string", ~/~/ Название культуры 5169 - "productivity": 0, ~/~/ Урожайность 5170 - "area": 0, ~/~/ Площадь поля, Га. 5171 - "total": 0, ~/~/ Валовый сбор 5172 - "productivityFact": 0, ~/~/ Фактическая урожайность 5173 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5174 - "totalFact": 0, ~/~/ Фактический валовый сбор 5175 - "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ 5176 - "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева 5177 - "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая 5178 - "isyearplan": true, 5179 - "comment": "string" ~/~/ Комментарий 5180 - } 5181 - ], 5182 - "deleteStatistic": true ~/~/ Нужно ли удалять статистику 5183 -} 5184 -))) 5185 -))) 5186 - 5187 -((( 5188 - 5189 -))) 5190 - 5191 -Пример ответа: 5192 - 5193 -((( 5194 -((( 5195 -((( 5196 -{ 5197 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5198 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5199 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5200 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5201 - "cropRotations": [ ~/~/ Данные по севообороту 5202 - { 5203 - "landId": 0, ~/~/ ID поля 5204 - "landName": "string", ~/~/ Название поля 5205 - "year": 0, ~/~/ Год урожая 5206 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5207 - "cultureName": "string", ~/~/ Название культуры 5208 - "productivity": 0, ~/~/ Урожайность 5209 - "area": 0, ~/~/ Площадь поля, Га 5210 - "total": 0, ~/~/ Валовый сбор 5211 - "productivityFact": 0, ~/~/ Фактическая урожайность 5212 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5213 - "totalFact": 0, ~/~/ Фактический валовый сбор 5214 - "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ 5215 - "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева 5216 - "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая 5217 - "isyearplan": true, ~/~/ 5218 - "comment": "string" ~/~/ Комментарий 5219 - } 5220 - ], 5221 - "cropVegetation": [ ~/~/ История вегетации поля 5222 - { 5223 - "values": [ ~/~/ Данные вегетации и состояния посева 5224 - { 5225 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5226 - "ndvi": 0 ~/~/ Индекс вегетации 5227 - } 5228 - ], 5229 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5230 - { 5231 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5232 - "type": "string", ~/~/ Тип 5233 - "pictureid": "string" ~/~/ Идентификатор ресурса 5234 - } 5235 - ], 5236 - "states": [ ~/~/ Ключевые даты развития поля 5237 - { 5238 - "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5239 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5240 - } 5241 - ] 5242 - } 5243 - ], 5244 - "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая 5245 - "counts": { 5246 - "fieldOperations": 0, ~/~/ Количество операций на поле 5247 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5248 - "facts": 0 ~/~/ Счётчик факта 5249 - }, 5250 - "planComment": "string", ~/~/ Комментарий к полю 5251 - "productivity": 0, ~/~/ Урожайность. 5252 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5253 - "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая 5254 - "year": 0, ~/~/ Год поля 5255 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5256 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5257 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5258 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5259 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5260 - "id": 0, ~/~/ Идентификатор объекта геозоны 5261 - "name": "string", ~/~/ Название объекта геозоны 5262 - "type": 0, ~/~/ Тип объекта геозоны 5263 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5264 - "fname": "string", ~/~/ Имя файла 5265 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5266 - "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны 5267 - "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны 5268 - "description": "string", ~/~/ Описание объекта геозоны 5269 - "area": 0, ~/~/ Площадь, м2 5270 - "perimetr": 0, ~/~/ Периметр, м 5271 - "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд 5272 -} 5273 -))) 5274 -))) 5275 -))) 5276 -))) 5277 -))) 5278 - 5279 - 5280 -== **Редактирование года урожая ** == 5281 - 5282 -(% class="box successmessage" %) 5283 -((( 5284 -**POST /api/v3/agroLands/updateOpenCloseYear** 5285 -))) 5286 - 5287 -Пример запроса: 5288 - 5289 -((( 5290 -((( 5291 -{ 5292 - "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5293 - 0 5294 - ], 5295 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5296 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5297 -} 5298 -))) 5299 - 5300 - 5301 -))) 5302 - 5303 -Пример ответа: 5304 - 5305 -((( 5306 -((( 5307 -{ 5308 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5309 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5310 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5311 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5312 - "cropRotations": [ ~/~/ Данные по севообороту 5313 - { 5314 - "landId": 0, ~/~/ ID поля 5315 - "landName": "string", ~/~/ Название поля 5316 - "year": 0, ~/~/ Год урожая 5317 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5318 - "cultureName": "string", ~/~/ Название культуры 5319 - "productivity": 0, ~/~/ Урожайность 5320 - "area": 0, ~/~/ Площадь поля, Га. 5321 - "total": 0, ~/~/ Валовый сбор 5322 - "productivityFact": 0, ~/~/ Фактическая урожайность 5323 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5324 - "totalFact": 0, ~/~/ Фактический валовый сбор 5325 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5326 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5327 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5328 - "isyearplan": true, ~/~/ 5329 - "comment": "string" ~/~/ Комментарий 5330 - } 5331 - ], 5332 - "cropVegetation": [ ~/~/ История вегетации поля 5333 - { 5334 - "values": [ ~/~/ Данные вегетации и состояния посева 5335 - { 5336 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5337 - "ndvi": 0 ~/~/ Индекс вегетации 5338 - } 5339 - ], 5340 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5341 - { 5342 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5343 - "type": "string", ~/~/ Тип 5344 - "pictureid": "string" ~/~/ Идентификатор ресурса 5345 - } 5346 - ], 5347 - "states": [ ~/~/ Ключевые даты развития поля 5348 - { 5349 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5350 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5351 - } 5352 - ] 5353 - } 5354 - ], 5355 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5356 - "counts": { 5357 - "fieldOperations": 0, ~/~/ Количество операций на поле 5358 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5359 - "facts": 0 ~/~/ Счётчик факта 5360 - }, 5361 - "planComment": "string", ~/~/ Комментарий к полю 5362 - "productivity": 0, ~/~/ Урожайность. 5363 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5364 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5365 - "year": 0, ~/~/ Год поля 5366 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5367 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5368 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5369 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5370 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5371 - "id": 0, ~/~/ Идентификатор объекта геозоны 5372 - "name": "string", ~/~/ Название объекта геозоны 5373 - "type": 0, ~/~/ Тип объекта геозоны 5374 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5375 - "fname": "string", ~/~/ Имя файла 5376 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5377 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5378 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5379 - "description": "string", ~/~/ Описание объекта геозоны 5380 - "area": 0, ~/~/ Площадь, м2 5381 - "perimetr": 0, ~/~/ ериметр, м 5382 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5383 -} 5384 -))) 5385 - 5386 - 5387 5387 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5388 -))) 5389 -))) 5390 -))) 5391 5391 5392 5392 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5393 5393 ... ... @@ -5394,7 +5394,7 @@ 5394 5394 5395 5395 (% class="box infomessage" %) 5396 5396 ((( 5397 - **GET api/v3/Vehicles/recyclebin/all**4629 +GET api/v3/Vehicles/recyclebin/all 5398 5398 ))) 5399 5399 5400 5400 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5429,11 +5429,11 @@ 5429 5429 ] 5430 5430 5431 5431 5432 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==4664 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5433 5433 5434 5434 (% class="box infomessage" %) 5435 5435 ((( 5436 - **POST**4668 +POST/api/v3/Vehicles/recyclebin/erase 5437 5437 ))) 5438 5438 5439 5439 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5475,7 +5475,7 @@ 5475 5475 5476 5476 (% class="box infomessage" %) 5477 5477 ((( 5478 - **POST**4710 +POST/api/v3/Vehicles/recyclebin/restore 5479 5479 ))) 5480 5480 5481 5481 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5527,409 +5527,7 @@ 5527 5527 ] 5528 5528 5529 5529 5530 -= **Раздел: Журнал заданий ** = 5531 5531 5532 - 5533 -== **Создание задания в Журнале заданий** == 5534 - 5535 -(% class="box infomessage" %) 5536 -((( 5537 -**POST /api/v3/vehicletasks** 5538 -))) 5539 - 5540 -Пример запроса: 5541 - 5542 -((( 5543 -{ 5544 - "vehicleId": 0, ~/~/ Идентификатор ТС 5545 - "description": "string", ~/~/ Описание 5546 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5547 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5548 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5549 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5550 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5551 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5552 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5553 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5554 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5555 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5556 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5557 - "cost": { 5558 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5559 - "Name": "string", ~/~/ Наименование 5560 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5561 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5562 - "Norm": 0 ~/~/ Норма внесения 5563 - }, 5564 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5565 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5566 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5567 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5568 - "deleted": true, ~/~/ Признак удаления 5569 - "extId": "string", 5570 - "GeoIds": [ ~/~/ Cвязанные поля 5571 - 0 5572 - ] 5573 -} 5574 -))) 5575 - 5576 - 5577 -Пример ответа: 5578 - 5579 -{ 5580 - "vehicleId": 0, ~/~/ Идентификатор ТС 5581 - "description": "string", ~/~/ Описание 5582 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5583 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5584 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5585 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5586 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5587 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5588 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5589 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5590 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5591 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5592 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5593 - "cost": { 5594 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5595 - "Name": "string", ~/~/ Наименование 5596 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5597 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5598 - "Norm": 0 ~/~/ Норма внесения 5599 - }, 5600 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5601 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5602 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5603 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5604 - "deleted": true, ~/~/ Признак удаления 5605 - "extId": "string", ~/~/ ExtId 5606 - "GeoIds": [ ~/~/ Связанные поля 5607 - 0 5608 - ] 5609 -} 5610 - 5611 - 5612 -== **Редактирование задания в Журнале заданий** == 5613 - 5614 -(% class="box successmessage" %) 5615 -((( 5616 -**PUT /api/v3/vehicletasks** 5617 -))) 5618 - 5619 -Пример запроса: 5620 - 5621 -((( 5622 -{ 5623 - "vehicleId": 0, ~/~/ Идентификатор ТС 5624 - "description": "string", ~/~/ Описание 5625 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5626 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5627 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5628 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5629 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5630 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5631 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5632 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5633 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5634 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5635 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5636 - "cost": { 5637 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5638 - "Name": "string", ~/~/ Наименование 5639 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5640 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5641 - "Norm": 0 ~/~/ Норма внесения 5642 - }, 5643 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5644 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5645 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5646 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5647 - "deleted": true, ~/~/ Признак удаления 5648 - "extId": "string", ~/~/ ExtId 5649 - "GeoIds": [ ~/~/ Связанные поля 5650 - 0 5651 - ] 5652 -} 5653 -))) 5654 - 5655 - 5656 -Пример ответа: 5657 - 5658 -{ 5659 - "vehicleId": 0, ~/~/ Идентификатор ТС 5660 - "description": "string", ~/~/ Описание 5661 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5662 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5663 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5664 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5665 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5666 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5667 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5668 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5669 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5670 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5671 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5672 - "cost": { 5673 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5674 - "Name": "string", ~/~/ Наименование 5675 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5676 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5677 - "Norm": 0 ~/~/ Норма внесения 5678 - }, 5679 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5680 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5681 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5682 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5683 - "deleted": true, ~/~/ Признак удаления 5684 - "extId": "string", ~/~/ ExtId 5685 - "GeoIds": [ ~/~/ Связанные поля 5686 - 0 5687 - ] 5688 -} 5689 - 5690 - 5691 -== **Удаление задания в Журнале заданий** == 5692 - 5693 -(% class="box warningmessage" %) 5694 -((( 5695 -**DELETE /api/v3/vehicletasks** 5696 -))) 5697 - 5698 -Пример запроса: 5699 - 5700 -((( 5701 -[ 5702 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5703 -] 5704 -))) 5705 - 5706 -((( 5707 - 5708 -))) 5709 - 5710 -Пример ответа: 5711 - 5712 -{ 5713 - "vehicleId": 0, ~/~/ Идентификатор ТС 5714 - "description": "string", ~/~/ Описание 5715 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5716 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5717 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5718 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5719 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5720 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5721 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5722 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5723 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5724 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5725 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5726 - "cost": { 5727 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5728 - "Name": "string", ~/~/ Наименование 5729 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5730 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5731 - "Norm": 0 ~/~/ Норма внесения 5732 - }, 5733 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5734 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5735 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5736 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5737 - "deleted": true, ~/~/ Признак удаления 5738 - "extId": "string", ~/~/ ExtId 5739 - "GeoIds": [ ~/~/ Связанные поля 5740 - 0 5741 - ] 5742 -} 5743 - 5744 - 5745 -== **Получение списка Журнала заданий** == 5746 - 5747 -(% class="box infomessage" %) 5748 -((( 5749 -**POST /api/v3/vehicletasks/getbyperiod** 5750 -))) 5751 - 5752 -Пример запроса: 5753 - 5754 -((( 5755 -{ 5756 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 5757 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 5758 - "TimeZone": 0, ~/~/ Часовой пояс. 5759 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 5760 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 5761 - ], 5762 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 5763 - 0 5764 - ], 5765 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 5766 - 0 5767 - ], 5768 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 5769 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 5770 -} 5771 -))) 5772 - 5773 - 5774 -Пример ответа: 5775 - 5776 -((( 5777 -{ 5778 - "total": 0, ~/~/ Общее количество записей 5779 - "pages": 0, ~/~/ Общее количество страниц 5780 - "currentPage": 0, ~/~/ Текущая страница 5781 - "items": [ ~/~/ Записи 5782 - { 5783 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5784 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 5785 - "name": "string", ~/~/ Название задания. 5786 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 5787 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 5788 - "workKind": "string", ~/~/ Вид работ 5789 - "techOp": "string", ~/~/ Тех. операция 5790 - "trailerModel": "string", ~/~/ Модель агрегата 5791 - "width": "string", ~/~/ Ширина, м 5792 - "speed": "string", ~/~/ Тех. скорость 5793 - "fields": "string", ~/~/ Поля 5794 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 5795 - "vehicles": "string", ~/~/ Объект-модель 5796 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 5797 - "drivers": "string", ~/~/ Водители 5798 - "tmc": "string", ~/~/ ТМЦ 5799 - "client": "string", ~/~/ Клиент 5800 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5801 - "dep": "string", ~/~/ Подразделение 5802 - "geoIds": [ ~/~/ Связанные поля 5803 - 0 5804 - ] 5805 - } 5806 - ] 5807 -} 5808 -))) 5809 - 5810 - 5811 -= **Раздел: Локатор ** = 5812 - 5813 - 5814 -== **Получение списка локаторов, доступных пользователю ** == 5815 - 5816 -(% class="box infomessage" %) 5817 -((( 5818 -**GET /api/v3/locators** 5819 -))) 5820 - 5821 -В заголовках запроса: X-Auth: Токен авторизации 5822 - 5823 - 5824 -Пример ответа: 5825 - 5826 -((( 5827 -[ 5828 - { 5829 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5830 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5831 - "agentName": "string", ~/~/ Наименование агента. 5832 - "isEnabled": true, ~/~/ Активен 5833 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5834 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5835 - "name": "string", ~/~/ Наименование 5836 - "status": 0, ~/~/ 5837 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5838 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5839 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5840 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5841 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5842 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5843 - "url": "string", ~/~/ Ссылка 5844 - "language": 0, ~/~/ Язык. 5845 - "vehiclesCount": 0, ~/~/ Количество объектов. 5846 - "geozonesCount": 0, ~/~/ Количество геозон. 5847 - "fieldsCount": 0 ~/~/ Количество полей. 5848 - } 5849 -] 5850 -))) 5851 - 5852 - 5853 - 5854 -== **Создание локатора** == 5855 - 5856 -(% class="box successmessage" %) 5857 -((( 5858 -**POST /api/v3/locators** 5859 -))) 5860 - 5861 -Пример запроса: 5862 - 5863 -((( 5864 -{ 5865 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5866 - "isEnabled": true, ~/~/ Активность 5867 - "name": "string", ~/~/ Наименование локатора 5868 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 5869 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 5870 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5871 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5872 - "url": "string", ~/~/ Ссылка 5873 - "language": 0 ~/~/ Язык 5874 -} 5875 -))) 5876 - 5877 - 5878 -Пример ответа: 5879 - 5880 -((( 5881 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 5882 -))) 5883 - 5884 - 5885 - 5886 -== **Изменение локатора** == 5887 - 5888 -(% class="box infomessage" %) 5889 -((( 5890 -**PUT /api/v3/locators** 5891 -))) 5892 - 5893 -Пример запроса: 5894 - 5895 -((( 5896 -{ 5897 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5898 - "isEnabled": true, ~/~/ Активность 5899 - "name": "string", ~/~/ Наименование 5900 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 5901 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 5902 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5903 - "autoProlongation": true, ~/~/ Автопродление срока действия 5904 - "url": "string", ~/~/ Ссылка 5905 - "language": 0 ~/~/ Язык 5906 -} 5907 -))) 5908 - 5909 - 5910 -Пример ответа: 5911 - 5912 -200 ~/~/ Success 5913 - 5914 - 5915 -== **Удалить локатор** == 5916 - 5917 -(% class="box warningmessage" %) 5918 -((( 5919 -**DELETE /api/v3/locators** 5920 -))) 5921 - 5922 -Пример запроса: 5923 - 5924 -((( 5925 -[ 5926 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 5927 -] 5928 -))) 5929 - 5930 - 5931 - 5932 - 5933 5933 (% class="box" lang="en-US" style="text-align: center;" %) 5934 5934 ((( 5935 5935 (% 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]] **