Changes for page Методы API для работы с ГЛОНАССSoft

Last modified by Андрей Калиновский on 2025/01/28 12:59

From version < 181.1 >

edited by Андрей Калиновский
on 2024/11/18 16:39

To version < 206.2 >

edited by Андрей Калиновский
on 2025/01/28 12:58

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -1,5 +1,17 @@
  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
  (((
++(% class="box warningmessage" %)
++(((
++(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно
++просим вас соблюдать несколько простых правил при использовании API-команд:##
++)))
++
++* Формировать не более 3 отчётов одновременно.
++* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50.
++
++В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов.
++
++
  **Содержание страницы:**
  )))
@@ -1009,6 +1009,17 @@
  (((
  {
++
++(((
++   "showLineTrackWhenNoCoords": true,  ~/~/ Обозначать трек при отсутствии координат.
++   "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства
++)))
++
++(((
++                                      ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink
++   "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC
++)))
++
      "vehicleId": "", ~/~/ ID объекта
      "name": "", ~/~/ Имя объекта
      "imei": "", ~/~/ IMEI объекта
@@ -1103,6 +1103,7 @@
        ],
        "showInTooltip": true, ~/~/ Отображать в подсказке
        "showLastValid": true, ~/~/ Отображать последнее валидное значение
++      "color": "string", ~/~/ Код цвета датчиков
        "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
        "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
        "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
@@ -1160,11 +1160,21 @@
        "date": "2023-05-22T09:57:39.562Z",
        "description": "string",
        "additionalInfo": "string"
--    }
--  ]
++
++(((
  }
++  ],
++  "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах
++  "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов.
  )))
++(((
++                                               ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
++}
++
++)))
++)))
++
  (% style="text-align:left" %)
  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
@@ -1182,13 +1182,15 @@
  Команда для отправки на тс.
  {
--"id": "",  ~/~/идентификатор произвольного поля
--"command": "", ~/~/  Текст команды
--"retries": "",  ~/~/ Количество попыток
--"idTemplate": "" ~/~/ ID шаблона команды
++"id": "",  ~/~/идентификатор объекта (он же идентификатор ТС: vehicleId)
++"command": "", ~/~/  Текст отправляемой команды
++"retries": "",  ~/~/ Количество попыток отправки на терминал
++"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов).
  }
++В ответ получаем cmdid
++
  == **Получить ответ на отправленную на ТС команду** ==
  (% class="box infomessage" %)
@@ -1196,13 +1196,13 @@
  (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer**
  )))
--Идентификатор команды: cmdid
++Идентификатор команды: cmdId
  Запрос от терминала на ответ команды
  Пример ответ от терминала:
--ID= "" ~/~/ идентификатор произвольного поля
++ID= "" ~/~/ идентификатор объекта
  Soft="" ~/~/ версия софта
  GPS=4 ~/~/ тип трекера
  Time=11:05:43 28.06.24 ~/~/ время запроса
@@ -1255,7 +1255,13 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON
--(% style="color:#000000" %){(%%)
++(% style="color:#000000" %){
++
++
++(((
++    "vehicleId": 0, ~/~/ ID ТС
++)))
++
      "parentId": "" ,  ~/~/ ID клиента
      "name": "" ,  ~/~/ имя ТС
      "imei": "" ,  ~/~/ IMEI
@@ -1348,6 +1348,7 @@
        ],
        "showInTooltip": true, ~/~/ Отображать в подсказке
        "showLastValid": true, ~/~/ Отображать последнее валидное значение
++      "color": "string", ~/~/ код цвета датчиков
        "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
        "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
        "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
@@ -1397,10 +1397,19 @@
        "forClient": true, ~/~/ Отобразить произвольное поле у клиента
        "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
        "forReport": true ~/~/ Отобразить произвольное поле в отчете
--    }
--  ]
++
++(((
++ }
++  ],
++  "motohoursCalcMethod": 0 ~/~/  Вид расчета моточасов.
++)))
++
++(((
++                                              ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
  }
++)))
++
  (% style="color:#000000" %)Ответ:
@@ -1509,6 +1509,7 @@
        ],
        "showInTooltip": true, ~/~/ Отображение в подсказке
        "showLastValid": true, ~/~/ Отображать последнее валидное значение
++      "color": "string", ~/~/ код цвета датчиков
        "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
        "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
        "agrFunction": 0,  ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION
@@ -1545,7 +1545,7 @@
        "forReport": true ~/~/ Отобразить произвольное поле в отчете
      }
    ],
--  "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor
++  "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
  }
  )))
  )))
@@ -1557,6 +1557,78 @@
  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
