Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/04/21 14:13
<
>
edited by Андрей Калиновский
on 2025/03/25 14:48
on 2025/03/25 14:48
edited by Андрей Калиновский
on 2024/12/20 15:47
on 2024/12/20 15:47
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -11,11 +11,6 @@ 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 13 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 -))) 19 19 20 20 **Содержание страницы:** 21 21 ))) ... ... @@ -1026,17 +1026,6 @@ 1026 1026 1027 1027 ((( 1028 1028 { 1029 - 1030 -((( 1031 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1032 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1033 -))) 1034 - 1035 -((( 1036 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1037 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1038 -))) 1039 - 1040 1040 "vehicleId": "", ~/~/ ID объекта 1041 1041 "name": "", ~/~/ Имя объекта 1042 1042 "imei": "", ~/~/ IMEI объекта ... ... @@ -1131,7 +1131,6 @@ 1131 1131 ], 1132 1132 "showInTooltip": true, ~/~/ Отображать в подсказке 1133 1133 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1134 - "color": "string", ~/~/ Код цвета датчиков 1135 1135 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1136 1136 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1137 1137 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1189,21 +1189,11 @@ 1189 1189 "date": "2023-05-22T09:57:39.562Z", 1190 1190 "description": "string", 1191 1191 "additionalInfo": "string" 1192 - 1193 - (((1175 + } 1176 + ] 1194 1194 } 1195 - ], 1196 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1197 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1198 1198 ))) 1199 1199 1200 -((( 1201 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1202 -} 1203 - 1204 -))) 1205 -))) 1206 - 1207 1207 (% style="text-align:left" %) 1208 1208 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1209 1209 ... ... @@ -1296,13 +1296,7 @@ 1296 1296 1297 1297 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1298 1298 1299 -(% style="color:#000000" %){ 1300 - 1301 - 1302 -((( 1303 - "vehicleId": 0, ~/~/ ID ТС 1304 -))) 1305 - 1272 +(% style="color:#000000" %){(%%) 1306 1306 "parentId": "" , ~/~/ ID клиента 1307 1307 "name": "" , ~/~/ имя ТС 1308 1308 "imei": "" , ~/~/ IMEI ... ... @@ -1395,7 +1395,6 @@ 1395 1395 ], 1396 1396 "showInTooltip": true, ~/~/ Отображать в подсказке 1397 1397 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1398 - "color": "string", ~/~/ код цвета датчиков 1399 1399 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1400 1400 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1401 1401 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1445,19 +1445,10 @@ 1445 1445 "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1446 1446 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1447 1447 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1448 - 1449 -((( 1450 - } 1451 - ], 1452 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1453 -))) 1454 - 1455 -((( 1456 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1414 + } 1415 + ] 1457 1457 } 1458 -))) 1459 1459 1460 - 1461 1461 (% style="color:#000000" %)Ответ: 1462 1462 1463 1463 ... ... @@ -1566,7 +1566,6 @@ 1566 1566 ], 1567 1567 "showInTooltip": true, ~/~/ Отображение в подсказке 1568 1568 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1569 - "color": "string", ~/~/ код цвета датчиков 1570 1570 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1571 1571 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1572 1572 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -1603,7 +1603,7 @@ 1603 1603 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1604 1604 } 1605 1605 ], 1606 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 -По датчику Моточасов, 2 -По датчику относительных Моточасов1562 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1607 1607 } 1608 1608 ))) 1609 1609 ))) ... ... @@ -1909,19 +1909,9 @@ 1909 1909 1910 1910 "drivers": [ ~/~/ Водители 1911 1911 { 1912 - 1913 -((( 1914 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1915 - "inputNumber": 0, ~/~/ № входа. 1916 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1917 - "comment": "string", ~/~/ Комментарий. 1918 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1919 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1920 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1921 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1922 -))) 1923 - 1924 - } 1868 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1869 + "isDefault": true 1870 + } 1925 1925 ], 1926 1926 "commandTemplates": [ ~/~/ Шаблон команды 1927 1927 { ... ... @@ -1957,11 +1957,6 @@ 1957 1957 ], 1958 1958 "showInTooltip": true, ~/~/ Отображать в подсказке 1959 1959 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1960 - 1961 -((( 1962 - "color": "string",** ~/~/ **Цвет датчика 1963 -))) 1964 - 1965 1965 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1966 1966 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1967 1967 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -2008,12 +2008,7 @@ 2008 2008 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2009 2009 "forReport": true ~/~/ Отобразить произвольное поле в отчете 2010 2010 } 2011 - 2012 -((( 2013 - ], 2014 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 2015 -))) 2016 - 1952 + ] 2017 2017 } 2018 2018 2019 2019 ... ... @@ -2151,11 +2151,6 @@ 2151 2151 ], 2152 2152 "showInTooltip": true, ~/~/ Отображение в подсказке 2153 2153 "showLastValid": true, ~/~/ Отображать последнее валидное значение 2154 - 2155 -((( 2156 - "color": "string", ~/~/ цвет уведомлений 2157 -))) 2158 - 2159 2159 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2160 2160 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2161 2161 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -2472,8 +2472,6 @@ 2472 2472 "motohours": 0, ~/~/ Моточасы за период, секунды 2473 2473 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2474 2474 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2475 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2476 - 2477 2477 } 2478 2478 ] 2479 2479 } ... ... @@ -2517,8 +2517,6 @@ 2517 2517 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2518 2518 "fuelConsumption": 0, ~/~/ Расход топлива 2519 2519 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2520 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2521 - 2522 2522 } 2523 2523 ] 2524 2524 } ... ... @@ -2564,8 +2564,7 @@ 2564 2564 "model": "string", ~/~/ Модель объекта 2565 2565 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2566 2566 { 2567 - "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 2568 - 2494 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2569 2569 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2570 2570 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2571 2571 "valueFuel": 0, ~/~/ Количество ... ... @@ -4457,7 +4457,7 @@ 4457 4457 4458 4458 (% class="box infomessage" %) 4459 4459 ((( 4460 - **POST /api/v3/fuelcards/transactions**4386 +POST /api/v3/fuelcards/transactions 4461 4461 ))) 4462 4462 4463 4463 Метод запроса: POST ... ... @@ -4495,32 +4495,7 @@ 4495 4495 "address": "string" ~/~/ Адрес АЗС 4496 4496 } 4497 4497 4498 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4499 4499 4500 -(% class="box infomessage" %) 4501 -((( 4502 -**GET /api/v3/fuelcards** 4503 -))) 4504 - 4505 -Метод запроса: GET 4506 - 4507 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4508 - 4509 -Ответ: 4510 - 4511 -[ 4512 - { 4513 - "Name": "string", ~/~/ Определяет наименование карты. 4514 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4515 - "Number": "string", ~/~/ Определяет № карты. 4516 - "Enabled": true, ~/~/ Определяет признак активности карты. 4517 - "Description": "string", ~/~/ Определяет описание карты. 4518 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4519 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4520 - "deleted": true ~/~/ Признак удаления 4521 - } 4522 -] 4523 - 4524 4524 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4525 4525 4526 4526 ... ... @@ -4699,7 +4699,7 @@ 4699 4699 4700 4700 (% class="box infomessage" %) 4701 4701 ((( 4702 - **POST /api/v3/Reports/harvesterUnloading**4603 +POST **/api/v3/Reports/harvesterUnloading** 4703 4703 ))) 4704 4704 4705 4705 Пример запроса: ... ... @@ -4771,131 +4771,140 @@ 4771 4771 ] 4772 4772 4773 4773 4774 -== ** Отчеттрек-датчики** ==4675 += (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4775 4775 4677 +== **Получение поля по id** == 4678 + 4776 4776 (% class="box infomessage" %) 4777 4777 ((( 4778 -** POST/api/v3/Reports/sensorsWorks**4681 +GET **/api/v3/agroLands/{id}** 4779 4779 ))) 4780 4780 4781 -**Пример запроса:** 4684 +Пример запроса: 4685 +id ~/~/ Идентификатор поля 4782 4782 4783 -{ 4784 - "vehicleIds": [ ~/~/ Список ID объектов 4785 - 0 4786 - ], 4787 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4788 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4789 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4790 -} 4687 +Пример ответа: 4791 4791 4792 -**Пример ответа:** 4793 - 4794 4794 ((( 4795 4795 { 4796 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4691 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4692 + "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4693 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4694 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4695 + "cropRotations": [ ~/~/ Данные по севообороту 4797 4797 { 4798 - "vehicleId": 0, ~/~/ Идентификатор ТС 4799 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4697 + "landId": 0, ~/~/ ID поля 4698 + "landName": "string", ~/~/ Название поля 4699 + "year": 0, ~/~/ Год урожая 4700 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4701 + "cultureName": "string", ~/~/ Название культуры 4702 + "productivity": 0, ~/~/ Урожайность 4703 + "area": 0, ~/~/ Площадь поля, Га 4704 + "total": 0, ~/~/ Валовый сбор 4705 + "productivityFact": 0, ~/~/ Фактическая урожайность 4706 + "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4707 + "totalFact": 0, ~/~/ Фактический валовый сбор 4708 + "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 4709 + "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 4710 + "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 4711 + "isyearplan": true, ~/~/ План года 4712 + "comment": "string" ~/~/ Комментарий 4713 + } 4714 + ], 4715 + "cropVegetation": [ ~/~/ История вегетации поля 4716 + { 4717 + "values": [ ~/~/ Данные вегетации и состояния посева 4800 4800 { 4801 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4802 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4803 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4804 - "name": "string", ~/~/ Наименование оборудования. 4805 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4806 - "totalMileage": 0, ~/~/ Общий пробег. 4807 - "avgSpeed": 0 ~/~/ Средняя скорость. 4719 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4720 + "ndvi": 0 ~/~/ Индекс вегетации 4808 4808 } 4722 + ], 4723 + "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 4724 + { 4725 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4726 + "type": "string", ~/~/ Тип 4727 + "pictureid": "string" ~/~/ Идентификатор ресурса 4728 + } 4729 + ], 4730 + "states": [ ~/~/ Ключевые даты развития поля 4731 + { 4732 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4733 + "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 4734 + } 4809 4809 ] 4810 4810 } 4811 - ] 4737 + ], 4738 + "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 4739 + "counts": { 4740 + "fieldOperations": 0, ~/~/ Количество операций на поле 4741 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4742 + "facts": 0 ~/~/ Счётчик факта 4743 + }, 4744 + "planComment": "string", ~/~/ Комментарий к полю 4745 + "productivity": 0, ~/~/ Урожайность. 4746 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4747 +))) 4748 + 4749 +((( 4750 +((( 4751 + "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 4752 + "year": 0, ~/~/ Год поля 4753 + "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4754 + "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4755 + "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4756 + "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4757 + "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4758 + "id": 0, ~/~/ Идентификатор объекта геозоны 4759 + "name": "string", ~/~/ Название объекта геозоны 4760 + "type": 0, ~/~/ Тип объекта геозоны 4761 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4762 + "fname": "string", ~/~/ Имя файла 4763 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4764 + "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 4765 + "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 4766 + "description": "string", ~/~/ Описание объекта геозоны 4767 + "area": 0, ~/~/ Площадь, м2 4768 + "perimetr": 0, ~/~/ Периметр, м 4769 + "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 4812 4812 } 4813 4813 ))) 4814 4814 4815 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4816 4816 4774 +== **Удалить поле** == 4817 4817 4818 -== **Запрос списка полей** == 4819 - 4820 -(% class="box successmessage" %) 4776 +(% class="box errormessage" %) 4821 4821 ((( 4822 -** POST/api/v3/agroLands/find**4778 +DELETE **/api/v3/agroLands/{id}** 4823 4823 ))) 4824 4824 4825 4825 Пример запроса: 4782 +id ~/~/ Идентификатор поля 4826 4826 4784 +Пример ответа: 4785 + 4827 4827 ((( 4828 -((( 4829 -((( 4830 -{ 4831 - "year": 0, ~/~/ Фильтр по году 4832 - "name": "string", ~/~/ Фильтр по названию 4833 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 4834 -} 4787 +200 ~/~/ Успех 4835 4835 ))) 4836 -))) 4837 4837 4790 +((( 4838 4838 4839 4839 ))) 4840 4840 4841 -Пример ответа: 4842 - 4843 4843 ((( 4844 -[ 4845 - { 4846 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4847 - "year": 0, ~/~/ Год поля 4848 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 4849 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 4850 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 4851 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4852 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4853 - "counts": { ~/~/ Счётчики с/х поля 4854 - "fieldOperations": 0, ~/~/ Количество операций на поле 4855 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4856 - "facts": 0 ~/~/ Счётчик факта 4857 - }, 4858 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4859 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4860 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4861 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4862 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4863 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4864 - "planComment": "string", ~/~/ Комментарий к полю 4865 - "productivity": 0, ~/~/ Урожайность. 4866 - "id": 0, ~/~/ Идентификатор объекта геозоны 4867 - "name": "string", ~/~/ Название объекта геозоны 4868 - "type": 0, ~/~/ Тип объекта геозоны 4869 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4870 - "fname": "string", ~/~/ Имя файла 4871 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4872 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 4873 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 4874 - "description": "string", ~/~/ Описание объекта геозоны 4875 - "area": 0, ~/~/ Площадь, м2 4876 - "perimetr": 0, ~/~/ Периметр, м 4877 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 4878 - } 4879 -] 4795 +== **Сохранение поля** == 4880 4880 4881 - 4882 -== **Создание нового поля ** == 4883 - 4884 4884 (% class="box successmessage" %) 4885 4885 ((( 4886 - **POST /api/v3/agroLands**4799 +POST **/api/v3/agroLands** 4887 4887 ))) 4888 4888 4889 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 4890 -X-agent - ID клиента 4891 - 4892 4892 Пример запроса: 4893 4893 4894 4894 ((( 4895 4895 { 4896 4896 "extId": "string", 4897 - "shape": " {\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}",~/~/ Форма поля4898 - "shapeFormat": " geojson", ~/~/ Формат, в котором представлена форма поля4807 + "shape": "string", ~/~/ Форма поля 4808 + "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 4899 4899 "display": "string", ~/~/ Настройки отображения 4900 4900 "year": 0, ~/~/ Год поля 4901 4901 "name": "string", ~/~/ Наименование ... ... @@ -5014,141 +5014,18 @@ 5014 5014 "perimetr": 0, ~/~/ Периметр, м 5015 5015 "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5016 5016 } 5017 - 5018 - 5019 5019 ))) 5020 -))) 5021 -))) 5022 5022 5023 -== **Получение поля по id** == 5024 - 5025 -(% class="box infomessage" %) 5026 5026 ((( 5027 -**GET /api/v3/agroLands/{id}** 5028 -))) 5029 - 5030 -Пример запроса: 5031 -id ~/~/ Идентификатор поля 5032 - 5033 -Пример ответа: 5034 - 5035 -((( 5036 -{ 5037 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5038 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5039 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5040 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5041 - "cropRotations": [ ~/~/ Данные по севообороту 5042 - { 5043 - "landId": 0, ~/~/ ID поля 5044 - "landName": "string", ~/~/ Название поля 5045 - "year": 0, ~/~/ Год урожая 5046 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5047 - "cultureName": "string", ~/~/ Название культуры 5048 - "productivity": 0, ~/~/ Урожайность 5049 - "area": 0, ~/~/ Площадь поля, Га 5050 - "total": 0, ~/~/ Валовый сбор 5051 - "productivityFact": 0, ~/~/ Фактическая урожайность 5052 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5053 - "totalFact": 0, ~/~/ Фактический валовый сбор 5054 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5055 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5056 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5057 - "isyearplan": true, ~/~/ План года 5058 - "comment": "string" ~/~/ Комментарий 5059 - } 5060 - ], 5061 - "cropVegetation": [ ~/~/ История вегетации поля 5062 - { 5063 - "values": [ ~/~/ Данные вегетации и состояния посева 5064 - { 5065 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5066 - "ndvi": 0 ~/~/ Индекс вегетации 5067 - } 5068 - ], 5069 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5070 - { 5071 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5072 - "type": "string", ~/~/ Тип 5073 - "pictureid": "string" ~/~/ Идентификатор ресурса 5074 - } 5075 - ], 5076 - "states": [ ~/~/ Ключевые даты развития поля 5077 - { 5078 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5079 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5080 - } 5081 - ] 5082 - } 5083 - ], 5084 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5085 - "counts": { 5086 - "fieldOperations": 0, ~/~/ Количество операций на поле 5087 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5088 - "facts": 0 ~/~/ Счётчик факта 5089 - }, 5090 - "planComment": "string", ~/~/ Комментарий к полю 5091 - "productivity": 0, ~/~/ Урожайность. 5092 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5093 -))) 5094 - 5095 -((( 5096 -((( 5097 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5098 - "year": 0, ~/~/ Год поля 5099 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5100 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5101 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5102 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5103 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5104 - "id": 0, ~/~/ Идентификатор объекта геозоны 5105 - "name": "string", ~/~/ Название объекта геозоны 5106 - "type": 0, ~/~/ Тип объекта геозоны 5107 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5108 - "fname": "string", ~/~/ Имя файла 5109 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5110 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5111 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5112 - "description": "string", ~/~/ Описание объекта геозоны 5113 - "area": 0, ~/~/ Площадь, м2 5114 - "perimetr": 0, ~/~/ Периметр, м 5115 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5116 -} 5117 -))) 5118 - 5119 - 5120 -== **Удаление существующего поля** == 5121 - 5122 -(% class="box errormessage" %) 5123 -((( 5124 -**DELETE /api/v3/agroLands/{id}** 5125 -))) 5126 - 5127 -Пример запроса: 5128 -id ~/~/ Идентификатор поля 5129 - 5130 -Пример ответа: 5131 - 5132 -((( 5133 -200 ~/~/ Успех 5134 -))) 5135 - 5136 -((( 5137 5137 5138 5138 ))) 5139 5139 5140 5140 ((( 5141 -((( 5142 -((( 5143 - 5144 -))) 5145 - 5146 -((( 5147 5147 == **Изменение поля** == 5148 5148 5149 5149 (% class="box infomessage" %) 5150 5150 ((( 5151 - **PUT /api/v3/agroLands**4938 +PUT **/api/v3/agroLands** 5152 5152 ))) 5153 5153 5154 5154 Пример запроса: ... ... @@ -5285,11 +5285,11 @@ 5285 5285 ))) 5286 5286 5287 5287 5288 -== ** Редактирование года урожая5075 +== **Функция обновляет закрытие/открытие года урожая** == 5289 5289 5290 5290 (% class="box successmessage" %) 5291 5291 ((( 5292 - **POST /api/v3/agroLands/updateOpenCloseYear**5079 +POST **/api/v3/agroLands/updateOpenCloseYear** 5293 5293 ))) 5294 5294 5295 5295 Пример запроса: ... ... @@ -5392,17 +5392,81 @@ 5392 5392 ))) 5393 5393 5394 5394 5395 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5182 +== **Возвращает список полей** == 5183 + 5184 +(% class="box successmessage" %) 5185 +((( 5186 +POST **/api/v3/agroLands/find** 5396 5396 ))) 5188 + 5189 +Пример запроса: 5190 + 5191 +((( 5192 +((( 5193 +((( 5194 +{ 5195 + "year": 0, ~/~/ Фильтр по году 5196 + "name": "string", ~/~/ Фильтр по названию 5197 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 5198 +} 5397 5397 ))) 5398 5398 ))) 5399 5399 5202 + 5203 +))) 5204 + 5205 +Пример ответа: 5206 + 5207 +((( 5208 +[ 5209 + { 5210 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5211 + "year": 0, ~/~/ Год поля 5212 + "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 5213 + "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 5214 + "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5215 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5216 + "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5217 + "counts": { ~/~/ Счётчики с/х поля 5218 + "fieldOperations": 0, ~/~/ Количество операций на поле 5219 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5220 + "facts": 0 ~/~/ Счётчик факта 5221 + }, 5222 + "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5223 + "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5224 + "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5225 + "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5226 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5227 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5228 + "planComment": "string", ~/~/ Комментарий к полю 5229 + "productivity": 0, ~/~/ Урожайность. 5230 + "id": 0, ~/~/ Идентификатор объекта геозоны 5231 + "name": "string", ~/~/ Название объекта геозоны 5232 + "type": 0, ~/~/ Тип объекта геозоны 5233 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5234 + "fname": "string", ~/~/ Имя файла 5235 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5236 + "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 5237 + "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 5238 + "description": "string", ~/~/ Описание объекта геозоны 5239 + "area": 0, ~/~/ Площадь, м2 5240 + "perimetr": 0, ~/~/ Периметр, м 5241 + "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 5242 + } 5243 +] 5244 +))) 5245 +))) 5246 +))) 5247 +))) 5248 + 5249 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5250 + 5400 5400 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5401 5401 5402 5402 5403 5403 (% class="box infomessage" %) 5404 5404 ((( 5405 - **GET api/v3/Vehicles/recyclebin/all**5256 +GET api/v3/Vehicles/recyclebin/all 5406 5406 ))) 5407 5407 5408 5408 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5437,11 +5437,11 @@ 5437 5437 ] 5438 5438 5439 5439 5440 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==5291 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5441 5441 5442 5442 (% class="box infomessage" %) 5443 5443 ((( 5444 - **POST**5295 +POST/api/v3/Vehicles/recyclebin/erase 5445 5445 ))) 5446 5446 5447 5447 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5483,7 +5483,7 @@ 5483 5483 5484 5484 (% class="box infomessage" %) 5485 5485 ((( 5486 - **POST**5337 +POST/api/v3/Vehicles/recyclebin/restore 5487 5487 ))) 5488 5488 5489 5489 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5535,550 +5535,7 @@ 5535 5535 ] 5536 5536 5537 5537 5538 -= **Раздел: Журнал заданий ** = 5539 5539 5540 - 5541 -== **Создание задания в Журнале заданий** == 5542 - 5543 -(% class="box infomessage" %) 5544 -((( 5545 -**POST /api/v3/vehicletasks** 5546 -))) 5547 - 5548 -Пример запроса: 5549 - 5550 -((( 5551 -{ 5552 - "vehicleId": 0, ~/~/ Идентификатор ТС 5553 - "description": "string", ~/~/ Описание 5554 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5555 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5556 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5557 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5558 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5559 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5560 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5561 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5562 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5563 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5564 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5565 - "cost": { 5566 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5567 - "Name": "string", ~/~/ Наименование 5568 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5569 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5570 - "Norm": 0 ~/~/ Норма внесения 5571 - }, 5572 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5573 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5574 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5575 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5576 - "deleted": true, ~/~/ Признак удаления 5577 - "extId": "string", 5578 - "GeoIds": [ ~/~/ Cвязанные поля 5579 - 0 5580 - ] 5581 -} 5582 -))) 5583 - 5584 - 5585 -Пример ответа: 5586 - 5587 -{ 5588 - "vehicleId": 0, ~/~/ Идентификатор ТС 5589 - "description": "string", ~/~/ Описание 5590 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5591 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5592 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5593 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5594 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5595 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5596 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5597 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5598 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5599 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5600 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5601 - "cost": { 5602 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5603 - "Name": "string", ~/~/ Наименование 5604 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5605 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5606 - "Norm": 0 ~/~/ Норма внесения 5607 - }, 5608 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5609 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5610 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5611 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5612 - "deleted": true, ~/~/ Признак удаления 5613 - "extId": "string", ~/~/ ExtId 5614 - "GeoIds": [ ~/~/ Связанные поля 5615 - 0 5616 - ] 5617 -} 5618 - 5619 - 5620 -== **Редактирование задания в Журнале заданий** == 5621 - 5622 -(% class="box successmessage" %) 5623 -((( 5624 -**PUT /api/v3/vehicletasks** 5625 -))) 5626 - 5627 -Пример запроса: 5628 - 5629 -((( 5630 -{ 5631 - "vehicleId": 0, ~/~/ Идентификатор ТС 5632 - "description": "string", ~/~/ Описание 5633 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5634 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5635 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5636 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5637 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5638 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5639 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5640 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5641 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5642 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5643 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5644 - "cost": { 5645 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5646 - "Name": "string", ~/~/ Наименование 5647 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5648 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5649 - "Norm": 0 ~/~/ Норма внесения 5650 - }, 5651 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5652 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5653 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5654 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5655 - "deleted": true, ~/~/ Признак удаления 5656 - "extId": "string", ~/~/ ExtId 5657 - "GeoIds": [ ~/~/ Связанные поля 5658 - 0 5659 - ] 5660 -} 5661 -))) 5662 - 5663 - 5664 -Пример ответа: 5665 - 5666 -{ 5667 - "vehicleId": 0, ~/~/ Идентификатор ТС 5668 - "description": "string", ~/~/ Описание 5669 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5670 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5671 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5672 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5673 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5674 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5675 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5676 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5677 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5678 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5679 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5680 - "cost": { 5681 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5682 - "Name": "string", ~/~/ Наименование 5683 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5684 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5685 - "Norm": 0 ~/~/ Норма внесения 5686 - }, 5687 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5688 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5689 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5690 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5691 - "deleted": true, ~/~/ Признак удаления 5692 - "extId": "string", ~/~/ ExtId 5693 - "GeoIds": [ ~/~/ Связанные поля 5694 - 0 5695 - ] 5696 -} 5697 - 5698 - 5699 -== **Удаление задания в Журнале заданий** == 5700 - 5701 -(% class="box warningmessage" %) 5702 -((( 5703 -**DELETE /api/v3/vehicletasks** 5704 -))) 5705 - 5706 -Пример запроса: 5707 - 5708 -((( 5709 -[ 5710 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5711 -] 5712 -))) 5713 - 5714 -((( 5715 - 5716 -))) 5717 - 5718 -Пример ответа: 5719 - 5720 -{ 5721 - "vehicleId": 0, ~/~/ Идентификатор ТС 5722 - "description": "string", ~/~/ Описание 5723 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5724 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5725 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5726 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5727 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5728 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5729 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5730 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5731 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5732 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5733 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5734 - "cost": { 5735 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5736 - "Name": "string", ~/~/ Наименование 5737 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5738 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5739 - "Norm": 0 ~/~/ Норма внесения 5740 - }, 5741 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5742 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5743 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5744 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5745 - "deleted": true, ~/~/ Признак удаления 5746 - "extId": "string", ~/~/ ExtId 5747 - "GeoIds": [ ~/~/ Связанные поля 5748 - 0 5749 - ] 5750 -} 5751 - 5752 - 5753 -== **Получение списка Журнала заданий** == 5754 - 5755 -(% class="box infomessage" %) 5756 -((( 5757 -**POST /api/v3/vehicletasks/getbyperiod** 5758 -))) 5759 - 5760 -Пример запроса: 5761 - 5762 -((( 5763 -{ 5764 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 5765 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 5766 - "TimeZone": 0, ~/~/ Часовой пояс. 5767 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 5768 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 5769 - ], 5770 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 5771 - 0 5772 - ], 5773 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 5774 - 0 5775 - ], 5776 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 5777 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 5778 -} 5779 -))) 5780 - 5781 - 5782 -Пример ответа: 5783 - 5784 -((( 5785 -{ 5786 - "total": 0, ~/~/ Общее количество записей 5787 - "pages": 0, ~/~/ Общее количество страниц 5788 - "currentPage": 0, ~/~/ Текущая страница 5789 - "items": [ ~/~/ Записи 5790 - { 5791 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5792 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 5793 - "name": "string", ~/~/ Название задания. 5794 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 5795 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 5796 - "workKind": "string", ~/~/ Вид работ 5797 - "techOp": "string", ~/~/ Тех. операция 5798 - "trailerModel": "string", ~/~/ Модель агрегата 5799 - "width": "string", ~/~/ Ширина, м 5800 - "speed": "string", ~/~/ Тех. скорость 5801 - "fields": "string", ~/~/ Поля 5802 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 5803 - "vehicles": "string", ~/~/ Объект-модель 5804 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 5805 - "drivers": "string", ~/~/ Водители 5806 - "tmc": "string", ~/~/ ТМЦ 5807 - "client": "string", ~/~/ Клиент 5808 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5809 - "dep": "string", ~/~/ Подразделение 5810 - "geoIds": [ ~/~/ Связанные поля 5811 - 0 5812 - ] 5813 - } 5814 - ] 5815 -} 5816 -))) 5817 - 5818 - 5819 -= **Раздел: Локатор ** = 5820 - 5821 - 5822 -== **Получение списка локаторов, доступных пользователю ** == 5823 - 5824 -(% class="box infomessage" %) 5825 -((( 5826 -**GET /api/v3/locators** 5827 -))) 5828 - 5829 -В заголовках запроса: X-Auth: Токен авторизации 5830 - 5831 - 5832 -Пример ответа: 5833 - 5834 -((( 5835 -[ 5836 - { 5837 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5838 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5839 - "agentName": "string", ~/~/ Наименование агента. 5840 - "isEnabled": true, ~/~/ Активен 5841 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5842 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5843 - "name": "string", ~/~/ Наименование 5844 - "status": 0, ~/~/ 5845 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5846 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5847 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5848 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5849 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5850 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5851 - "url": "string", ~/~/ Ссылка 5852 - "language": 0, ~/~/ Язык. 5853 - "vehiclesCount": 0, ~/~/ Количество объектов. 5854 - "geozonesCount": 0, ~/~/ Количество геозон. 5855 - "fieldsCount": 0 ~/~/ Количество полей. 5856 - } 5857 -] 5858 -))) 5859 - 5860 - 5861 - 5862 -== **Создание локатора** == 5863 - 5864 -(% class="box successmessage" %) 5865 -((( 5866 -**POST /api/v3/locators** 5867 -))) 5868 - 5869 -Пример запроса: 5870 - 5871 -((( 5872 -{ 5873 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5874 - "isEnabled": true, ~/~/ Активность 5875 - "name": "string", ~/~/ Наименование локатора 5876 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 5877 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 5878 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5879 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5880 - "url": "string", ~/~/ Ссылка 5881 - "language": 0 ~/~/ Язык 5882 -} 5883 -))) 5884 - 5885 - 5886 -Пример ответа: 5887 - 5888 -((( 5889 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 5890 -))) 5891 - 5892 - 5893 - 5894 -== **Изменение локатора** == 5895 - 5896 -(% class="box infomessage" %) 5897 -((( 5898 -**PUT /api/v3/locators** 5899 -))) 5900 - 5901 -Пример запроса: 5902 - 5903 -((( 5904 -{ 5905 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5906 - "isEnabled": true, ~/~/ Активность 5907 - "name": "string", ~/~/ Наименование 5908 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 5909 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 5910 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5911 - "autoProlongation": true, ~/~/ Автопродление срока действия 5912 - "url": "string", ~/~/ Ссылка 5913 - "language": 0 ~/~/ Язык 5914 -} 5915 -))) 5916 - 5917 - 5918 -Пример ответа: 5919 - 5920 -200 ~/~/ Success 5921 - 5922 - 5923 -== **Удалить локатор** == 5924 - 5925 -(% class="box warningmessage" %) 5926 -((( 5927 -**DELETE /api/v3/locators** 5928 -))) 5929 - 5930 -Пример запроса: 5931 - 5932 -((( 5933 -[ 5934 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 5935 -] 5936 -))) 5937 - 5938 - 5939 - 5940 -= **Раздел: Яндекс Маршруты** = 5941 - 5942 - 5943 -== **Возвращение списка маршрутов** == 5944 - 5945 -(% class="box infomessage" %) 5946 -((( 5947 -**GET /api/v3/TransportRoutes** 5948 -))) 5949 - 5950 -Пример запроса: 5951 -Id ~/~/ Идентификатор поля 5952 - 5953 - 5954 -Пример ответа: 5955 - 5956 -((( 5957 -[ 5958 - { 5959 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 5960 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 5961 - "name": "string", ~/~/ Наименование маршрута. 5962 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 5963 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 5964 - 0 5965 - ] 5966 - } 5967 -] 5968 -))) 5969 - 5970 - 5971 - 5972 -== **Добавить маршрут** == 5973 - 5974 -(% class="box infomessage" %) 5975 -((( 5976 -**POST /api/v3/TransportRoutes** 5977 -))) 5978 - 5979 -Пример запроса: 5980 -{ 5981 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 5982 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 5983 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 5984 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 5985 - 0 5986 - ] 5987 -} 5988 - 5989 - 5990 -Пример ответа: 5991 - 5992 -((( 5993 -{ 5994 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5995 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 5996 - "name": "string", ~/~/ Определяет наименование маршрута 5997 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 5998 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 5999 - 0 6000 - ] 6001 -} 6002 -))) 6003 - 6004 - 6005 -== **Обновление маршрута** == 6006 - 6007 -(% class="box successmessage" %) 6008 -((( 6009 -**PUT /api/v3/TransportRoutes** 6010 -))) 6011 - 6012 -Пример запроса: 6013 - 6014 -((( 6015 -{ 6016 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6017 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6018 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6019 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6020 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6021 - 0 6022 - ] 6023 -} 6024 -))) 6025 - 6026 - 6027 -Пример ответа: 6028 - 6029 -((( 6030 -{ 6031 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6032 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6033 - "name": "string", ~/~/ Определяет наименование маршрута 6034 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6035 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6036 - 0 6037 - ] 6038 -} 6039 -))) 6040 - 6041 - 6042 -== **Получить связки маршрутов ТС** == 6043 - 6044 -(% class="box infomessage" %) 6045 -((( 6046 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6047 -))) 6048 - 6049 -Пример запроса: 6050 - 6051 -((( 6052 -[ 6053 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6054 -] 6055 -))) 6056 - 6057 - 6058 -Пример ответа: 6059 - 6060 -((( 6061 -[ 6062 - { 6063 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6064 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6065 - } 6066 -] 6067 -))) 6068 - 6069 - 6070 -== **Удалить маршрут** == 6071 - 6072 -(% class="box warningmessage" %) 6073 -((( 6074 -**DELETE /api/v3/TransportRoutes/{id}** 6075 -))) 6076 - 6077 -Пример запроса: 6078 -Id ~/~/ Идентификатор поля 6079 - 6080 - 6081 - 6082 6082 (% class="box" lang="en-US" style="text-align: center;" %) 6083 6083 ((( 6084 6084 (% 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]] **