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

Last modified by Андрей Калиновский on 2025/01/14 11:58

From version < 195.1 >

edited by Андрей Калиновский
on 2024/12/20 13:14

To version < 200.1 >

edited by Андрей Калиновский
on 2024/12/20 16:01

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -2,10 +2,6 @@
  (((
  (% class="box warningmessage" %)
  (((
--
--
--
--
  (% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно
  просим вас соблюдать несколько простых правил при использовании API-команд:##
  )))
@@ -4604,7 +4604,7 @@
  (% class="box infomessage" %)
  (((
--POST **/api/v3/Reports/harvesterUnloading**
++**POST /api/v3/Reports/harvesterUnloading**
  )))
  Пример запроса:
@@ -4678,11 +4678,78 @@
  = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
--== **Получение участка по id** ==
++== **Возвращает список полей** ==
++
++(% 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" ~/~/ Дата создания в бд
++  }
++]
++
++
++)))
++
++== **Получение поля по id** ==
++
  (% class="box infomessage" %)
  (((
--GET **/api/v3/agroLands/{id}**
++**GET /api/v3/agroLands/{id}**
  )))
  Пример запроса:
@@ -4775,11 +4775,11 @@
  )))
--== **Удалить участок** ==
++== **Удалить поле** ==
  (% class="box errormessage" %)
  (((
--DELETE **/api/v3/agroLands/{id}**
++**DELETE /api/v3/agroLands/{id}**
  )))
  Пример запроса:
@@ -4796,11 +4796,11 @@
  )))
  (((
--== **Сохранение участка** ==
++== **Сохранение поля** ==
  (% class="box successmessage" %)
  (((
--POST **/api/v3/agroLands**
++**POST /api/v3/agroLands**
  )))
  Пример запроса:
@@ -4844,10 +4844,6 @@
  )))
--(((
--
--)))
--
  Пример ответа:
  (((
@@ -4939,22 +4939,20 @@
  )))
  (((
--
--)))
++== **Изменение поля** ==
++(% class="box infomessage" %)
  (((
--== **Изменение участка** ==
--
--(% class="box successmessage" %)
--(((
--PUT /api/v3/agroLands
++**PUT /api/v3/agroLands**
  )))
  Пример запроса:
  (((
++(((
  {
--  "extId": "string",
++  "id": 0, ~/~/ Идентификатор поля
++  "extId": "string", ~/~/ ExtId
    "shape": "string", ~/~/ Форма поля
    "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
    "display": "string", ~/~/ Настройки отображения
@@ -4961,14 +4961,53 @@
    "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": [ ~/~/ Данные по севообороту
++  "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, ~/~/ Урожайность
@@ -4977,21 +4977,92 @@
        "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, ~/~/ Годовой план
++      "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" ~/~/ Новая дата закрытия урожая
++}
++)))
++
  )))
@@ -5000,17 +5000,93 @@
  (((
  (((
  {
--  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
++  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
    "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
--  "fieldId": 0, ~/~/ С
++  "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" %)Раздел: **Корзина**(%%) =
@@ -5019,7 +5019,7 @@
  (% class="box infomessage" %)
  (((
--GET api/v3/Vehicles/recyclebin/all
++**GET api/v3/Vehicles/recyclebin/all**
  )))
  Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту
@@ -5058,7 +5058,7 @@
  (% class="box infomessage" %)
  (((
--POST/api/v3/Vehicles/recyclebin/erase
++**POST api/v3/Vehicles/recyclebin/erase**
  )))
  В заголовках запроса: X-Auth: Токен авторизации
@@ -5100,7 +5100,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

Меню