++
++== **Импортировать историю ТС (Асинхронный запрос)** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
++)))
++
++Метод запроса: **POST**
++
++URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
++
++Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
++
++
++Ответ:
++
++{
++
++  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
++
++  "Status": 0, ~/~/ Перечисление состояний выполнения запроса
++
++~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
++
++  "Message": "string", ~/~/ Информация о выполнении запроса
++
++  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
++
++  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
++
++  "Data": "string" ~/~/ Данные
++
++}
++
++
++== **Возвращает статус асинхронного запроса импорта истории ТС** ==
++
++(% class="box infomessage" %)
++(((
++**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
++)))
++
++Метод запроса: **GET**
++
++URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
++
++Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
++
++
++Ответ:
++
++{
++
++  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
++
++  "Status": 0, ~/~/ Перечисление состояний выполения запроса
++~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
++
++  "Message": "string", ~/~/ Информация о выполнении запроса
++
++  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
++
++~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
++
++  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
++
++  "Data": "string" ~/~/ Данные
++
++}
++
++
  == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) ==
  (% class="box infomessage" %)
@@ -1598,9 +1598,12 @@
      "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально)
      "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально)
      "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально)
--    "parentId": null, ~/~/ ID клиента (Guid, опционально)
--    "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)
--    "customFields": null ~/~/ значение любого из произвольных полей ТС
++     "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально)
++      "unitName": "string",  ~/~/ Название подразделения (опционально)
++    "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально)
++    "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально)
++    "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально)
++     "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные
  }
  (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
@@ -1607,8 +1607,15 @@
  (% style="color:#000000" %)Ответ:
--(% style="color:#000000" %){
--    "vehicleId": "" ~/~/ идентификатор объекта
++(% style="color:#000000" %)[
++{
++
++(((
++    "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC
++)))
++
++(((
++(% style="color:#000000" %)    "vehicleId": "" ~/~/ идентификатор объекта
      "name": "" ~/~/ наименование объекта
      "imei": "" ~/~/ IMEI объекта
      "deviceTypeId": "" ~/~/ идентификатор типа устройства
@@ -1633,9 +1633,21 @@
                  "forClient": true, ~/~/ право на отображение у клиента
                  "forTooltip": false, ~/~/ право на отображение в подсказке
                  "forReport": false ~/~/ право на отображение в отчетах
--            }(%%)
--(% style="color:#000000" %)}
++)))
++(((
++      }
++    ],
++    "vehicleGroups": [  ~/~/ Группы ТС
++      {
++        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности
++        "name": "string" ~/~/ Наименование группы ТС
++      }
++    ]
++  }
++]
++)))
++
  (% style="color:#000000" %)          Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.
  == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) ==
@@ -1757,9 +1757,19 @@
  "drivers": [ ~/~/ Водители
      {
--      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
--      "isDefault": true
--    }
++
++(((
++      "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор объекта.
++      "inputNumber": 0, ~/~/ № входа.
++      "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения.
++      "comment": "string", ~/~/ Комментарий.
++      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения.
++      "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя.
++      "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения.
++      "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения.
++)))
++
++    }
    ],
    "commandTemplates": [ ~/~/ Шаблон команды
      {
@@ -1795,6 +1795,11 @@
        ],
        "showInTooltip": true, ~/~/ Отображать в подсказке
        "showLastValid": true, ~/~/ Отображать последнее валидное значение
++
++(((
++      "color": "string",** ~/~/ **Цвет датчика
++)))
++
        "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
        "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
        "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
@@ -1841,7 +1841,12 @@
        "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)
        "forReport": true ~/~/ Отобразить произвольное поле в отчете
      }
--  ]
++
++(((
++  ],
++  "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов
++)))
++
  }
@@ -1979,6 +1979,11 @@
        ],
        "showInTooltip": true, ~/~/ Отображение в подсказке
        "showLastValid": true, ~/~/ Отображать последнее валидное значение
++
++(((
++      "color": "string", ~/~/ цвет уведомлений
++)))
++
        "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
        "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
        "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION
@@ -4275,7 +4275,7 @@
  (% class="box infomessage" %)
  (((
--POST /api/v3/fuelcards/transactions
++**POST /api/v3/fuelcards/transactions**
  )))
  Метод запроса: POST
