Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/05/06 12:41
<
>
edited by Андрей Калиновский
on 2025/05/06 11:25
on 2025/05/06 11:25
edited by Андрей Калиновский
on 2024/12/20 15:58
on 2024/12/20 15:58
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -11,11 +11,6 @@ 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 13 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 -))) 19 19 20 20 **Содержание страницы:** 21 21 ))) ... ... @@ -123,41 +123,29 @@ 123 123 Запрос должен содержать данные параметра "**agentId**" 124 124 125 125 (% style="color:#000000" %)Ответ: 126 - 127 -((( 128 128 { 129 - "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID клиента 130 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID родителя 131 - "parentName": "string", ~/~/ Наименование агента 132 - "name": "string", ~/~/ Имя клиента 133 - "fullName": "string", ~/~/ ФИО клиента 134 - "agentInfoType": 0, ~/~/ Тип клиента ((% style="color:#000000" %)0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор(%%)) 135 - "isForeign": true, ~/~/ Флаг "Иностранный контрагент" 136 - "district": "string", ~/~/ Район 137 - "region": "string", ~/~/ Область 138 - "city": "string", ~/~/ Город 139 - "email": "string", ~/~/ Email 140 - "director": "string", ~/~/ Руководитель 141 - "RegionalData": [ ~/~/ Определяет региональные сведения. 142 - { 143 - "Country": 0, ~/~/ Страна 144 - "groups": [ ~/~/ Список групп 145 - { 146 - "groupId": "string", ~/~/ Уникальный идентификатор группы 147 - "fields": [ ~/~/ Список значений полей 148 - { 149 - "name": "string", ~/~/ Имя поля формы 150 - "value": "string" ~/~/ Значение поля формы 151 - } 152 - ] 153 - } 154 - ] 155 - } 156 - ] 157 -} 158 -))) 122 + "agentId": "", (%%) 123 + "parentId": "", 124 + "parentName": "string", 125 + "name": "string", 126 + "fullName": "string", 127 + "agentInfoType": 0, 128 + "isForeign": true/false, 129 + "district": "string", 130 + "region": "string", 131 + "city": "string", 132 + "inn": "string", 133 + "kpp": "string", 134 + "address": "string", 135 + "addressFact": "string", 136 + "email": "string", 137 + "director": "string", 138 + "bankName": "string", 139 + "bankBIK": "string", 140 + "bankRS": "string", 141 + "bankKS": "string" 142 + } 159 159 160 - 161 161 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 162 162 |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 163 163 |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя ... ... @@ -1038,17 +1038,6 @@ 1038 1038 1039 1039 ((( 1040 1040 { 1041 - 1042 -((( 1043 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1044 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1045 -))) 1046 - 1047 -((( 1048 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1049 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1050 -))) 1051 - 1052 1052 "vehicleId": "", ~/~/ ID объекта 1053 1053 "name": "", ~/~/ Имя объекта 1054 1054 "imei": "", ~/~/ IMEI объекта ... ... @@ -1143,7 +1143,6 @@ 1143 1143 ], 1144 1144 "showInTooltip": true, ~/~/ Отображать в подсказке 1145 1145 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1146 - "color": "string", ~/~/ Код цвета датчиков 1147 1147 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1148 1148 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1149 1149 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1201,21 +1201,11 @@ 1201 1201 "date": "2023-05-22T09:57:39.562Z", 1202 1202 "description": "string", 1203 1203 "additionalInfo": "string" 1204 - 1205 - (((1175 + } 1176 + ] 1206 1206 } 1207 - ], 1208 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1209 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1210 1210 ))) 1211 1211 1212 -((( 1213 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1214 -} 1215 - 1216 -))) 1217 -))) 1218 - 1219 1219 (% style="text-align:left" %) 1220 1220 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1221 1221 ... ... @@ -1308,13 +1308,7 @@ 1308 1308 1309 1309 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1310 1310 1311 -(% style="color:#000000" %){ 1312 - 1313 - 1314 -((( 1315 - "vehicleId": 0, ~/~/ ID ТС 1316 -))) 1317 - 1272 +(% style="color:#000000" %){(%%) 1318 1318 "parentId": "" , ~/~/ ID клиента 1319 1319 "name": "" , ~/~/ имя ТС 1320 1320 "imei": "" , ~/~/ IMEI ... ... @@ -1407,7 +1407,6 @@ 1407 1407 ], 1408 1408 "showInTooltip": true, ~/~/ Отображать в подсказке 1409 1409 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1410 - "color": "string", ~/~/ код цвета датчиков 1411 1411 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1412 1412 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1413 1413 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1457,19 +1457,10 @@ 1457 1457 "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1458 1458 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1459 1459 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1460 - 1461 -((( 1462 - } 1463 - ], 1464 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1465 -))) 1466 - 1467 -((( 1468 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1414 + } 1415 + ] 1469 1469 } 1470 -))) 1471 1471 1472 - 1473 1473 (% style="color:#000000" %)Ответ: 1474 1474 1475 1475 ... ... @@ -1578,7 +1578,6 @@ 1578 1578 ], 1579 1579 "showInTooltip": true, ~/~/ Отображение в подсказке 1580 1580 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1581 - "color": "string", ~/~/ код цвета датчиков 1582 1582 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1583 1583 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1584 1584 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -1615,7 +1615,7 @@ 1615 1615 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1616 1616 } 1617 1617 ], 1618 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 -По датчику Моточасов, 2 -По датчику относительных Моточасов1562 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1619 1619 } 1620 1620 ))) 1621 1621 ))) ... ... @@ -1635,8 +1635,6 @@ 1635 1635 **POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1636 1636 ))) 1637 1637 1638 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 1639 - 1640 1640 Метод запроса: **POST** 1641 1641 1642 1642 URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** ... ... @@ -1672,8 +1672,6 @@ 1672 1672 **GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1673 1673 ))) 1674 1674 1675 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 1676 - 1677 1677 Метод запроса: **GET** 1678 1678 1679 1679 URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** ... ... @@ -1925,19 +1925,9 @@ 1925 1925 1926 1926 "drivers": [ ~/~/ Водители 1927 1927 { 1928 - 1929 -((( 1930 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1931 - "inputNumber": 0, ~/~/ № входа. 1932 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1933 - "comment": "string", ~/~/ Комментарий. 1934 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1935 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1936 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1937 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1938 -))) 1939 - 1940 - } 1868 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1869 + "isDefault": true 1870 + } 1941 1941 ], 1942 1942 "commandTemplates": [ ~/~/ Шаблон команды 1943 1943 { ... ... @@ -1973,11 +1973,6 @@ 1973 1973 ], 1974 1974 "showInTooltip": true, ~/~/ Отображать в подсказке 1975 1975 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1976 - 1977 -((( 1978 - "color": "string",** ~/~/ **Цвет датчика 1979 -))) 1980 - 1981 1981 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1982 1982 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1983 1983 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -2024,12 +2024,7 @@ 2024 2024 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 2025 2025 "forReport": true ~/~/ Отобразить произвольное поле в отчете 2026 2026 } 2027 - 2028 -((( 2029 - ], 2030 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 2031 -))) 2032 - 1952 + ] 2033 2033 } 2034 2034 2035 2035 ... ... @@ -2167,11 +2167,6 @@ 2167 2167 ], 2168 2168 "showInTooltip": true, ~/~/ Отображение в подсказке 2169 2169 "showLastValid": true, ~/~/ Отображать последнее валидное значение 2170 - 2171 -((( 2172 - "color": "string", ~/~/ цвет уведомлений 2173 -))) 2174 - 2175 2175 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2176 2176 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2177 2177 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -2488,8 +2488,6 @@ 2488 2488 "motohours": 0, ~/~/ Моточасы за период, секунды 2489 2489 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2490 2490 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2491 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2492 - 2493 2493 } 2494 2494 ] 2495 2495 } ... ... @@ -2533,8 +2533,6 @@ 2533 2533 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2534 2534 "fuelConsumption": 0, ~/~/ Расход топлива 2535 2535 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2536 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2537 - 2538 2538 } 2539 2539 ] 2540 2540 } ... ... @@ -2580,8 +2580,7 @@ 2580 2580 "model": "string", ~/~/ Модель объекта 2581 2581 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2582 2582 { 2583 - "event": 0, ~/~/ Тип события 0 - Other, 1 - Engine, 2 - Stop, 3 - FuelIn, 4 - FuelOut, 5 - Garbage, 6 - Grader, 8 - Otval, 9 - Sand, 10 - MixerLand, 11 - MixerMove, 12 - OpenCircuit, 13 - TechSpeed, 14 - Work, 15 - Braid, 16 - Broom, 17 - ReFuller, 18 - Crane, 19 - Power, 20 - TankFuelIn, 21 - TankFuelOut, 22 - BigStop, 23 - OverSpeed, 24 - Unloading, 25 - Warning, 26 - GarbageWork, 27 - Custom, 28 - CustomWork, 29 - GNSS, 30 - GrainIn, 31 - GrainOut, 32 - WeighingTerminal, 33 - Stopping, 34 - FertilizerWork, 35 - FertilizerRefueling 2584 - 2494 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2585 2585 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2586 2586 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2587 2587 "valueFuel": 0, ~/~/ Количество ... ... @@ -2810,35 +2810,6 @@ 2810 2810 } 2811 2811 ] 2812 2812 2813 - 2814 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2815 - 2816 -(% class="box successmessage" %) 2817 -((( 2818 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2819 -))) 2820 - 2821 -(% style="color:#000000" %)Метод запроса: **PUT** 2822 - 2823 -Пример запроса: 2824 - 2825 -((( 2826 -{ 2827 - "id": 0, ~/~/ Идентификатор объекта геозоны 2828 - "name": "string", ~/~/ Наименование объекта геозоны 2829 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2830 - "description": "string", ~/~/ Описание объекта геозоны 2831 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2832 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2833 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2834 -} 2835 -))) 2836 - 2837 - 2838 -Пример ответа: 2839 - 2840 -200 ~/~/ Success 2841 - 2842 2842 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2843 2843 2844 2844 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -4502,7 +4502,7 @@ 4502 4502 4503 4503 (% class="box infomessage" %) 4504 4504 ((( 4505 - **POST /api/v3/fuelcards/transactions**4386 +POST /api/v3/fuelcards/transactions 4506 4506 ))) 4507 4507 4508 4508 Метод запроса: POST ... ... @@ -4540,32 +4540,7 @@ 4540 4540 "address": "string" ~/~/ Адрес АЗС 4541 4541 } 4542 4542 4543 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4544 4544 4545 -(% class="box infomessage" %) 4546 -((( 4547 -**GET /api/v3/fuelcards** 4548 -))) 4549 - 4550 -Метод запроса: GET 4551 - 4552 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4553 - 4554 -Ответ: 4555 - 4556 -[ 4557 - { 4558 - "Name": "string", ~/~/ Определяет наименование карты. 4559 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4560 - "Number": "string", ~/~/ Определяет № карты. 4561 - "Enabled": true, ~/~/ Определяет признак активности карты. 4562 - "Description": "string", ~/~/ Определяет описание карты. 4563 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4564 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4565 - "deleted": true ~/~/ Признак удаления 4566 - } 4567 -] 4568 - 4569 4569 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4570 4570 4571 4571 ... ... @@ -4744,7 +4744,7 @@ 4744 4744 4745 4745 (% class="box infomessage" %) 4746 4746 ((( 4747 - **POST /api/v3/Reports/harvesterUnloading**4603 +POST **/api/v3/Reports/harvesterUnloading** 4748 4748 ))) 4749 4749 4750 4750 Пример запроса: ... ... @@ -4816,98 +4816,14 @@ 4816 4816 ] 4817 4817 4818 4818 4819 -== **Отчет трек-датчики** == 4820 - 4821 -(% class="box infomessage" %) 4822 -((( 4823 -**POST /api/v3/Reports/sensorsWorks** 4824 -))) 4825 - 4826 -**Пример запроса:** 4827 - 4828 -{ 4829 - "vehicleIds": [ ~/~/ Список ID объектов 4830 - 0 4831 - ], 4832 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 4833 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 4834 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4835 -} 4836 - 4837 -**Пример ответа:** 4838 - 4839 -((( 4840 -{ 4841 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 4842 - { 4843 - "vehicleId": 0, ~/~/ Идентификатор ТС 4844 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 4845 - { 4846 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 4847 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 4848 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 4849 - "name": "string", ~/~/ Наименование оборудования. 4850 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 4851 - "totalMileage": 0, ~/~/ Общий пробег. 4852 - "avgSpeed": 0 ~/~/ Средняя скорость. 4853 - } 4854 - ] 4855 - } 4856 - ] 4857 -} 4858 - 4859 - 4860 -== **Превышение скорости** == 4861 - 4862 -(% class="box infomessage" %) 4863 -((( 4864 -**POST /api/v3/Reports/overSpeedDuration** 4865 -))) 4866 - 4867 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 4868 - 4869 -Пример запроса: 4870 - 4871 -((( 4872 -{ 4873 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 4874 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 4875 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 4876 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4877 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 4878 -} 4879 -))) 4880 - 4881 -((( 4882 - 4883 -))) 4884 - 4885 -((( 4886 -Пример ответа: 4887 -))) 4888 - 4889 -((( 4890 -((( 4891 -[ 4892 - { 4893 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 4894 - "duration": 0, ~/~/ Продолжительность события в секундах 4895 - "maxSpeed": 0, ~/~/ Максимальная скорость 4896 - "speedLimit": 0 ~/~/ Ограничение скорости 4897 - } 4898 -] 4899 -))) 4900 -))) 4901 -))) 4902 - 4903 4903 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4904 4904 4905 4905 4906 -== ** Запросспискаполей** ==4678 +== **Возвращает список полей** == 4907 4907 4908 4908 (% class="box successmessage" %) 4909 4909 ((( 4910 - **POST /api/v3/agroLands/find**4682 +POST **/api/v3/agroLands/find** 4911 4911 ))) 4912 4912 4913 4913 Пример запроса: ... ... @@ -4966,24 +4966,141 @@ 4966 4966 } 4967 4967 ] 4968 4968 4741 + 4742 +))) 4969 4969 4970 -== ** Созданиеновогополя ** ==4744 +== **Получение поля по id** == 4971 4971 4972 -(% class="box successmessage" %)4746 +(% class="box infomessage" %) 4973 4973 ((( 4974 -** POST/api/v3/agroLands**4748 +GET **/api/v3/agroLands/{id}** 4975 4975 ))) 4976 4976 4977 - Еслинеобходимо указывать конкретного клиента, в которомнужно создатьполе, то в заголовке надо прописать4978 - X-agent-ID клиента4751 +Пример запроса: 4752 +id ~/~/ Идентификатор поля 4979 4979 4754 +Пример ответа: 4755 + 4756 +((( 4757 +{ 4758 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4759 + "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4760 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4761 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4762 + "cropRotations": [ ~/~/ Данные по севообороту 4763 + { 4764 + "landId": 0, ~/~/ ID поля 4765 + "landName": "string", ~/~/ Название поля 4766 + "year": 0, ~/~/ Год урожая 4767 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4768 + "cultureName": "string", ~/~/ Название культуры 4769 + "productivity": 0, ~/~/ Урожайность 4770 + "area": 0, ~/~/ Площадь поля, Га 4771 + "total": 0, ~/~/ Валовый сбор 4772 + "productivityFact": 0, ~/~/ Фактическая урожайность 4773 + "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4774 + "totalFact": 0, ~/~/ Фактический валовый сбор 4775 + "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 4776 + "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 4777 + "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 4778 + "isyearplan": true, ~/~/ План года 4779 + "comment": "string" ~/~/ Комментарий 4780 + } 4781 + ], 4782 + "cropVegetation": [ ~/~/ История вегетации поля 4783 + { 4784 + "values": [ ~/~/ Данные вегетации и состояния посева 4785 + { 4786 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4787 + "ndvi": 0 ~/~/ Индекс вегетации 4788 + } 4789 + ], 4790 + "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 4791 + { 4792 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4793 + "type": "string", ~/~/ Тип 4794 + "pictureid": "string" ~/~/ Идентификатор ресурса 4795 + } 4796 + ], 4797 + "states": [ ~/~/ Ключевые даты развития поля 4798 + { 4799 + "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 4800 + "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 4801 + } 4802 + ] 4803 + } 4804 + ], 4805 + "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 4806 + "counts": { 4807 + "fieldOperations": 0, ~/~/ Количество операций на поле 4808 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 4809 + "facts": 0 ~/~/ Счётчик факта 4810 + }, 4811 + "planComment": "string", ~/~/ Комментарий к полю 4812 + "productivity": 0, ~/~/ Урожайность. 4813 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 4814 +))) 4815 + 4816 +((( 4817 +((( 4818 + "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 4819 + "year": 0, ~/~/ Год поля 4820 + "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4821 + "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4822 + "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4823 + "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4824 + "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 4825 + "id": 0, ~/~/ Идентификатор объекта геозоны 4826 + "name": "string", ~/~/ Название объекта геозоны 4827 + "type": 0, ~/~/ Тип объекта геозоны 4828 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4829 + "fname": "string", ~/~/ Имя файла 4830 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 4831 + "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 4832 + "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 4833 + "description": "string", ~/~/ Описание объекта геозоны 4834 + "area": 0, ~/~/ Площадь, м2 4835 + "perimetr": 0, ~/~/ Периметр, м 4836 + "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 4837 +} 4838 +))) 4839 + 4840 + 4841 +== **Удалить поле** == 4842 + 4843 +(% class="box errormessage" %) 4844 +((( 4845 +DELETE **/api/v3/agroLands/{id}** 4846 +))) 4847 + 4980 4980 Пример запроса: 4849 +id ~/~/ Идентификатор поля 4981 4981 4851 +Пример ответа: 4852 + 4982 4982 ((( 4854 +200 ~/~/ Успех 4855 +))) 4856 + 4857 +((( 4858 + 4859 +))) 4860 + 4861 +((( 4862 +== **Сохранение поля** == 4863 + 4864 +(% class="box successmessage" %) 4865 +((( 4866 +POST **/api/v3/agroLands** 4867 +))) 4868 + 4869 +Пример запроса: 4870 + 4871 +((( 4983 4983 { 4984 4984 "extId": "string", 4985 - "shape": " {\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}",~/~/ Форма поля4986 - "shapeFormat": " geojson", ~/~/ Формат, в котором представлена форма поля4874 + "shape": "string", ~/~/ Форма поля 4875 + "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 4987 4987 "display": "string", ~/~/ Настройки отображения 4988 4988 "year": 0, ~/~/ Год поля 4989 4989 "name": "string", ~/~/ Наименование ... ... @@ -5102,141 +5102,18 @@ 5102 5102 "perimetr": 0, ~/~/ Периметр, м 5103 5103 "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5104 5104 } 5105 - 5106 - 5107 5107 ))) 5108 -))) 5109 -))) 5110 5110 5111 -== **Получение поля по id** == 5112 - 5113 -(% class="box infomessage" %) 5114 5114 ((( 5115 -**GET /api/v3/agroLands/{id}** 5116 -))) 5117 - 5118 -Пример запроса: 5119 -id ~/~/ Идентификатор поля 5120 - 5121 -Пример ответа: 5122 - 5123 -((( 5124 -{ 5125 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5126 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5127 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5128 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5129 - "cropRotations": [ ~/~/ Данные по севообороту 5130 - { 5131 - "landId": 0, ~/~/ ID поля 5132 - "landName": "string", ~/~/ Название поля 5133 - "year": 0, ~/~/ Год урожая 5134 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5135 - "cultureName": "string", ~/~/ Название культуры 5136 - "productivity": 0, ~/~/ Урожайность 5137 - "area": 0, ~/~/ Площадь поля, Га 5138 - "total": 0, ~/~/ Валовый сбор 5139 - "productivityFact": 0, ~/~/ Фактическая урожайность 5140 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5141 - "totalFact": 0, ~/~/ Фактический валовый сбор 5142 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5143 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5144 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5145 - "isyearplan": true, ~/~/ План года 5146 - "comment": "string" ~/~/ Комментарий 5147 - } 5148 - ], 5149 - "cropVegetation": [ ~/~/ История вегетации поля 5150 - { 5151 - "values": [ ~/~/ Данные вегетации и состояния посева 5152 - { 5153 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5154 - "ndvi": 0 ~/~/ Индекс вегетации 5155 - } 5156 - ], 5157 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5158 - { 5159 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5160 - "type": "string", ~/~/ Тип 5161 - "pictureid": "string" ~/~/ Идентификатор ресурса 5162 - } 5163 - ], 5164 - "states": [ ~/~/ Ключевые даты развития поля 5165 - { 5166 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5167 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5168 - } 5169 - ] 5170 - } 5171 - ], 5172 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5173 - "counts": { 5174 - "fieldOperations": 0, ~/~/ Количество операций на поле 5175 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5176 - "facts": 0 ~/~/ Счётчик факта 5177 - }, 5178 - "planComment": "string", ~/~/ Комментарий к полю 5179 - "productivity": 0, ~/~/ Урожайность. 5180 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5181 -))) 5182 - 5183 -((( 5184 -((( 5185 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5186 - "year": 0, ~/~/ Год поля 5187 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5188 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5189 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5190 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5191 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5192 - "id": 0, ~/~/ Идентификатор объекта геозоны 5193 - "name": "string", ~/~/ Название объекта геозоны 5194 - "type": 0, ~/~/ Тип объекта геозоны 5195 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5196 - "fname": "string", ~/~/ Имя файла 5197 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5198 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5199 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5200 - "description": "string", ~/~/ Описание объекта геозоны 5201 - "area": 0, ~/~/ Площадь, м2 5202 - "perimetr": 0, ~/~/ Периметр, м 5203 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5204 -} 5205 -))) 5206 - 5207 - 5208 -== **Удаление существующего поля** == 5209 - 5210 -(% class="box errormessage" %) 5211 -((( 5212 -**DELETE /api/v3/agroLands/{id}** 5213 -))) 5214 - 5215 -Пример запроса: 5216 -id ~/~/ Идентификатор поля 5217 - 5218 -Пример ответа: 5219 - 5220 -((( 5221 -200 ~/~/ Успех 5222 -))) 5223 - 5224 -((( 5225 5225 5226 5226 ))) 5227 5227 5228 5228 ((( 5229 -((( 5230 -((( 5231 - 5232 -))) 5233 - 5234 -((( 5235 5235 == **Изменение поля** == 5236 5236 5237 5237 (% class="box infomessage" %) 5238 5238 ((( 5239 - **PUT /api/v3/agroLands**5005 +PUT **/api/v3/agroLands** 5240 5240 ))) 5241 5241 5242 5242 Пример запроса: ... ... @@ -5373,11 +5373,11 @@ 5373 5373 ))) 5374 5374 5375 5375 5376 -== ** Редактирование года урожая5142 +== **Функция обновляет закрытие/открытие года урожая** == 5377 5377 5378 5378 (% class="box successmessage" %) 5379 5379 ((( 5380 - **POST /api/v3/agroLands/updateOpenCloseYear**5146 +POST **/api/v3/agroLands/updateOpenCloseYear** 5381 5381 ))) 5382 5382 5383 5383 Пример запроса: ... ... @@ -5480,17 +5480,23 @@ 5480 5480 ))) 5481 5481 5482 5482 5483 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5249 +== == 5250 + 5251 +((( 5252 + 5484 5484 ))) 5485 5485 ))) 5486 5486 ))) 5256 +))) 5487 5487 5258 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5259 + 5488 5488 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5489 5489 5490 5490 5491 5491 (% class="box infomessage" %) 5492 5492 ((( 5493 - **GET api/v3/Vehicles/recyclebin/all**5265 +GET api/v3/Vehicles/recyclebin/all 5494 5494 ))) 5495 5495 5496 5496 Метод возвращает полную информацию о списках всех объектов в корзине по пользователям, доступным агенту ... ... @@ -5525,11 +5525,11 @@ 5525 5525 ] 5526 5526 5527 5527 5528 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==5300 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5529 5529 5530 5530 (% class="box infomessage" %) 5531 5531 ((( 5532 - **POST**5304 +POST/api/v3/Vehicles/recyclebin/erase 5533 5533 ))) 5534 5534 5535 5535 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5571,7 +5571,7 @@ 5571 5571 5572 5572 (% class="box infomessage" %) 5573 5573 ((( 5574 - **POST**5346 +POST/api/v3/Vehicles/recyclebin/restore 5575 5575 ))) 5576 5576 5577 5577 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5623,618 +5623,7 @@ 5623 5623 ] 5624 5624 5625 5625 5626 -= **Раздел: Журнал заданий ** = 5627 5627 5628 - 5629 -== **Создание задания в Журнале заданий** == 5630 - 5631 -(% class="box infomessage" %) 5632 -((( 5633 -**POST /api/v3/vehicletasks** 5634 -))) 5635 - 5636 -Пример запроса: 5637 - 5638 -((( 5639 -{ 5640 - "vehicleId": 0, ~/~/ Идентификатор ТС 5641 - "description": "string", ~/~/ Описание 5642 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5643 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5644 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5645 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5646 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5647 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5648 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5649 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5650 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5651 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5652 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5653 - "cost": { 5654 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5655 - "Name": "string", ~/~/ Наименование 5656 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5657 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5658 - "Norm": 0 ~/~/ Норма внесения 5659 - }, 5660 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5661 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5662 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5663 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5664 - "deleted": true, ~/~/ Признак удаления 5665 - "extId": "string", 5666 - "GeoIds": [ ~/~/ Cвязанные поля 5667 - 0 5668 - ] 5669 -} 5670 -))) 5671 - 5672 - 5673 -Пример ответа: 5674 - 5675 -{ 5676 - "vehicleId": 0, ~/~/ Идентификатор ТС 5677 - "description": "string", ~/~/ Описание 5678 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5679 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5680 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5681 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5682 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5683 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5684 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5685 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5686 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5687 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5688 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5689 - "cost": { 5690 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5691 - "Name": "string", ~/~/ Наименование 5692 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5693 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5694 - "Norm": 0 ~/~/ Норма внесения 5695 - }, 5696 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5697 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5698 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5699 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5700 - "deleted": true, ~/~/ Признак удаления 5701 - "extId": "string", ~/~/ ExtId 5702 - "GeoIds": [ ~/~/ Связанные поля 5703 - 0 5704 - ] 5705 -} 5706 - 5707 - 5708 -== **Редактирование задания в Журнале заданий** == 5709 - 5710 -(% class="box successmessage" %) 5711 -((( 5712 -**PUT /api/v3/vehicletasks** 5713 -))) 5714 - 5715 -Пример запроса: 5716 - 5717 -((( 5718 -{ 5719 - "vehicleId": 0, ~/~/ Идентификатор ТС 5720 - "description": "string", ~/~/ Описание 5721 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5722 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5723 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5724 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5725 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5726 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5727 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5728 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5729 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5730 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5731 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5732 - "cost": { 5733 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5734 - "Name": "string", ~/~/ Наименование 5735 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5736 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5737 - "Norm": 0 ~/~/ Норма внесения 5738 - }, 5739 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5740 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5741 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5742 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5743 - "deleted": true, ~/~/ Признак удаления 5744 - "extId": "string", ~/~/ ExtId 5745 - "GeoIds": [ ~/~/ Связанные поля 5746 - 0 5747 - ] 5748 -} 5749 -))) 5750 - 5751 - 5752 -Пример ответа: 5753 - 5754 -{ 5755 - "vehicleId": 0, ~/~/ Идентификатор ТС 5756 - "description": "string", ~/~/ Описание 5757 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5758 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5759 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5760 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5761 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5762 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5763 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5764 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5765 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5766 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5767 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5768 - "cost": { 5769 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5770 - "Name": "string", ~/~/ Наименование 5771 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5772 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5773 - "Norm": 0 ~/~/ Норма внесения 5774 - }, 5775 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5776 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5777 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5778 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5779 - "deleted": true, ~/~/ Признак удаления 5780 - "extId": "string", ~/~/ ExtId 5781 - "GeoIds": [ ~/~/ Связанные поля 5782 - 0 5783 - ] 5784 -} 5785 - 5786 - 5787 -== **Удаление задания в Журнале заданий** == 5788 - 5789 -(% class="box warningmessage" %) 5790 -((( 5791 -**DELETE /api/v3/vehicletasks** 5792 -))) 5793 - 5794 -Пример запроса: 5795 - 5796 -((( 5797 -[ 5798 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 5799 -] 5800 -))) 5801 - 5802 -((( 5803 - 5804 -))) 5805 - 5806 -Пример ответа: 5807 - 5808 -{ 5809 - "vehicleId": 0, ~/~/ Идентификатор ТС 5810 - "description": "string", ~/~/ Описание 5811 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5812 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5813 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5814 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5815 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5816 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5817 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5818 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5819 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5820 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5821 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5822 - "cost": { 5823 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5824 - "Name": "string", ~/~/ Наименование 5825 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5826 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5827 - "Norm": 0 ~/~/ Норма внесения 5828 - }, 5829 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5830 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5831 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5832 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5833 - "deleted": true, ~/~/ Признак удаления 5834 - "extId": "string", ~/~/ ExtId 5835 - "GeoIds": [ ~/~/ Связанные поля 5836 - 0 5837 - ] 5838 -} 5839 - 5840 - 5841 -== **Получение списка Журнала заданий** == 5842 - 5843 -(% class="box infomessage" %) 5844 -((( 5845 -**POST /api/v3/vehicletasks/getbyperiod** 5846 -))) 5847 - 5848 -Пример запроса: 5849 - 5850 -((( 5851 -{ 5852 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 5853 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 5854 - "TimeZone": 0, ~/~/ Часовой пояс. 5855 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 5856 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 5857 - ], 5858 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 5859 - 0 5860 - ], 5861 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 5862 - 0 5863 - ], 5864 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 5865 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 5866 -} 5867 -))) 5868 - 5869 - 5870 -Пример ответа: 5871 - 5872 -((( 5873 -{ 5874 - "total": 0, ~/~/ Общее количество записей 5875 - "pages": 0, ~/~/ Общее количество страниц 5876 - "currentPage": 0, ~/~/ Текущая страница 5877 - "items": [ ~/~/ Записи 5878 - { 5879 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5880 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 5881 - "name": "string", ~/~/ Название задания. 5882 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 5883 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 5884 - "workKind": "string", ~/~/ Вид работ 5885 - "techOp": "string", ~/~/ Тех. операция 5886 - "trailerModel": "string", ~/~/ Модель агрегата 5887 - "width": "string", ~/~/ Ширина, м 5888 - "speed": "string", ~/~/ Тех. скорость 5889 - "fields": "string", ~/~/ Поля 5890 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 5891 - "vehicles": "string", ~/~/ Объект-модель 5892 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 5893 - "drivers": "string", ~/~/ Водители 5894 - "tmc": "string", ~/~/ ТМЦ 5895 - "client": "string", ~/~/ Клиент 5896 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 5897 - "dep": "string", ~/~/ Подразделение 5898 - "geoIds": [ ~/~/ Связанные поля 5899 - 0 5900 - ] 5901 - } 5902 - ] 5903 -} 5904 -))) 5905 - 5906 - 5907 -= **Раздел: Локатор ** = 5908 - 5909 - 5910 -== **Получение списка локаторов, доступных пользователю ** == 5911 - 5912 -(% class="box infomessage" %) 5913 -((( 5914 -**GET /api/v3/locators** 5915 -))) 5916 - 5917 -В заголовках запроса: X-Auth: Токен авторизации 5918 - 5919 - 5920 -Пример ответа: 5921 - 5922 -((( 5923 -[ 5924 - { 5925 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5926 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5927 - "agentName": "string", ~/~/ Наименование агента. 5928 - "isEnabled": true, ~/~/ Активен 5929 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5930 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5931 - "name": "string", ~/~/ Наименование 5932 - "status": 0, ~/~/ 5933 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5934 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5935 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5936 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5937 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5938 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5939 - "url": "string", ~/~/ Ссылка 5940 - "language": 0, ~/~/ Язык. 5941 - "vehiclesCount": 0, ~/~/ Количество объектов. 5942 - "geozonesCount": 0, ~/~/ Количество геозон. 5943 - "fieldsCount": 0 ~/~/ Количество полей. 5944 - } 5945 -] 5946 -))) 5947 - 5948 - 5949 - 5950 -== **Создание локатора** == 5951 - 5952 -(% class="box successmessage" %) 5953 -((( 5954 -**POST /api/v3/locators** 5955 -))) 5956 - 5957 -Пример запроса: 5958 - 5959 -((( 5960 -{ 5961 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5962 - "isEnabled": true, ~/~/ Активность 5963 - "name": "string", ~/~/ Наименование локатора 5964 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 5965 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 5966 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5967 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5968 - "url": "string", ~/~/ Ссылка 5969 - "language": 0 ~/~/ Язык 5970 -} 5971 -))) 5972 - 5973 - 5974 -Пример ответа: 5975 - 5976 -((( 5977 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 5978 -))) 5979 - 5980 - 5981 - 5982 -== **Изменение локатора** == 5983 - 5984 -(% class="box infomessage" %) 5985 -((( 5986 -**PUT /api/v3/locators** 5987 -))) 5988 - 5989 -Пример запроса: 5990 - 5991 -((( 5992 -{ 5993 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 5994 - "isEnabled": true, ~/~/ Активность 5995 - "name": "string", ~/~/ Наименование 5996 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 5997 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 5998 - "validity": 0, ~/~/ Срок действия в днях (1-90) 5999 - "autoProlongation": true, ~/~/ Автопродление срока действия 6000 - "url": "string", ~/~/ Ссылка 6001 - "language": 0 ~/~/ Язык 6002 -} 6003 -))) 6004 - 6005 - 6006 -Пример ответа: 6007 - 6008 -200 ~/~/ Success 6009 - 6010 - 6011 -== **Удалить локатор** == 6012 - 6013 -(% class="box warningmessage" %) 6014 -((( 6015 -**DELETE /api/v3/locators** 6016 -))) 6017 - 6018 -Пример запроса: 6019 - 6020 -((( 6021 -[ 6022 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6023 -] 6024 -))) 6025 - 6026 - 6027 - 6028 -= **Раздел: Яндекс Маршруты** = 6029 - 6030 - 6031 -== **Возвращение списка маршрутов** == 6032 - 6033 -(% class="box infomessage" %) 6034 -((( 6035 -**GET /api/v3/TransportRoutes** 6036 -))) 6037 - 6038 -Пример запроса: 6039 -Id ~/~/ Идентификатор поля 6040 - 6041 - 6042 -Пример ответа: 6043 - 6044 -((( 6045 -[ 6046 - { 6047 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6048 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6049 - "name": "string", ~/~/ Наименование маршрута. 6050 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6051 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6052 - 0 6053 - ] 6054 - } 6055 -] 6056 -))) 6057 - 6058 - 6059 - 6060 -== **Добавить маршрут** == 6061 - 6062 -(% class="box infomessage" %) 6063 -((( 6064 -**POST /api/v3/TransportRoutes** 6065 -))) 6066 - 6067 -Пример запроса: 6068 -{ 6069 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6070 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6071 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6072 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6073 - 0 6074 - ] 6075 -} 6076 - 6077 - 6078 -Пример ответа: 6079 - 6080 -((( 6081 -{ 6082 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6083 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6084 - "name": "string", ~/~/ Определяет наименование маршрута 6085 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6086 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6087 - 0 6088 - ] 6089 -} 6090 -))) 6091 - 6092 - 6093 -== **Обновление маршрута** == 6094 - 6095 -(% class="box successmessage" %) 6096 -((( 6097 -**PUT /api/v3/TransportRoutes** 6098 -))) 6099 - 6100 -Пример запроса: 6101 - 6102 -((( 6103 -{ 6104 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6105 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6106 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6107 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6108 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6109 - 0 6110 - ] 6111 -} 6112 -))) 6113 - 6114 - 6115 -Пример ответа: 6116 - 6117 -((( 6118 -{ 6119 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6120 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6121 - "name": "string", ~/~/ Определяет наименование маршрута 6122 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6123 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6124 - 0 6125 - ] 6126 -} 6127 -))) 6128 - 6129 - 6130 -== **Получить связки маршрутов ТС** == 6131 - 6132 -(% class="box infomessage" %) 6133 -((( 6134 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6135 -))) 6136 - 6137 -Пример запроса: 6138 - 6139 -((( 6140 -[ 6141 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6142 -] 6143 -))) 6144 - 6145 - 6146 -Пример ответа: 6147 - 6148 -((( 6149 -[ 6150 - { 6151 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6152 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6153 - } 6154 -] 6155 -))) 6156 - 6157 - 6158 -== **Удалить маршрут** == 6159 - 6160 -(% class="box warningmessage" %) 6161 -((( 6162 -**DELETE /api/v3/TransportRoutes/{id}** 6163 -))) 6164 - 6165 -Пример запроса: 6166 -Id ~/~/ Идентификатор поля 6167 - 6168 - 6169 -==== ==== 6170 - 6171 -= **Раздел: Управление доступа к машинам** = 6172 - 6173 - 6174 -== Получение списка транспортных средств видимых пользователю == 6175 - 6176 -(% class="box infomessage" %) 6177 -((( 6178 -**GET /api/v3/UserVisibleVehicles/{userId}** 6179 -))) 6180 - 6181 -Пример ответа: 6182 - 6183 -((( 6184 -{ 6185 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6186 - 0 6187 - ] 6188 -} 6189 -))) 6190 - 6191 - 6192 - 6193 -== Задает видимость транспортных средств пользователю == 6194 - 6195 -(% class="box infomessage" %) 6196 -((( 6197 -**POST /api/v3/UserVisibleVehicles** 6198 -))) 6199 - 6200 -Пример запроса: 6201 - 6202 -((( 6203 -((( 6204 -{ 6205 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6206 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6207 - 0 6208 - ] 6209 -} 6210 -))) 6211 - 6212 -((( 6213 - 6214 -))) 6215 - 6216 -((( 6217 - 6218 -))) 6219 - 6220 -((( 6221 -Пример ответа : 6222 -))) 6223 - 6224 -((( 6225 - 6226 -))) 6227 - 6228 -((( 6229 -200 ~/~/ Success 6230 -))) 6231 -))) 6232 - 6233 - 6234 - 6235 - 6236 - 6237 - 6238 6238 (% class="box" lang="en-US" style="text-align: center;" %) 6239 6239 ((( 6240 6240 (% 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]] **