Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Андрей Калиновский 2025/04/21 14:13
<
>
отредактировано Андрей Калиновский
на 2025/03/19 13:51
на 2025/03/19 13:51
отредактировано Андрей Калиновский
на 2024/12/20 14:28
на 2024/12/20 14:28
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -2,6 +2,10 @@ 2 2 ((( 3 3 (% class="box warningmessage" %) 4 4 ((( 5 + 6 + 7 + 8 + 5 5 (% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 6 6 просим вас соблюдать несколько простых правил при использовании API-команд:## 7 7 ))) ... ... @@ -11,14 +11,7 @@ 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 13 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в пользовательских настройках. 17 -))) 18 18 19 -При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 20 - 21 - 22 22 **Содержание страницы:** 23 23 ))) 24 24 ... ... @@ -1028,17 +1028,6 @@ 1028 1028 1029 1029 ((( 1030 1030 { 1031 - 1032 -((( 1033 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1034 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1035 -))) 1036 - 1037 -((( 1038 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1039 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1040 -))) 1041 - 1042 1042 "vehicleId": "", ~/~/ ID объекта 1043 1043 "name": "", ~/~/ Имя объекта 1044 1044 "imei": "", ~/~/ IMEI объекта ... ... @@ -1133,7 +1133,6 @@ 1133 1133 ], 1134 1134 "showInTooltip": true, ~/~/ Отображать в подсказке 1135 1135 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1136 - "color": "string", ~/~/ Код цвета датчиков 1137 1137 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1138 1138 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1139 1139 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1191,21 +1191,11 @@ 1191 1191 "date": "2023-05-22T09:57:39.562Z", 1192 1192 "description": "string", 1193 1193 "additionalInfo": "string" 1194 - 1195 - (((1179 + } 1180 + ] 1196 1196 } 1197 - ], 1198 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1199 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1200 1200 ))) 1201 1201 1202 -((( 1203 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1204 -} 1205 - 1206 -))) 1207 -))) 1208 - 1209 1209 (% style="text-align:left" %) 1210 1210 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1211 1211 ... ... @@ -1298,13 +1298,7 @@ 1298 1298 1299 1299 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1300 1300 1301 -(% style="color:#000000" %){ 1302 - 1303 - 1304 -((( 1305 - "vehicleId": 0, ~/~/ ID ТС 1306 -))) 1307 - 1276 +(% style="color:#000000" %){(%%) 1308 1308 "parentId": "" , ~/~/ ID клиента 1309 1309 "name": "" , ~/~/ имя ТС 1310 1310 "imei": "" , ~/~/ IMEI ... ... @@ -1397,7 +1397,6 @@ 1397 1397 ], 1398 1398 "showInTooltip": true, ~/~/ Отображать в подсказке 1399 1399 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1400 - "color": "string", ~/~/ код цвета датчиков 1401 1401 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1402 1402 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1403 1403 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1447,19 +1447,10 @@ 1447 1447 "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1448 1448 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1449 1449 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1450 - 1451 -((( 1452 - } 1453 - ], 1454 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1455 -))) 1456 - 1457 -((( 1458 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1418 + } 1419 + ] 1459 1459 } 1460 -))) 1461 1461 1462 - 1463 1463 (% style="color:#000000" %)Ответ: 1464 1464 1465 1465 ... ... @@ -1568,7 +1568,6 @@ 1568 1568 ], 1569 1569 "showInTooltip": true, ~/~/ Отображение в подсказке 1570 1570 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1571 - "color": "string", ~/~/ код цвета датчиков 1572 1572 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1573 1573 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1574 1574 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -1605,7 +1605,7 @@ 1605 1605 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1606 1606 } 1607 1607 ], 1608 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 -По датчику Моточасов, 2 -По датчику относительных Моточасов1566 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1609 1609 } 1610 1610 ))) 1611 1611 ))) ... ... @@ -1911,19 +1911,9 @@ 1911 1911 1912 1912 "drivers": [ ~/~/ Водители 1913 1913 { 1914 - 1915 -((( 1916 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1917 - "inputNumber": 0, ~/~/ № входа. 1918 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1919 - "comment": "string", ~/~/ Комментарий. 1920 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1921 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1922 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1923 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1924 -))) 1925 - 1926 - } 1872 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1873 + "isDefault": true 1874 + } 1927 1927 ], 1928 1928 "commandTemplates": [ ~/~/ Шаблон команды 1929 1929 { ... ... @@ -1959,11 +1959,6 @@ 1959 1959 ], 1960 1960 "showInTooltip": true, ~/~/ Отображать в подсказке 1961 1961 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1962 - 1963 -((( 1964 - "color": "string",** ~/~/ **Цвет датчика 1965 -))) 1966 - 1967 1967 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1968 1968 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1969 1969 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -2010,12 +2010,7 @@ 2010 2010 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2011 2011 "forReport": true ~/~/ Отобразить произвольное поле в отчете 2012 2012 } 2013 - 2014 -((( 2015 - ], 2016 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 2017 -))) 2018 - 1956 + ] 2019 2019 } 2020 2020 2021 2021 ... ... @@ -2153,11 +2153,6 @@ 2153 2153 ], 2154 2154 "showInTooltip": true, ~/~/ Отображение в подсказке 2155 2155 "showLastValid": true, ~/~/ Отображать последнее валидное значение 2156 - 2157 -((( 2158 - "color": "string", ~/~/ цвет уведомлений 2159 -))) 2160 - 2161 2161 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2162 2162 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2163 2163 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -2474,8 +2474,6 @@ 2474 2474 "motohours": 0, ~/~/ Моточасы за период, секунды 2475 2475 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2476 2476 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2477 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2478 - 2479 2479 } 2480 2480 ] 2481 2481 } ... ... @@ -4456,7 +4456,7 @@ 4456 4456 4457 4457 (% class="box infomessage" %) 4458 4458 ((( 4459 - **POST /api/v3/fuelcards/transactions**4390 +POST /api/v3/fuelcards/transactions 4460 4460 ))) 4461 4461 4462 4462 Метод запроса: POST ... ... @@ -4494,32 +4494,7 @@ 4494 4494 "address": "string" ~/~/ Адрес АЗС 4495 4495 } 4496 4496 4497 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4498 4498 4499 -(% class="box infomessage" %) 4500 -((( 4501 -**GET /api/v3/fuelcards** 4502 -))) 4503 - 4504 -Метод запроса: GET 4505 - 4506 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4507 - 4508 -Ответ: 4509 - 4510 -[ 4511 - { 4512 - "Name": "string", ~/~/ Определяет наименование карты. 4513 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4514 - "Number": "string", ~/~/ Определяет № карты. 4515 - "Enabled": true, ~/~/ Определяет признак активности карты. 4516 - "Description": "string", ~/~/ Определяет описание карты. 4517 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4518 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4519 - "deleted": true ~/~/ Признак удаления 4520 - } 4521 -] 4522 - 4523 4523 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4524 4524 4525 4525 ... ... @@ -4698,7 +4698,7 @@ 4698 4698 4699 4699 (% class="box infomessage" %) 4700 4700 ((( 4701 - **POST /api/v3/Reports/harvesterUnloading**4607 +POST **/api/v3/Reports/harvesterUnloading** 4702 4702 ))) 4703 4703 4704 4704 Пример запроса: ... ... @@ -4770,131 +4770,140 @@ 4770 4770 ] 4771 4771 4772 4772 4773 -== ** Отчеттрек-датчики** ==4679 += (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4774 4774 4681 +== **Получение участка по id** == 4682 + 4775 4775 (% class="box infomessage" %) 4776 4776 ((( 4777 -** POST/api/v3/Reports/sensorsWorks**4685 +GET **/api/v3/agroLands/{id}** 4778 4778 ))) 4779 4779 4780 -**Пример запроса:** 4688 +Пример запроса: 4689 +id ~/~/ Идентификатор поля 4781 4781 4782 -{ 4783 - "vehicleIds": [ ~/~/ Список ID объектов 4784 - 0 4785 - ], 4786 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4787 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4788 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4789 -} 4691 +Пример ответа: 4790 4790 4791 -**Пример ответа:** 4792 - 4793 4793 ((( 4794 4794 { 4795 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4695 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4696 + "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4697 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4698 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4699 + "cropRotations": [ ~/~/ Данные по севообороту 4796 4796 { 4797 - "vehicleId": 0, ~/~/ Идентификатор ТС 4798 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4701 + "landId": 0, ~/~/ ID поля 4702 + "landName": "string", ~/~/ Название поля 4703 + "year": 0, ~/~/ Год урожая 4704 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4705 + "cultureName": "string", ~/~/ Название культуры 4706 + "productivity": 0, ~/~/ Урожайность 4707 + "area": 0, ~/~/ Площадь поля, Га 4708 + "total": 0, ~/~/ Валовый сбор 4709 + "productivityFact": 0, ~/~/ Фактическая урожайность 4710 + "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4711 + "totalFact": 0, ~/~/ Фактический валовый сбор 4712 + "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 4713 + "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 4714 + "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 4715 + "isyearplan": true, ~/~/ План года 4716 + "comment": "string" ~/~/ Комментарий 4717 + } 4718 + ], 4719 + "cropVegetation": [ ~/~/ История вегетации поля 4720 + { 4721 + "values": [ ~/~/ Данные вегетации и состояния посева 4799 4799 { 4800 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4801 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4802 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4803 - "name": "string", ~/~/ Наименование оборудования. 4804 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4805 - "totalMileage": 0, ~/~/ Общий пробег. 4806 - "avgSpeed": 0 ~/~/ Средняя скорость. 4723 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4724 + "ndvi": 0 ~/~/ Индекс вегетации 4807 4807 } 4726 + ], 4727 + "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 4728 + { 4729 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4730 + "type": "string", ~/~/ Тип 4731 + "pictureid": "string" ~/~/ Идентификатор ресурса 4732 + } 4733 + ], 4734 + "states": [ ~/~/ Ключевые даты развития поля 4735 + { 4736 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4737 + "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 4738 + } 4808 4808 ] 4809 4809 } 4810 - ] 4741 + ], 4742 + "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 4743 + "counts": { 4744 + "fieldOperations": 0, ~/~/ Количество операций на поле 4745 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4746 + "facts": 0 ~/~/ Счётчик факта 4747 + }, 4748 + "planComment": "string", ~/~/ Комментарий к полю 4749 + "productivity": 0, ~/~/ Урожайность. 4750 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4751 +))) 4752 + 4753 +((( 4754 +((( 4755 + "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 4756 + "year": 0, ~/~/ Год поля 4757 + "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4758 + "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4759 + "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4760 + "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4761 + "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4762 + "id": 0, ~/~/ Идентификатор объекта геозоны 4763 + "name": "string", ~/~/ Название объекта геозоны 4764 + "type": 0, ~/~/ Тип объекта геозоны 4765 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4766 + "fname": "string", ~/~/ Имя файла 4767 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4768 + "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 4769 + "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 4770 + "description": "string", ~/~/ Описание объекта геозоны 4771 + "area": 0, ~/~/ Площадь, м2 4772 + "perimetr": 0, ~/~/ Периметр, м 4773 + "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 4811 4811 } 4812 4812 ))) 4813 4813 4814 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4815 4815 4778 +== **Удалить участок** == 4816 4816 4817 -== **Запрос списка полей** == 4818 - 4819 -(% class="box successmessage" %) 4780 +(% class="box errormessage" %) 4820 4820 ((( 4821 -** POST/api/v3/agroLands/find**4782 +DELETE **/api/v3/agroLands/{id}** 4822 4822 ))) 4823 4823 4824 4824 Пример запроса: 4786 +id ~/~/ Идентификатор поля 4825 4825 4788 +Пример ответа: 4789 + 4826 4826 ((( 4827 -((( 4828 -((( 4829 -{ 4830 - "year": 0, ~/~/ Фильтр по году 4831 - "name": "string", ~/~/ Фильтр по названию 4832 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 4833 -} 4791 +200 ~/~/ Успех 4834 4834 ))) 4835 -))) 4836 4836 4794 +((( 4837 4837 4838 4838 ))) 4839 4839 4840 -Пример ответа: 4841 - 4842 4842 ((( 4843 -[ 4844 - { 4845 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4846 - "year": 0, ~/~/ Год поля 4847 - "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 4848 - "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 4849 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 4850 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4851 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4852 - "counts": { ~/~/ Счётчики с/х поля 4853 - "fieldOperations": 0, ~/~/ Количество операций на поле 4854 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4855 - "facts": 0 ~/~/ Счётчик факта 4856 - }, 4857 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4858 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4859 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4860 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 4861 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4862 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4863 - "planComment": "string", ~/~/ Комментарий к полю 4864 - "productivity": 0, ~/~/ Урожайность. 4865 - "id": 0, ~/~/ Идентификатор объекта геозоны 4866 - "name": "string", ~/~/ Название объекта геозоны 4867 - "type": 0, ~/~/ Тип объекта геозоны 4868 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4869 - "fname": "string", ~/~/ Имя файла 4870 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4871 - "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 4872 - "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 4873 - "description": "string", ~/~/ Описание объекта геозоны 4874 - "area": 0, ~/~/ Площадь, м2 4875 - "perimetr": 0, ~/~/ Периметр, м 4876 - "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 4877 - } 4878 -] 4799 +== **Сохранение участка** == 4879 4879 4880 - 4881 -== **Создание нового поля ** == 4882 - 4883 4883 (% class="box successmessage" %) 4884 4884 ((( 4885 - **POST /api/v3/agroLands**4803 +POST **/api/v3/agroLands** 4886 4886 ))) 4887 4887 4888 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 4889 -X-agent - ID клиента 4890 - 4891 4891 Пример запроса: 4892 4892 4893 4893 ((( 4894 4894 { 4895 4895 "extId": "string", 4896 - "shape": " {\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}",~/~/ Форма поля4897 - "shapeFormat": " geojson", ~/~/ Формат, в котором представлена форма поля4811 + "shape": "string", ~/~/ Форма поля 4812 + "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 4898 4898 "display": "string", ~/~/ Настройки отображения 4899 4899 "year": 0, ~/~/ Год поля 4900 4900 "name": "string", ~/~/ Наименование ... ... @@ -4929,6 +4929,10 @@ 4929 4929 4930 4930 ))) 4931 4931 4847 +((( 4848 + 4849 +))) 4850 + 4932 4932 Пример ответа: 4933 4933 4934 4934 ((( ... ... @@ -5013,141 +5013,18 @@ 5013 5013 "perimetr": 0, ~/~/ Периметр, м 5014 5014 "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5015 5015 } 5016 - 5017 - 5018 5018 ))) 5019 -))) 5020 -))) 5021 5021 5022 -== **Получение поля по id** == 5023 - 5024 -(% class="box infomessage" %) 5025 5025 ((( 5026 -**GET /api/v3/agroLands/{id}** 5027 -))) 5028 - 5029 -Пример запроса: 5030 -id ~/~/ Идентификатор поля 5031 - 5032 -Пример ответа: 5033 - 5034 -((( 5035 -{ 5036 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5037 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5038 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5039 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5040 - "cropRotations": [ ~/~/ Данные по севообороту 5041 - { 5042 - "landId": 0, ~/~/ ID поля 5043 - "landName": "string", ~/~/ Название поля 5044 - "year": 0, ~/~/ Год урожая 5045 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5046 - "cultureName": "string", ~/~/ Название культуры 5047 - "productivity": 0, ~/~/ Урожайность 5048 - "area": 0, ~/~/ Площадь поля, Га 5049 - "total": 0, ~/~/ Валовый сбор 5050 - "productivityFact": 0, ~/~/ Фактическая урожайность 5051 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5052 - "totalFact": 0, ~/~/ Фактический валовый сбор 5053 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5054 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5055 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5056 - "isyearplan": true, ~/~/ План года 5057 - "comment": "string" ~/~/ Комментарий 5058 - } 5059 - ], 5060 - "cropVegetation": [ ~/~/ История вегетации поля 5061 - { 5062 - "values": [ ~/~/ Данные вегетации и состояния посева 5063 - { 5064 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5065 - "ndvi": 0 ~/~/ Индекс вегетации 5066 - } 5067 - ], 5068 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5069 - { 5070 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5071 - "type": "string", ~/~/ Тип 5072 - "pictureid": "string" ~/~/ Идентификатор ресурса 5073 - } 5074 - ], 5075 - "states": [ ~/~/ Ключевые даты развития поля 5076 - { 5077 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5078 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5079 - } 5080 - ] 5081 - } 5082 - ], 5083 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5084 - "counts": { 5085 - "fieldOperations": 0, ~/~/ Количество операций на поле 5086 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5087 - "facts": 0 ~/~/ Счётчик факта 5088 - }, 5089 - "planComment": "string", ~/~/ Комментарий к полю 5090 - "productivity": 0, ~/~/ Урожайность. 5091 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5092 -))) 5093 - 5094 -((( 5095 -((( 5096 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5097 - "year": 0, ~/~/ Год поля 5098 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5099 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5100 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5101 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5102 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5103 - "id": 0, ~/~/ Идентификатор объекта геозоны 5104 - "name": "string", ~/~/ Название объекта геозоны 5105 - "type": 0, ~/~/ Тип объекта геозоны 5106 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5107 - "fname": "string", ~/~/ Имя файла 5108 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5109 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5110 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5111 - "description": "string", ~/~/ Описание объекта геозоны 5112 - "area": 0, ~/~/ Площадь, м2 5113 - "perimetr": 0, ~/~/ Периметр, м 5114 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5115 -} 5116 -))) 5117 - 5118 - 5119 -== **Удаление существующего поля** == 5120 - 5121 -(% class="box errormessage" %) 5122 -((( 5123 -**DELETE /api/v3/agroLands/{id}** 5124 -))) 5125 - 5126 -Пример запроса: 5127 -id ~/~/ Идентификатор поля 5128 - 5129 -Пример ответа: 5130 - 5131 -((( 5132 -200 ~/~/ Успех 5133 -))) 5134 - 5135 -((( 5136 5136 5137 5137 ))) 5138 5138 5139 5139 ((( 5140 -((( 5141 -((( 5142 - 5143 -))) 4942 +== **Изменение участка** == 5144 5144 5145 -((( 5146 -== **Изменение поля** == 5147 - 5148 5148 (% class="box infomessage" %) 5149 5149 ((( 5150 - **PUT /api/v3/agroLands**4946 +PUT **/api/v3/agroLands** 5151 5151 ))) 5152 5152 5153 5153 Пример запроса: ... ... @@ -5283,118 +5283,11 @@ 5283 5283 ))) 5284 5284 ))) 5285 5285 5286 - 5287 -== **Редактирование года урожая ** == 5288 - 5289 -(% class="box successmessage" %) 5290 -((( 5291 -**POST /api/v3/agroLands/updateOpenCloseYear** 5292 -))) 5293 - 5294 -Пример запроса: 5295 - 5296 -((( 5297 -((( 5298 -{ 5299 - "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5300 - 0 5301 - ], 5302 - "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5303 - "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5304 -} 5305 -))) 5306 - 5307 5307 5308 5308 ))) 5309 - 5310 -Пример ответа: 5311 - 5312 -((( 5313 -((( 5314 -{ 5315 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5316 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5317 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5318 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5319 - "cropRotations": [ ~/~/ Данные по севообороту 5320 - { 5321 - "landId": 0, ~/~/ ID поля 5322 - "landName": "string", ~/~/ Название поля 5323 - "year": 0, ~/~/ Год урожая 5324 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5325 - "cultureName": "string", ~/~/ Название культуры 5326 - "productivity": 0, ~/~/ Урожайность 5327 - "area": 0, ~/~/ Площадь поля, Га. 5328 - "total": 0, ~/~/ Валовый сбор 5329 - "productivityFact": 0, ~/~/ Фактическая урожайность 5330 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5331 - "totalFact": 0, ~/~/ Фактический валовый сбор 5332 - "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5333 - "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5334 - "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5335 - "isyearplan": true, ~/~/ 5336 - "comment": "string" ~/~/ Комментарий 5337 - } 5338 - ], 5339 - "cropVegetation": [ ~/~/ История вегетации поля 5340 - { 5341 - "values": [ ~/~/ Данные вегетации и состояния посева 5342 - { 5343 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5344 - "ndvi": 0 ~/~/ Индекс вегетации 5345 - } 5346 - ], 5347 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5348 - { 5349 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5350 - "type": "string", ~/~/ Тип 5351 - "pictureid": "string" ~/~/ Идентификатор ресурса 5352 - } 5353 - ], 5354 - "states": [ ~/~/ Ключевые даты развития поля 5355 - { 5356 - "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5357 - "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5358 - } 5359 - ] 5360 - } 5361 - ], 5362 - "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5363 - "counts": { 5364 - "fieldOperations": 0, ~/~/ Количество операций на поле 5365 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5366 - "facts": 0 ~/~/ Счётчик факта 5367 - }, 5368 - "planComment": "string", ~/~/ Комментарий к полю 5369 - "productivity": 0, ~/~/ Урожайность. 5370 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5371 - "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5372 - "year": 0, ~/~/ Год поля 5373 - "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5374 - "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5375 - "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5376 - "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5377 - "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5378 - "id": 0, ~/~/ Идентификатор объекта геозоны 5379 - "name": "string", ~/~/ Название объекта геозоны 5380 - "type": 0, ~/~/ Тип объекта геозоны 5381 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5382 - "fname": "string", ~/~/ Имя файла 5383 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5384 - "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5385 - "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5386 - "description": "string", ~/~/ Описание объекта геозоны 5387 - "area": 0, ~/~/ Площадь, м2 5388 - "perimetr": 0, ~/~/ ериметр, м 5389 - "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5390 -} 5391 5391 ))) 5392 5392 5393 - 5394 5394 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5395 -))) 5396 -))) 5397 -))) 5398 5398 5399 5399 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5400 5400 ... ... @@ -5401,7 +5401,7 @@ 5401 5401 5402 5402 (% class="box infomessage" %) 5403 5403 ((( 5404 - **GET api/v3/Vehicles/recyclebin/all**5093 +GET api/v3/Vehicles/recyclebin/all 5405 5405 ))) 5406 5406 5407 5407 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5436,11 +5436,11 @@ 5436 5436 ] 5437 5437 5438 5438 5439 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==5128 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5440 5440 5441 5441 (% class="box infomessage" %) 5442 5442 ((( 5443 - **POST**5132 +POST/api/v3/Vehicles/recyclebin/erase 5444 5444 ))) 5445 5445 5446 5446 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5482,7 +5482,7 @@ 5482 5482 5483 5483 (% class="box infomessage" %) 5484 5484 ((( 5485 - **POST**5174 +POST/api/v3/Vehicles/recyclebin/restore 5486 5486 ))) 5487 5487 5488 5488 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5534,409 +5534,7 @@ 5534 5534 ] 5535 5535 5536 5536 5537 -= **Раздел: Журнал заданий ** = 5538 5538 5539 - 5540 -== **Создание задания в Журнале заданий** == 5541 - 5542 -(% class="box infomessage" %) 5543 -((( 5544 -**POST /api/v3/vehicletasks** 5545 -))) 5546 - 5547 -Пример запроса: 5548 - 5549 -((( 5550 -{ 5551 - "vehicleId": 0, ~/~/ Идентификатор ТС 5552 - "description": "string", ~/~/ Описание 5553 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5554 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5555 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5556 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5557 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5558 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5559 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5560 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5561 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5562 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5563 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5564 - "cost": { 5565 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5566 - "Name": "string", ~/~/ Наименование 5567 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5568 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5569 - "Norm": 0 ~/~/ Норма внесения 5570 - }, 5571 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5572 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5573 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5574 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5575 - "deleted": true, ~/~/ Признак удаления 5576 - "extId": "string", 5577 - "GeoIds": [ ~/~/ Cвязанные поля 5578 - 0 5579 - ] 5580 -} 5581 -))) 5582 - 5583 - 5584 -Пример ответа: 5585 - 5586 -{ 5587 - "vehicleId": 0, ~/~/ Идентификатор ТС 5588 - "description": "string", ~/~/ Описание 5589 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5590 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5591 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5592 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5593 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5594 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5595 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5596 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5597 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5598 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5599 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5600 - "cost": { 5601 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5602 - "Name": "string", ~/~/ Наименование 5603 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5604 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5605 - "Norm": 0 ~/~/ Норма внесения 5606 - }, 5607 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5608 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5609 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5610 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5611 - "deleted": true, ~/~/ Признак удаления 5612 - "extId": "string", ~/~/ ExtId 5613 - "GeoIds": [ ~/~/ Связанные поля 5614 - 0 5615 - ] 5616 -} 5617 - 5618 - 5619 -== **Редактирование задания в Журнале заданий** == 5620 - 5621 -(% class="box successmessage" %) 5622 -((( 5623 -**PUT /api/v3/vehicletasks** 5624 -))) 5625 - 5626 -Пример запроса: 5627 - 5628 -((( 5629 -{ 5630 - "vehicleId": 0, ~/~/ Идентификатор ТС 5631 - "description": "string", ~/~/ Описание 5632 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5633 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5634 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5635 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5636 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5637 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5638 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5639 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5640 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5641 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5642 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5643 - "cost": { 5644 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5645 - "Name": "string", ~/~/ Наименование 5646 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5647 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5648 - "Norm": 0 ~/~/ Норма внесения 5649 - }, 5650 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5651 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5652 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5653 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5654 - "deleted": true, ~/~/ Признак удаления 5655 - "extId": "string", ~/~/ ExtId 5656 - "GeoIds": [ ~/~/ Связанные поля 5657 - 0 5658 - ] 5659 -} 5660 -))) 5661 - 5662 - 5663 -Пример ответа: 5664 - 5665 -{ 5666 - "vehicleId": 0, ~/~/ Идентификатор ТС 5667 - "description": "string", ~/~/ Описание 5668 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5669 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5670 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5671 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5672 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5673 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5674 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5675 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5676 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5677 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5678 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5679 - "cost": { 5680 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5681 - "Name": "string", ~/~/ Наименование 5682 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5683 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5684 - "Norm": 0 ~/~/ Норма внесения 5685 - }, 5686 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5687 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5688 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5689 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5690 - "deleted": true, ~/~/ Признак удаления 5691 - "extId": "string", ~/~/ ExtId 5692 - "GeoIds": [ ~/~/ Связанные поля 5693 - 0 5694 - ] 5695 -} 5696 - 5697 - 5698 -== **Удаление задания в Журнале заданий** == 5699 - 5700 -(% class="box warningmessage" %) 5701 -((( 5702 -**DELETE /api/v3/vehicletasks** 5703 -))) 5704 - 5705 -Пример запроса: 5706 - 5707 -((( 5708 -[ 5709 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5710 -] 5711 -))) 5712 - 5713 -((( 5714 - 5715 -))) 5716 - 5717 -Пример ответа: 5718 - 5719 -{ 5720 - "vehicleId": 0, ~/~/ Идентификатор ТС 5721 - "description": "string", ~/~/ Описание 5722 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5723 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5724 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5725 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5726 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5727 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5728 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5729 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5730 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5731 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5732 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5733 - "cost": { 5734 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5735 - "Name": "string", ~/~/ Наименование 5736 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5737 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5738 - "Norm": 0 ~/~/ Норма внесения 5739 - }, 5740 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5741 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5742 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5743 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5744 - "deleted": true, ~/~/ Признак удаления 5745 - "extId": "string", ~/~/ ExtId 5746 - "GeoIds": [ ~/~/ Связанные поля 5747 - 0 5748 - ] 5749 -} 5750 - 5751 - 5752 -== **Получение списка Журнала заданий** == 5753 - 5754 -(% class="box infomessage" %) 5755 -((( 5756 -**POST /api/v3/vehicletasks/getbyperiod** 5757 -))) 5758 - 5759 -Пример запроса: 5760 - 5761 -((( 5762 -{ 5763 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 5764 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 5765 - "TimeZone": 0, ~/~/ Часовой пояс. 5766 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 5767 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 5768 - ], 5769 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 5770 - 0 5771 - ], 5772 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 5773 - 0 5774 - ], 5775 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 5776 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 5777 -} 5778 -))) 5779 - 5780 - 5781 -Пример ответа: 5782 - 5783 -((( 5784 -{ 5785 - "total": 0, ~/~/ Общее количество записей 5786 - "pages": 0, ~/~/ Общее количество страниц 5787 - "currentPage": 0, ~/~/ Текущая страница 5788 - "items": [ ~/~/ Записи 5789 - { 5790 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5791 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 5792 - "name": "string", ~/~/ Название задания. 5793 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 5794 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 5795 - "workKind": "string", ~/~/ Вид работ 5796 - "techOp": "string", ~/~/ Тех. операция 5797 - "trailerModel": "string", ~/~/ Модель агрегата 5798 - "width": "string", ~/~/ Ширина, м 5799 - "speed": "string", ~/~/ Тех. скорость 5800 - "fields": "string", ~/~/ Поля 5801 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 5802 - "vehicles": "string", ~/~/ Объект-модель 5803 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 5804 - "drivers": "string", ~/~/ Водители 5805 - "tmc": "string", ~/~/ ТМЦ 5806 - "client": "string", ~/~/ Клиент 5807 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5808 - "dep": "string", ~/~/ Подразделение 5809 - "geoIds": [ ~/~/ Связанные поля 5810 - 0 5811 - ] 5812 - } 5813 - ] 5814 -} 5815 -))) 5816 - 5817 - 5818 -= **Раздел: Локатор ** = 5819 - 5820 - 5821 -== **Получение списка локаторов, доступных пользователю ** == 5822 - 5823 -(% class="box infomessage" %) 5824 -((( 5825 -**GET /api/v3/locators** 5826 -))) 5827 - 5828 -В заголовках запроса: X-Auth: Токен авторизации 5829 - 5830 - 5831 -Пример ответа: 5832 - 5833 -((( 5834 -[ 5835 - { 5836 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5837 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5838 - "agentName": "string", ~/~/ Наименование агента. 5839 - "isEnabled": true, ~/~/ Активен 5840 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5841 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5842 - "name": "string", ~/~/ Наименование 5843 - "status": 0, ~/~/ 5844 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5845 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5846 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5847 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5848 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5849 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5850 - "url": "string", ~/~/ Ссылка 5851 - "language": 0, ~/~/ Язык. 5852 - "vehiclesCount": 0, ~/~/ Количество объектов. 5853 - "geozonesCount": 0, ~/~/ Количество геозон. 5854 - "fieldsCount": 0 ~/~/ Количество полей. 5855 - } 5856 -] 5857 -))) 5858 - 5859 - 5860 - 5861 -== **Создание локатора** == 5862 - 5863 -(% class="box successmessage" %) 5864 -((( 5865 -**POST /api/v3/locators** 5866 -))) 5867 - 5868 -Пример запроса: 5869 - 5870 -((( 5871 -{ 5872 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5873 - "isEnabled": true, ~/~/ Активность 5874 - "name": "string", ~/~/ Наименование локатора 5875 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 5876 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 5877 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5878 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5879 - "url": "string", ~/~/ Ссылка 5880 - "language": 0 ~/~/ Язык 5881 -} 5882 -))) 5883 - 5884 - 5885 -Пример ответа: 5886 - 5887 -((( 5888 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 5889 -))) 5890 - 5891 - 5892 - 5893 -== **Изменение локатора** == 5894 - 5895 -(% class="box infomessage" %) 5896 -((( 5897 -**PUT /api/v3/locators** 5898 -))) 5899 - 5900 -Пример запроса: 5901 - 5902 -((( 5903 -{ 5904 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5905 - "isEnabled": true, ~/~/ Активность 5906 - "name": "string", ~/~/ Наименование 5907 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 5908 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 5909 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5910 - "autoProlongation": true, ~/~/ Автопродление срока действия 5911 - "url": "string", ~/~/ Ссылка 5912 - "language": 0 ~/~/ Язык 5913 -} 5914 -))) 5915 - 5916 - 5917 -Пример ответа: 5918 - 5919 -200 ~/~/ Success 5920 - 5921 - 5922 -== **Удалить локатор** == 5923 - 5924 -(% class="box warningmessage" %) 5925 -((( 5926 -**DELETE /api/v3/locators** 5927 -))) 5928 - 5929 -Пример запроса: 5930 - 5931 -((( 5932 -[ 5933 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 5934 -] 5935 -))) 5936 - 5937 - 5938 - 5939 - 5940 5940 (% class="box" lang="en-US" style="text-align: center;" %) 5941 5941 ((( 5942 5942 (% 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]] **