@@ -4286,34 +4286,59 @@
  Параметры в теле запроса (JSON):
  {
--  "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода
--  "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода
++  "startDate": "2024-04-11T10:32:02.395Z", ~/~/ Начало периода
++  "endDate": "2024-04-11T10:32:02.395Z", ~/~/ Конец периода
    "ids": [
--    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт
++    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификаторы топливных карт
    ],
--  "timezone": 0 ~/~/Таймзона
++  "timezone": 0 ~/~/ Часовой пояс
  }
  Ответ:
    {
--    "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции
--    "driver": "string", ~/~/Водители, привязанные к ТК
--    "object": "string", ~/~/Наименование ТС
--    "amount": 0, ~/~/Количество топлива
--    "amountDut": 0, ~/~/Количество по ДУТ
--    "amountDiff": 0, ~/~/Разница, л
--    "amountDiffPerc": 0, ~/~/Разница, %
--    "summa": 0, ~/~/Стоимость, руб
--    "serviceName": "string", ~/~/Тип топлива
--    "price": 0, ~/~/Цена за литр, руб
--    "cardName": "string", ~/~/Наименование ТК
--    "cardNum": "string", ~/~/Номер ТК
--    "operator": "string", ~/~/Оператор ТК
--    "address": "string" ~/~/Адрес АЗС
++    "date": "2024-04-11T10:41:02.265Z", ~/~/ Дата и время транзакции
++    "driver": "string", ~/~/ Водители, привязанные к ТК
++    "object": "string", ~/~/ Наименование ТС
++    "amount": 0, ~/~/ Количество топлива
++    "amountDut": 0, ~/~/ Количество по ДУТ
++    "amountDiff": 0, ~/~/ Разница, л
++    "amountDiffPerc": 0, ~/~/ Разница, %
++    "summa": 0, ~/~/ Стоимость, руб
++    "serviceName": "string", ~/~/ Тип топлива
++    "price": 0, ~/~/ Цена за литр, руб
++    "cardName": "string", ~/~/ Наименование ТК
++    "cardNum": "string", ~/~/ Номер ТК
++    "operator": "string", ~/~/ Оператор ТК
++    "address": "string" ~/~/ Адрес АЗС
    }
++== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) ==
++(% class="box infomessage" %)
++(((
++**GET /api/v3/fuelcards**
++)))
++
++Метод запроса: GET
++
++URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента
++
++Ответ:
++
++[
++  {
++    "Name": "string", ~/~/ Определяет наименование карты.
++    "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора.
++    "Number": "string", ~/~/ Определяет № карты.
++    "Enabled": true, ~/~/ Определяет признак активности карты.
++    "Description": "string", ~/~/ Определяет описание карты.
++    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты
++    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
++    "deleted": true ~/~/ Признак удаления
++  }
++]
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
@@ -4324,28 +4324,28 @@
  **GET ** **/api/v3/retranslations/{id}**
  )))
--Идентификатор запроса: ID
++id - Идентификатор ретранслятора
  Пример ответа:
  {
--"description": "",  ~/~/ Определяет описание
--"subscriberId": "",  ~/~/ Подписчик
--"protocolType": 0,  ~/~/ Тип протокола
--"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
--"address": "string",  ~/~/ Адрес события
--"objects": [    ~/~/Объекты для ретрансляции
++"description": "",  ~/~/ Поле описания ретранслятора
++"subscriberId": "",  ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
++"protocolType": 0,  ~/~/ Тип протокола ретрансляции
++"isEnabled": true,  ~/~/ Признак включения ретранслятора, Включен, true - включен, false - отключен
++"address": "string",  ~/~/ Адрес и порт принимающего сервера
++"objects": [    ~/~/ Объекты для ретрансляции
  {
  "id": "",  ~/~/ Идентификатор объекта ретрансляции
  "name": "",   ~/~/ Наименование объекта ретрансляции
--"imei": "",     ~/~/ IMEI объекта
--"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++"imei": "",     ~/~/ IMEI объекта  ретрансляции
++"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
  }
    ],
--"id": "",  ~/~/ идентификатор пользователя
--"parentId": "",  ~/~/Guid родителя
--"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен
++"id": "",  ~/~/ Идентификатор ретранслятора
++"parentId": "",  ~/~/ Идентификатор родителя (вышестоящего клиента)
++"deleted": "" ~/~/ Признак удаления ретранслятора: true - включен, false - отключен
  }
@@ -4356,7 +4356,7 @@
  **DELETE** **/api/v3/retranslations/{id}**
  )))
--Параметр запроса: ID
++id - Идентификатор ретранслятора
  == **Создание ретранслятора** ==
@@ -4369,16 +4369,16 @@
  Запрос:
  {
--"description": "",  ~/~/ Описание
--"subscriberId": "",  ~/~/ Подписчик
--"protocolType": 0,  ~/~/ Тип протокола
--"address": "",  ~/~/ Адрес ретрансляции
--"isEnabled": "",  ~/~/ признак включения, Включен, true - включен, false - отключен
++"description": "",  ~/~/ Поле описания ретранслятора
++"subscriberId": "",  ~/~/ Идентификатор подписчика
++"protocolType": 0,  ~/~/ Тип протокола ретрансляции
++"address": "",  ~/~/ Адрес и порт принимающего сервера
++"isEnabled": "",  ~/~/ Признак включения ретранслятора, true - включен, false - отключен
  "objects": [    ~/~/Объекты для ретрансляции
  {
--"id": "",  ~/~/ идентификатор пользователя
--"imei": "",     ~/~/IMEI объекта
--"isEnabled":  ""  ~/~/ признак включения, Включен, true - включен, false - отключен
++"id": "",  ~/~/ Идентификатор ретранслятора
++"imei": "",     ~/~/ IMEI объекта ретрансляции
++"isEnabled":  ""  ~/~/ Признак включения объекта  ретрансляции: true - включен, false - отключен
  }
    ]
  }
