<
From version < 196.1 >
edited by Андрей Калиновский
on 2024/12/20 14:28
To version < 213.1 >
edited by Андрей Калиновский
on 2025/03/19 13:51
>
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -2,10 +2,6 @@
2 2  (((
3 3  (% class="box warningmessage" %)
4 4  (((
5 -
6 -
7 -
8 -
9 9  (% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно
10 10  просим вас соблюдать несколько простых правил при использовании API-команд:##
11 11  )))
... ... @@ -15,7 +15,14 @@
15 15  
16 16  В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов.
17 17  
14 +(% class="box infomessage" %)
15 +(((
16 +**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в пользовательских настройках.
17 +)))
18 18  
19 +При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему.
20 +
21 +
19 19  **Содержание страницы:**
20 20  )))
21 21  
... ... @@ -1025,6 +1025,17 @@
1025 1025  
1026 1026  (((
1027 1027  {
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 +
1028 1028   "vehicleId": "", ~/~/ ID объекта
1029 1029   "name": "", ~/~/ Имя объекта
1030 1030   "imei": "", ~/~/ IMEI объекта
... ... @@ -1119,6 +1119,7 @@
1119 1119   ],
1120 1120   "showInTooltip": true, ~/~/ Отображать в подсказке
1121 1121   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1136 + "color": "string", ~/~/ Код цвета датчиков
1122 1122   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1123 1123   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1124 1124   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1176,11 +1176,21 @@
1176 1176   "date": "2023-05-22T09:57:39.562Z",
1177 1177   "description": "string",
1178 1178   "additionalInfo": "string"
1179 - }
1180 - ]
1194 +
1195 +(((
1181 1181  }
1197 + ],
1198 + "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
1199 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов.
1182 1182  )))
1183 1183  
1202 +(((
1203 + ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1204 +}
1205 +
1206 +)))
1207 +)))
1208 +
1184 1184  (% style="text-align:left" %)
1185 1185  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
1186 1186  
... ... @@ -1273,7 +1273,13 @@
1273 1273  
1274 1274  (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON
1275 1275  
1276 -(% style="color:#000000" %){(%%)
1301 +(% style="color:#000000" %){
1302 +
1303 +
1304 +(((
1305 + "vehicleId": 0, ~/~/ ID ТС
1306 +)))
1307 +
1277 1277   "parentId": "" , ~/~/ ID клиента
1278 1278   "name": "" , ~/~/ имя ТС
1279 1279   "imei": "" , ~/~/ IMEI
... ... @@ -1366,6 +1366,7 @@
1366 1366   ],
1367 1367   "showInTooltip": true, ~/~/ Отображать в подсказке
1368 1368   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1400 + "color": "string", ~/~/ код цвета датчиков
1369 1369   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1370 1370   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1371 1371   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1415,10 +1415,19 @@
1415 1415   "forClient": true, ~/~/ Отобразить произвольное поле у клиента
1416 1416   "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
1417 1417   "forReport": true ~/~/ Отобразить произвольное поле в отчете
1418 - }
1419 - ]
1450 +
1451 +(((
1452 + }
1453 + ],
1454 + "motohoursCalcMethod": 0 ~/~/  Вид расчета моточасов.
1455 +)))
1456 +
1457 +(((
1458 + ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1420 1420  }
1460 +)))
1421 1421  
1462 +
1422 1422  (% style="color:#000000" %)Ответ:
1423 1423  
1424 1424  
... ... @@ -1527,6 +1527,7 @@
1527 1527   ],
1528 1528   "showInTooltip": true, ~/~/ Отображение в подсказке
1529 1529   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1571 + "color": "string", ~/~/ код цвета датчиков
1530 1530   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1531 1531   "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
1532 1532   "agrFunction": 0,  ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION
... ... @@ -1563,7 +1563,7 @@
1563 1563   "forReport": true ~/~/ Отобразить произвольное поле в отчете
1564 1564   }
1565 1565   ],
1566 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor
1608 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
1567 1567  }
1568 1568  )))
1569 1569  )))
... ... @@ -1869,9 +1869,19 @@
1869 1869  
1870 1870  "drivers": [ ~/~/ Водители
1871 1871   {
1872 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
1873 - "isDefault": true
1874 - }
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 + } 
1875 1875   ],
1876 1876   "commandTemplates": [ ~/~/ Шаблон команды
1877 1877   {
... ... @@ -1907,6 +1907,11 @@
1907 1907   ],
1908 1908   "showInTooltip": true, ~/~/ Отображать в подсказке
1909 1909   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1962 +
1963 +(((
1964 + "color": "string",** ~/~/ **Цвет датчика
1965 +)))
1966 +
1910 1910   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1911 1911   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1912 1912   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1953,7 +1953,12 @@
1953 1953   "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
1954 1954   "forReport": true ~/~/ Отобразить произвольное поле в отчете
1955 1955   }
1956 - ]
2013 +
2014 +(((
2015 + ],
2016 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
2017 +)))
2018 +
1957 1957  }
1958 1958  
1959 1959  
... ... @@ -2091,6 +2091,11 @@
2091 2091   ],
2092 2092   "showInTooltip": true, ~/~/ Отображение в подсказке
2093 2093   "showLastValid": true, ~/~/ Отображать последнее валидное значение
2156 +
2157 +(((
2158 + "color": "string", ~/~/ цвет уведомлений
2159 +)))
2160 +
2094 2094   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
2095 2095   "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
2096 2096   "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION 
... ... @@ -2407,6 +2407,8 @@
2407 2407   "motohours": 0, ~/~/ Моточасы за период, секунды
2408 2408   "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды
2409 2409   "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды
2477 + "idlingTime": 0 ~/~/  Холостой ход за период, секунд
2478 +
2410 2410   }
2411 2411   ]
2412 2412   }
... ... @@ -4387,7 +4387,7 @@
4387 4387  
4388 4388  (% class="box infomessage" %)
4389 4389  (((
4390 -POST /api/v3/fuelcards/transactions
4459 +**POST /api/v3/fuelcards/transactions**
4391 4391  )))
4392 4392  
4393 4393  Метод запроса: POST
... ... @@ -4425,7 +4425,32 @@
4425 4425   "address": "string" ~/~/ Адрес АЗС
4426 4426   }
4427 4427  
4497 +== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) ==
4428 4428  
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 +
4429 4429  = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
4430 4430  
4431 4431  
... ... @@ -4604,7 +4604,7 @@
4604 4604  
4605 4605  (% class="box infomessage" %)
4606 4606  (((
4607 -POST **/api/v3/Reports/harvesterUnloading**
4701 +**POST /api/v3/Reports/harvesterUnloading**
4608 4608  )))
4609 4609  
4610 4610  Пример запроса:
... ... @@ -4676,140 +4676,131 @@
4676 4676  ]
4677 4677  
4678 4678  
4679 -= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
4773 +== **Отчет трек-датчики** ==
4680 4680  
4681 -== **Получение участка по id** ==
4682 -
4683 4683  (% class="box infomessage" %)
4684 4684  (((
4685 -GET **/api/v3/agroLands/{id}**
4777 +**POST /api/v3/Reports/sensorsWorks**
4686 4686  )))
4687 4687  
4688 -Пример запроса:
4689 -id  ~/~/ Идентификатор поля
4780 +**Пример запроса:**
4690 4690  
4691 -Пример ответа:
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 +}
4692 4692  
4791 +**Пример ответа:**
4792 +
4693 4693  (((
4694 4694  {
4695 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
4696 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
4697 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
4698 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года
4699 - "cropRotations": [ ~/~/ Данные по севообороту
4795 + "vehicleSensorWorks": [  ~/~/ Интервалы работы оборудования для конкретного ТС
4700 4700   {
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": [ ~/~/ Данные вегетации и состояния посева
4797 + "vehicleId": 0, ~/~/ Идентификатор ТС
4798 + "sensorWorks": [ ~/~/ Интервалы работы оборудования. 
4722 4722   {
4723 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
4724 - "ndvi": 0 ~/~/ Индекс вегетации
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 ~/~/ Средняя скорость.
4725 4725   }
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 - }
4739 4739   ]
4740 4740   }
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" ~/~/ Дата создания в бд
4810 + ]
4774 4774  }
4775 4775  )))
4776 4776  
4814 += (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
4777 4777  
4778 -== **Удалить участок** ==
4779 4779  
4780 -(% class="box errormessage" %)
4817 +== **Запрос списка полей** ==
4818 +
4819 +(% class="box successmessage" %)
4781 4781  (((
4782 -DELETE **/api/v3/agroLands/{id}**
4821 +**POST /api/v3/agroLands/find**
4783 4783  )))
4784 4784  
4785 4785  Пример запроса:
4786 -id  ~/~/ Идентификатор поля
4787 4787  
4788 -Пример ответа:
4789 -
4790 4790  (((
4791 -200 ~/~/ Успех
4827 +(((
4828 +(((
4829 +{
4830 + "year": 0, ~/~/ Фильтр по году
4831 + "name": "string", ~/~/ Фильтр по названию
4832 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению
4833 +}
4792 4792  )))
4835 +)))
4793 4793  
4794 -(((
4795 4795  
4796 4796  )))
4797 4797  
4840 +Пример ответа:
4841 +
4798 4798  (((
4799 -== **Сохранение участка** ==
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 +]
4800 4800  
4880 +
4881 +== **Создание нового поля ** ==
4882 +
4801 4801  (% class="box successmessage" %)
4802 4802  (((
4803 -POST **/api/v3/agroLands**
4885 +**POST /api/v3/agroLands**
4804 4804  )))
4805 4805  
4888 +Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 
4889 +X-agent  - ID клиента
4890 +
4806 4806  Пример запроса:
4807 4807  
4808 4808  (((
4809 4809  {
4810 4810   "extId": "string", 
4811 - "shape": "string", ~/~/ Форма поля
4812 - "shapeFormat": "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", ~/~/ Формат, в котором представлена форма поля
4813 4813   "display": "string", ~/~/ Настройки отображения
4814 4814   "year": 0, ~/~/ Год поля
4815 4815   "name": "string", ~/~/ Наименование
... ... @@ -4844,10 +4844,6 @@
4844 4844  
4845 4845  )))
4846 4846  
4847 -(((
4848 -
4849 -)))
4850 -
4851 4851  Пример ответа:
4852 4852  
4853 4853  (((
... ... @@ -4932,18 +4932,141 @@
4932 4932   "perimetr": 0, ~/~/ Периметр, м
4933 4933   "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд
4934 4934  }
5016 +
5017 +
4935 4935  )))
5019 +)))
5020 +)))
4936 4936  
5022 +== **Получение поля по id** ==
5023 +
5024 +(% class="box infomessage" %)
4937 4937  (((
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 +(((
4938 4938  
4939 4939  )))
4940 4940  
4941 4941  (((
4942 -== **Изменение участка** ==
5140 +(((
5141 +(((
5142 +
5143 +)))
4943 4943  
5145 +(((
5146 +== **Изменение поля** ==
5147 +
4944 4944  (% class="box infomessage" %)
4945 4945  (((
4946 -PUT **/api/v3/agroLands**
5150 +**PUT /api/v3/agroLands**
4947 4947  )))
4948 4948  
4949 4949  Пример запроса:
... ... @@ -5079,11 +5079,118 @@
5079 5079  )))
5080 5080  )))
5081 5081  
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 +
5082 5082  
5083 5083  )))
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 +}
5084 5084  )))
5085 5085  
5393 +
5086 5086  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
5395 +)))
5396 +)))
5397 +)))
5087 5087  
5088 5088  == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
5089 5089  
... ... @@ -5090,7 +5090,7 @@
5090 5090  
5091 5091  (% class="box infomessage" %)
5092 5092  (((
5093 -GET api/v3/Vehicles/recyclebin/all
5404 +**GET api/v3/Vehicles/recyclebin/all**
5094 5094  )))
5095 5095  
5096 5096  Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
... ... @@ -5125,11 +5125,11 @@
5125 5125  ]
5126 5126  
5127 5127  
5128 -(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**
5439 +== (% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==
5129 5129  
5130 5130  (% class="box infomessage" %)
5131 5131  (((
5132 -POST/api/v3/Vehicles/recyclebin/erase
5443 +**POST api/v3/Vehicles/recyclebin/erase**
5133 5133  )))
5134 5134  
5135 5135  В заголовках запроса: X-Auth: Токен авторизации
... ... @@ -5171,7 +5171,7 @@
5171 5171  
5172 5172  (% class="box infomessage" %)
5173 5173  (((
5174 -POST/api/v3/Vehicles/recyclebin/restore
5485 +**POST api/v3/Vehicles/recyclebin/restore**
5175 5175  )))
5176 5176  
5177 5177  В заголовках запроса: X-Auth: Токен авторизации
... ... @@ -5223,7 +5223,409 @@
5223 5223  ]
5224 5224  
5225 5225  
5537 += **Раздел: Журнал заданий ** =
5226 5226  
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 +
5227 5227  (% class="box" lang="en-US" style="text-align: center;" %)
5228 5228  (((
5229 5229  (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **

Меню

ГЛОНАССSoft wiki - 2024 г.