@@ -4387,22 +4387,22 @@
  Ответ:
  {
--"description": "string",  ~/~/ Определяет описание
--"subscriberId": "",  ~/~/ идентификатор запроса
--"protocolType": 0,   ~/~/ Тип протокола
--"isEnabled":  "",  ~/~/ признак включения, Включен, true - включен, false - отключен
--"address": "",  ~/~/ Адрес события
--"objects": [    ~/~/Объекты для ретрансляции
++"description": "",  ~/~/ Поле описания ретранслятора
++"subscriberId": "",  ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
++"protocolType": 0,  ~/~/ Тип протокола ретрансляции
++"isEnabled": true,  ~/~/ Признак включения ретранслятора: true - включен, false - отключен
++"address": "string",  ~/~/ Адрес и порт принимающего сервера
++"objects": [     ~/~/ Объекты для ретрансляции
  {
--"id": "",     ~/~/ идентификатор пользователя
--"name": "string",     ~/~/ Название уведомления
--"imei": "string",    ~/~/IMEI объекта
--"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++"id": "",    ~/~/ Идентификатор объекта ретрансляции
++"name": "string",  ~/~/ Наименование объекта ретрансляции
++"imei": "",      ~/~/ IMEI объекта ретрансляции
++"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
  }
--  ],
--"id": "",  ~/~/ идентификатор пользователя
--"parentId": "",  ~/~/ Guid идентификатор родителя
--"deleted": true ~/~/ Признак удаления
++  ],
++"id": "",  ~/~/ Идентификатор ретранслятора
++"parentId": "",  ~/~/ Идентификатор родителя (вышестоящего клиента)
++"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
  }
@@ -4416,18 +4416,18 @@
  Пример запроса:
  {
--"id": "",  ~/~/ идентификатор пользователя
--"description": "string",  ~/~/ Определяет описание
--"subscriberId": "",  ~/~/ идентификатор запроса
--"protocolType": 0,  ~/~/ Тип протокола
--"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
--"address": "string",   ~/~/ Адрес события
--"objects":  ~/~/Объекты для ретрансляции
++"id": "",  ~/~/ Идентификатор ретранслятора
++"description": "string",  ~/~/ Поле описания ретранслятора
++"subscriberId": "",  ~/~/ Идентификатор подписчика
++"protocolType": 0,  ~/~/ Тип протокола ретрансляции
++"isEnabled": true,  ~/~/ Признак включения ретранслятора: true - включен, false - отключен
++"address": "string",   ~/~/ Адрес и порт принимающего сервера
++"objects":  ~/~/ Объекты для ретрансляции
  [
  {
--"id": "",  ~/~/ идентификатор пользователя
--"imei": "",       ~/~/IMEI объекта
--"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++"id": "",  ~/~/ Идентификатор объекта ретрансляции
++"imei": "",       ~/~/ IMEI объекта  ретрансляции
++"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
  }
    ]
  }
@@ -4436,22 +4436,22 @@
  Пример ответа:
  {
--"description": "",  ~/~/ Определяет описание
--"subscriberId": "",  ~/~/ идентификатор запроса
--"protocolType": 0,  ~/~/ Тип протокола
--"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
--"address": "string",  ~/~/ Адрес события
--"objects": [     ~/~/Объекты для ретрансляции
++"description": "",  ~/~/ Поле описания ретранслятора
++"subscriberId": "",  ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
++"protocolType": 0,  ~/~/ Тип протокола ретрансляции
++"isEnabled": true,  ~/~/ Признак включения ретранслятора: true - включен, false - отключен
++"address": "string",  ~/~/ Адрес и порт принимающего сервера
++"objects": [     ~/~/ Объекты для ретрансляции
  {
--"id": "",    ~/~/ идентификатор пользователя
--"name": "string",  ~/~/ Название уведомления
--"imei": "",      ~/~/IMEI объекта
--"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++"id": "",    ~/~/ Идентификатор объекта ретрансляции
++"name": "string",  ~/~/ Наименование объекта ретрансляции
++"imei": "",      ~/~/ IMEI объекта ретрансляции
++"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
  }
    ],
--"id": "",  ~/~/ идентификатор пользователя
--"parentId": "",  ~/~/ Guid идентификатор родителя
--"deleted": true ~/~/ Признак удаления
++"id": "",  ~/~/ Идентификатор ретранслятора
++"parentId": "",  ~/~/ Идентификатор родителя (вышестоящего клиента)
++"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
  }
@@ -4465,9 +4465,9 @@
  Пример запроса:
  {
--"id": "",  ~/~/ идентификатор пользователя
--"search": "string",  ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
--"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные.
++"id": "",  ~/~/ Идентификатор ретранслятора
++"search": "string",  ~/~/ Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
++"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (обязательный параметр).
  }
  Ответ:
@@ -4474,14 +4474,14 @@
  [
  {
--"description": "",    ~/~/ Определяет описание
--"subscriberId": "",    ~/~/ идентификатор запроса
--"protocolType": 0,     ~/~/ Тип протокола
--"isEnabled": true,    ~/~/ признак включения, Включен, true - включен, false - отключен
--"address": "string",    ~/~/ Адрес события
--"id": "",    ~/~/ идентификатор пользователя
--"parentId": "",    ~/~/ Guid идентификатор родителя
--"deleted": true   ~/~/ Признак удаления
++"description": "",    ~/~/ Поле описания ретранслятора
++"subscriberId": "",    ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
++"protocolType": 0,     ~/~/ Тип протокола ретрансляции
++"isEnabled": true,    ~/~/ Признак включения ретранслятора: true - включен, false - отключен
++"address": "string",    ~/~/ Адрес и порт принимающего сервера
++"id": "",    ~/~/ Идентификатор ретранслятора
++"parentId": "",    ~/~/ Идентификатор родителя (вышестоящего клиента)
++"deleted": true   ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
  }
  ]
@@ -4492,7 +4492,7 @@
  (% class="box infomessage" %)
  (((
--POST **/api/v3/Reports/harvesterUnloading**
++**POST /api/v3/Reports/harvesterUnloading**
  )))
  Пример запроса:
@@ -4564,14 +4564,594 @@
  ]
--= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
++= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
++
++== **Запрос списка полей** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/agroLands/find**
++)))
++
++Пример запроса:
++
++(((
++(((
++(((
++{
++  "year": 0, ~/~/ Фильтр по году
++  "name": "string", ~/~/ Фильтр по названию
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению
++}
++)))
++)))
++
++
++)))
++
++Пример ответа:
++
++(((
++[
++  {
++    "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
++    "year": 0, ~/~/ Год поля
++    "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая
++    "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая
++    "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
++    "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
++    "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
++    "counts": { ~/~/ Счётчики с/х поля
++      "fieldOperations": 0, ~/~/ Количество операций на поле
++      "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
++      "facts": 0 ~/~/ Счётчик факта
++    },
++    "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++    "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++    "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++    "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++    "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
++    "sourceId": 0, ~/~/ Ссылка на участок прошлого года
++    "planComment": "string", ~/~/ Комментарий к полю
++    "productivity": 0, ~/~/ Урожайность.
++    "id": 0, ~/~/ Идентификатор объекта геозоны
++    "name": "string", ~/~/ Название объекта геозоны
++    "type": 0, ~/~/ Тип объекта геозоны
++    "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++    "fname": "string", ~/~/ Имя файла
++    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
++    "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны
++    "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны
++    "description": "string", ~/~/ Описание объекта геозоны
++    "area": 0, ~/~/ Площадь, м2
++    "perimetr": 0, ~/~/ Периметр, м
++    "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд
++  }
++]
++
++
++== **Создание нового поля ** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/agroLands**
++)))
++
++Пример запроса:
++
++(((
++{
++  "extId": "string",
++  "shape": "string", ~/~/ Форма поля
++  "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
++  "display": "string", ~/~/ Настройки отображения
++  "year": 0, ~/~/ Год поля
++  "name": "string", ~/~/ Наименование
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++  "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая
++  "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая
++  "planComment": "string", ~/~/ Комментарий к полю
++  "cropRotations": [ ~/~/ Данные по севообороту
++    {
++      "landId": 0, ~/~/ ID поля
++      "landName": "string", ~/~/ Название поля
++      "year": 0, ~/~/ Год урожая
++      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
++      "cultureName": "string", ~/~/ Название культуры
++      "productivity": 0, ~/~/ Урожайность
++      "area": 0, ~/~/ Площадь поля, Га
++      "total": 0, ~/~/ Валовый сбор
++      "productivityFact": 0, ~/~/ Фактическая урожайность
++      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
++      "totalFact": 0, ~/~/ Фактический валовый сбор
++      "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая
++      "isyearplan": true, ~/~/ Годовой план
++      "comment": "string" ~/~/ Комментарий
++    }
++  ]
++}
++)))
++
++(((
++
++)))
++
++Пример ответа:
++
++(((
++(((
++{
++  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
++  "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
++  "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
++  "sourceId": 0, ~/~/ Ссылка на участок прошлого года
++  "cropRotations": [ ~/~/ Данные по севообороту
++    {
++      "landId": 0, ~/~/ ID поля
++      "landName": "string", ~/~/ Название поля
++      "year": 0, ~/~/ Год урожая
++      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
++      "cultureName": "string", ~/~/ Название культуры
++      "productivity": 0, ~/~/ Урожайность
++      "area": 0, ~/~/ Площадь поля, Га.
++      "total": 0, ~/~/ Валовый сбор
++      "productivityFact": 0, ~/~/ Фактическая урожайность
++      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
++      "totalFact": 0, ~/~/ Фактический валовый сбор
++      "start": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T08:19:59.743Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T08:19:59.743Z", ~/~/ Дата уборки урожая
++      "isyearplan": true, ~/~/ годовой план
++      "comment": "string" ~/~/ Комментарий
++    }
++  ],
++  "cropVegetation": [ ~/~/ История вегетации поля
++    {
++      "values": [  ~/~/ Данные вегетации и состояния посева
++        {
++          "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
++          "ndvi": 0 ~/~/ Индекс вегетации
++        }
++      ],
++      "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
++        {
++          "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
++          "type": "string", ~/~/ Тип
++          "pictureid": "string" ~/~/ Идентификатор ресурса
++        }
++      ],
++      "states": [ ~/~/ Ключевые даты развития поля
++        {
++          "date": "2024-12-20T08:19:59.743Z", ~/~/ Дата
++          "state": 0 ~/~/ Статус  0 - Всходы, 1 - Вершина, 2 - Сбор урожая
++        }
++      ]
++    }
++  ],
++  "endDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата закрытия года урожая
++  "counts": {
++    "fieldOperations": 0, ~/~/ Количество операций на поле
++    "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
++    "facts": 0 ~/~/ Счётчик факта
++  },
++  "planComment": "string", ~/~/ Комментарий к полю
++)))
++
++(((
++  "productivity": 0, ~/~/ Урожайность.
++  "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
++  "startDate": "2024-12-20T08:19:59.743Z", ~/~/ Дата открытия года урожая
++  "year": 0, ~/~/ Год поля
++  "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "actualPlanState": 0, ~/~/ Актуальный статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "factState": 0, ~/~/ Фактический статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "taskState": 0, ~/~/ Статус задачи годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "status": 0, ~/~/ Статус с/х поля 0 - Нет, 1 - Открыто, 2 - Закрыто
++  "id": 0, ~/~/ Идентификатор объекта геозоны
++  "name": "string", ~/~/ Название объекта геозоны
++  "type": 0, ~/~/ Тип объекта геозоны
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++  "fname": "string", ~/~/ Имя файла
++  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
++  "beginCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата начала расчетов для геозоны
++  "endCalc": "2024-12-20T08:19:59.743Z", ~/~/ Дата окончания расчетов для геозоны
++  "description": "string", ~/~/ Описание объекта геозоны
++  "area": 0, ~/~/ Площадь, м2
++  "perimetr": 0, ~/~/ Периметр, м
++  "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд
++}
++
++
++)))
++)))
++)))
++
++== **Получение поля по id** ==
++
++(% class="box infomessage" %)
++(((
++**GET /api/v3/agroLands/{id}**
++)))
++
++Пример запроса:
++id  ~/~/ Идентификатор поля
++
++Пример ответа:
++
++(((
++{
++  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
++  "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
++  "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
++  "sourceId": 0, ~/~/ Ссылка на участок прошлого года
++  "cropRotations": [ ~/~/ Данные по севообороту
++    {
++      "landId": 0, ~/~/ ID поля
++      "landName": "string", ~/~/ Название поля
++      "year": 0, ~/~/ Год урожая
++      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
++      "cultureName": "string", ~/~/ Название культуры
++      "productivity": 0, ~/~/ Урожайность
++      "area": 0, ~/~/ Площадь поля, Га
++      "total": 0, ~/~/ Валовый сбор
++      "productivityFact": 0, ~/~/ Фактическая урожайность
++      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
++      "totalFact": 0, ~/~/ Фактический валовый сбор
++      "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая
++      "isyearplan": true, ~/~/ План года
++      "comment": "string" ~/~/ Комментарий
++    }
++  ],
++  "cropVegetation": [ ~/~/ История вегетации поля
++    {
++      "values": [ ~/~/ Данные вегетации и состояния посева
++        {
++          "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
++          "ndvi": 0 ~/~/ Индекс вегетации
++        }
++      ],
++      "resources": [  ~/~/ Данные о снимках для каждого значения NDVI
++        {
++          "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
++          "type": "string", ~/~/ Тип
++          "pictureid": "string" ~/~/ Идентификатор ресурса
++        }
++      ],
++      "states": [ ~/~/ Ключевые даты развития поля
++        {
++          "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата
++          "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая
++        }
++      ]
++    }
++  ],
++  "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая
++  "counts": {
++    "fieldOperations": 0, ~/~/ Количество операций на поле
++    "actualFieldOperations": 0,  ~/~/ Кол-во актуальных операций на поле
++    "facts": 0 ~/~/ Счётчик факта
++  },
++  "planComment": "string", ~/~/ Комментарий к полю
++  "productivity": 0, ~/~/ Урожайность.
++  "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
++)))
++
++(((
++(((
++ "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая
++  "year": 0, ~/~/ Год поля
++  "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
++  "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
++  "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
++  "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
++  "status": 0,  ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой)
++  "id": 0, ~/~/ Идентификатор объекта геозоны
++  "name": "string", ~/~/ Название объекта геозоны
++  "type": 0, ~/~/ Тип объекта геозоны
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++  "fname": "string", ~/~/ Имя файла
++  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
++  "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны
++  "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны
++  "description": "string", ~/~/ Описание объекта геозоны
++  "area": 0, ~/~/ Площадь, м2
++  "perimetr": 0, ~/~/ Периметр, м
++  "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд
++}
++)))
++
++
++== **Удаление существующего поля** ==
++
++(% class="box errormessage" %)
++(((
++**DELETE /api/v3/agroLands/{id}**
++)))
++
++Пример запроса:
++id  ~/~/ Идентификатор поля
++
++Пример ответа:
++
++(((
++200 ~/~/ Успех
++)))
++
++(((
++
++)))
++
++(((
++(((
++(((
++
++)))
++
++(((
++== **Изменение поля** ==
++
++(% class="box infomessage" %)
++(((
++**PUT /api/v3/agroLands**
++)))
++
++Пример запроса:
++
++(((
++(((
++{
++  "id": 0, ~/~/ Идентификатор поля
++  "extId": "string", ~/~/ ExtId
++  "shape": "string", ~/~/ Форма поля
++  "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
++  "display": "string", ~/~/ Настройки отображения
++  "year": 0, ~/~/ Год поля
++  "name": "string", ~/~/ Наименование
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++  "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая
++  "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая
++  "planComment": "string", ~/~/Комментарий к полю
++  "cropRotations": [  ~/~/ Данные по севообороту
++    {
++      "landId": 0, ~/~/ ID поля
++      "landName": "string", ~/~/ Название поля
++      "year": 0, ~/~/ Год урожая
++      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
++      "cultureName": "string", ~/~/ Название культуры
++      "productivity": 0, ~/~/ Урожайность
++      "area": 0, ~/~/ Площадь поля, Га.
++      "total": 0, ~/~/ Валовый сбор
++      "productivityFact": 0, ~/~/ Фактическая урожайность
++      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
++      "totalFact": 0, ~/~/ Фактический валовый сбор
++      "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая
++      "isyearplan": true,
++      "comment": "string" ~/~/ Комментарий
++    }
++  ],
++  "deleteStatistic": true ~/~/ Нужно ли удалять статистику
++}
++)))
++)))
++
++(((
++
++)))
++
++Пример ответа:
++
++(((
++(((
++(((
++{
++  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
++  "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
++  "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
++  "sourceId": 0, ~/~/ Ссылка на участок прошлого года
++  "cropRotations": [ ~/~/ Данные по севообороту
++    {
++      "landId": 0, ~/~/ ID поля
++      "landName": "string", ~/~/ Название поля
++      "year": 0, ~/~/  Год урожая
++      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
++      "cultureName": "string", ~/~/ Название культуры
++      "productivity": 0, ~/~/ Урожайность
++      "area": 0, ~/~/ Площадь поля, Га
++      "total": 0, ~/~/ Валовый сбор
++      "productivityFact": 0, ~/~/ Фактическая урожайность
++      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
++      "totalFact": 0, ~/~/ Фактический валовый сбор
++      "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая
++      "isyearplan": true, ~/~/
++      "comment": "string" ~/~/ Комментарий
++    }
++  ],
++  "cropVegetation": [ ~/~/ История вегетации поля
++    {
++      "values": [ ~/~/ Данные вегетации и состояния посева
++        {
++          "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
++          "ndvi": 0 ~/~/ Индекс вегетации
++        }
++      ],
++      "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
++        {
++          "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
++          "type": "string", ~/~/ Тип
++          "pictureid": "string" ~/~/ Идентификатор ресурса
++        }
++      ],
++      "states": [ ~/~/ Ключевые даты развития поля
++        {
++          "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
++          "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
++        }
++      ]
++    }
++  ],
++  "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая
++  "counts": {
++    "fieldOperations": 0, ~/~/ Количество операций на поле
++    "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
++    "facts": 0 ~/~/ Счётчик факта
++  },
++  "planComment": "string", ~/~/ Комментарий к полю
++  "productivity": 0, ~/~/ Урожайность.
++  "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
++  "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая
++  "year": 0, ~/~/ Год поля
++  "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "factState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
++  "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
++  "id": 0, ~/~/ Идентификатор объекта геозоны
++  "name": "string", ~/~/ Название объекта геозоны
++  "type": 0, ~/~/ Тип объекта геозоны
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++  "fname": "string", ~/~/ Имя файла
++  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
++  "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны
++  "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны
++  "description": "string", ~/~/ Описание объекта геозоны
++  "area": 0, ~/~/ Площадь, м2
++  "perimetr": 0, ~/~/ Периметр, м
++  "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд
++}
++)))
++)))
++)))
++)))
++)))
++
++
++== **Редактирование года урожая ** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/agroLands/updateOpenCloseYear**
++)))
++
++Пример запроса:
++
++(((
++(((
++{
++  "agroLandIds": [  ~/~/ Идентификаторы полей для которых меняется год урожая
++    0
++  ],
++  "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая
++  "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая
++}
++)))
++
++
++)))
++
++Пример ответа:
++
++(((
++(((
++{
++  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
++  "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
++  "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
++  "sourceId": 0, ~/~/ Ссылка на участок прошлого года
++  "cropRotations": [ ~/~/ Данные по севообороту
++    {
++      "landId": 0, ~/~/ ID поля
++      "landName": "string", ~/~/ Название поля
++      "year": 0, ~/~/ Год урожая
++      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
++      "cultureName": "string", ~/~/ Название культуры
++      "productivity": 0, ~/~/ Урожайность
++      "area": 0, ~/~/ Площадь поля, Га.
++      "total": 0, ~/~/ Валовый сбор
++      "productivityFact": 0, ~/~/ Фактическая урожайность
++      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
++      "totalFact": 0, ~/~/ Фактический валовый сбор
++      "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая
++      "isyearplan": true, ~/~/
++      "comment": "string" ~/~/ Комментарий
++    }
++  ],
++  "cropVegetation": [ ~/~/ История вегетации поля
++    {
++      "values": [ ~/~/ Данные вегетации и состояния посева
++        {
++          "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
++          "ndvi": 0 ~/~/ Индекс вегетации
++        }
++      ],
++      "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
++        {
++          "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
++          "type": "string", ~/~/ Тип
++          "pictureid": "string" ~/~/ Идентификатор ресурса
++        }
++      ],
++      "states": [ ~/~/ Ключевые даты развития поля
++        {
++          "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
++          "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
++        }
++      ]
++    }
++  ],
++  "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая
++  "counts": {
++    "fieldOperations": 0, ~/~/ Количество операций на поле
++    "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
++    "facts": 0 ~/~/ Счётчик факта
++  },
++  "planComment": "string", ~/~/ Комментарий к полю
++  "productivity": 0, ~/~/ Урожайность.
++  "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
++  "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая
++  "year": 0, ~/~/ Год поля
++  "planState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++  "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++  "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++  "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
++  "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
++  "id": 0, ~/~/ Идентификатор объекта геозоны
++  "name": "string", ~/~/ Название объекта геозоны
++  "type": 0, ~/~/ Тип объекта геозоны
++  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
++  "fname": "string", ~/~/ Имя файла
++  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
++  "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны
++  "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны
++  "description": "string", ~/~/ Описание объекта геозоны
++  "area": 0, ~/~/ Площадь, м2
++  "perimetr": 0, ~/~/ ериметр, м
++  "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
++}
++)))
++
++
++== (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) ==
++)))
++)))
++)))
++
  == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
  (% class="box infomessage" %)
  (((
--GET api/v3/Vehicles/recyclebin/all
++**GET api/v3/Vehicles/recyclebin/all**
  )))
  Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
@@ -4610,7 +4610,7 @@
  (% class="box infomessage" %)
  (((
--POST/api/v3/Vehicles/recyclebin/erase
++**POST api/v3/Vehicles/recyclebin/erase**
  )))
  В заголовках запроса: X-Auth: Токен авторизации
@@ -4652,7 +4652,7 @@
  (% class="box infomessage" %)
  (((
--POST/api/v3/Vehicles/recyclebin/restore
++**POST api/v3/Vehicles/recyclebin/restore**
  )))
  В заголовках запроса: X-Auth: Токен авторизации

Changes for page Методы API для работы с ГЛОНАССSoft

Summary

Details

Меню