Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/08/08 13:28
<
>
edited by Андрей Калиновский
on 2025/07/29 13:53
on 2025/07/29 13:53
edited by Андрей Калиновский
on 2024/12/20 16:01
on 2024/12/20 16:01
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" %)Идентификатор клиента-родителя ... ... @@ -454,7 +454,7 @@ 454 454 [ 455 455 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 456 456 ], 457 - "language": 1~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский440 + "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 458 458 } 459 459 { 460 460 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -766,8 +766,6 @@ 766 766 (% style="text-align:left" %) 767 767 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 768 768 769 -= = 770 - 771 771 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 772 772 773 773 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -879,7 +879,7 @@ 879 879 { 880 880 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 881 881 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 882 - "deleted": false,863 + "deleted": true, 883 883 "extId": "string", 884 884 "name": "string", 885 885 "picture": "string", ... ... @@ -898,7 +898,7 @@ 898 898 { 899 899 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 900 900 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 901 - "deleted": false,882 + "deleted": true, 902 902 "extId": "string", 903 903 "name": "string", 904 904 "picture": "string", ... ... @@ -932,7 +932,7 @@ 932 932 (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models** 933 933 ))) 934 934 935 -(% style="color:#000000" %)Метод позволяет изменить статус модели, указанного в запросе.916 +(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе. 936 936 937 937 (% style="color:#000000" %)Метод запроса: **PUT** 938 938 ... ... @@ -999,7 +999,7 @@ 999 999 (% lang="en-US" %)**DELETE /api/v3/models/{Id}** 1000 1000 ))) 1001 1001 1002 -(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалитьмодель, указанного в строке запроса.983 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 1003 1003 1004 1004 (% style="color:#000000" %)Метод запроса: **DELETE** 1005 1005 ... ... @@ -1040,17 +1040,6 @@ 1040 1040 1041 1041 ((( 1042 1042 { 1043 - 1044 -((( 1045 - "showLineTrackWhenNoCoords": true, ~/~/ Обозначать трек при отсутствии координат. 1046 - "IsSackEnabled": true, ~/~/ Определяет, должен ли внутренний сервер отвечать устройству сообщением SACK при получении сообщения от устройства 1047 -))) 1048 - 1049 -((( 1050 - ~/~/Используется только на ТС с типом устройства quecklink gv56, quecklink gv58, quecklink 1051 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1052 -))) 1053 - 1054 1054 "vehicleId": "", ~/~/ ID объекта 1055 1055 "name": "", ~/~/ Имя объекта 1056 1056 "imei": "", ~/~/ IMEI объекта ... ... @@ -1145,7 +1145,6 @@ 1145 1145 ], 1146 1146 "showInTooltip": true, ~/~/ Отображать в подсказке 1147 1147 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1148 - "color": "string", ~/~/ Код цвета датчиков 1149 1149 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1150 1150 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1151 1151 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1203,21 +1203,11 @@ 1203 1203 "date": "2023-05-22T09:57:39.562Z", 1204 1204 "description": "string", 1205 1205 "additionalInfo": "string" 1206 - 1207 - (((1175 + } 1176 + ] 1208 1208 } 1209 - ], 1210 - "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1211 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1212 1212 ))) 1213 1213 1214 -((( 1215 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1216 -} 1217 - 1218 -))) 1219 -))) 1220 - 1221 1221 (% style="text-align:left" %) 1222 1222 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 1223 1223 ... ... @@ -1310,13 +1310,7 @@ 1310 1310 1311 1311 (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON 1312 1312 1313 -(% style="color:#000000" %){ 1314 - 1315 - 1316 -((( 1317 - "vehicleId": 0, ~/~/ ID ТС 1318 -))) 1319 - 1272 +(% style="color:#000000" %){(%%) 1320 1320 "parentId": "" , ~/~/ ID клиента 1321 1321 "name": "" , ~/~/ имя ТС 1322 1322 "imei": "" , ~/~/ IMEI ... ... @@ -1409,7 +1409,6 @@ 1409 1409 ], 1410 1410 "showInTooltip": true, ~/~/ Отображать в подсказке 1411 1411 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1412 - "color": "string", ~/~/ код цвета датчиков 1413 1413 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1414 1414 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1415 1415 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1459,19 +1459,10 @@ 1459 1459 "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1460 1460 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1461 1461 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1462 - 1463 -((( 1464 - } 1465 - ], 1466 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 1467 -))) 1468 - 1469 -((( 1470 - ~/~/ 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1414 + } 1415 + ] 1471 1471 } 1472 -))) 1473 1473 1474 - 1475 1475 (% style="color:#000000" %)Ответ: 1476 1476 1477 1477 ... ... @@ -1580,7 +1580,6 @@ 1580 1580 ], 1581 1581 "showInTooltip": true, ~/~/ Отображение в подсказке 1582 1582 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1583 - "color": "string", ~/~/ код цвета датчиков 1584 1584 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1585 1585 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 1586 1586 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -1617,7 +1617,7 @@ 1617 1617 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1618 1618 } 1619 1619 ], 1620 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 -По датчику Моточасов, 2 -По датчику относительных Моточасов1562 + "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1621 1621 } 1622 1622 ))) 1623 1623 ))) ... ... @@ -1630,6 +1630,77 @@ 1630 1630 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1631 1631 1632 1632 1575 +== **Импортировать историю ТС (Асинхронный запрос)** == 1576 + 1577 +(% class="box successmessage" %) 1578 +((( 1579 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1580 +))) 1581 + 1582 +Метод запроса: **POST** 1583 + 1584 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1585 + 1586 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1587 + 1588 + 1589 +Ответ: 1590 + 1591 +{ 1592 + 1593 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1594 + 1595 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1596 + 1597 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1598 + 1599 + "Message": "string", ~/~/ Информация о выполнении запроса 1600 + 1601 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1602 + 1603 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1604 + 1605 + "Data": "string" ~/~/ Данные 1606 + 1607 +} 1608 + 1609 + 1610 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 1611 + 1612 +(% class="box infomessage" %) 1613 +((( 1614 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1615 +))) 1616 + 1617 +Метод запроса: **GET** 1618 + 1619 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1620 + 1621 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1622 + 1623 + 1624 +Ответ: 1625 + 1626 +{ 1627 + 1628 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1629 + 1630 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 1631 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1632 + 1633 + "Message": "string", ~/~/ Информация о выполнении запроса 1634 + 1635 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1636 + 1637 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1638 + 1639 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1640 + 1641 + "Data": "string" ~/~/ Данные 1642 + 1643 +} 1644 + 1645 + 1633 1633 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1634 1634 1635 1635 (% class="box infomessage" %) ... ... @@ -1775,6 +1775,7 @@ 1775 1775 "stage": "", ~/~/ Состояние 1776 1776 (% style="color:#000000" %) } 1777 1777 1791 +== == 1778 1778 1779 1779 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1780 1780 ... ... @@ -1851,19 +1851,9 @@ 1851 1851 1852 1852 "drivers": [ ~/~/ Водители 1853 1853 { 1854 - 1855 -((( 1856 - "vehicleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор объекта. 1857 - "inputNumber": 0, ~/~/ № входа. 1858 - "createTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени создания назначения. 1859 - "comment": "string", ~/~/ Комментарий. 1860 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор назначения. 1861 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя. 1862 - "beginTime": "2024-12-23T10:45:04.961Z", ~/~/ Момент времени начала назначения. 1863 - "endTime": "2024-12-23T10:45:04.961Z" ~/~/ Момент времени окончания назначения. 1864 -))) 1865 - 1866 - } 1868 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1869 + "isDefault": true 1870 + } 1867 1867 ], 1868 1868 "commandTemplates": [ ~/~/ Шаблон команды 1869 1869 { ... ... @@ -1899,11 +1899,6 @@ 1899 1899 ], 1900 1900 "showInTooltip": true, ~/~/ Отображать в подсказке 1901 1901 "showLastValid": true, ~/~/ Отображать последнее валидное значение 1902 - 1903 -((( 1904 - "color": "string",** ~/~/ **Цвет датчика 1905 -))) 1906 - 1907 1907 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 1908 1908 "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания 1909 1909 "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION ... ... @@ -1950,12 +1950,7 @@ 1950 1950 "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1951 1951 "forReport": true ~/~/ Отобразить произвольное поле в отчете 1952 1952 } 1953 - 1954 -((( 1955 - ], 1956 - "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - По датчику зажигания, 1 - По датчику Моточасов, 2 - По датчику относительных Моточасов 1957 -))) 1958 - 1952 + ] 1959 1959 } 1960 1960 1961 1961 ... ... @@ -2093,11 +2093,6 @@ 2093 2093 ], 2094 2094 "showInTooltip": true, ~/~/ Отображение в подсказке 2095 2095 "showLastValid": true, ~/~/ Отображать последнее валидное значение 2096 - 2097 -((( 2098 - "color": "string", ~/~/ цвет уведомлений 2099 -))) 2100 - 2101 2101 "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива 2102 2102 "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания 2103 2103 "agrFunction": 0, ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION ... ... @@ -2391,7 +2391,7 @@ 2391 2391 Тело запроса: 2392 2392 2393 2393 { 2394 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2383 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2395 2395 "vehicleIds": [0], ~/~/ Список ID объектов 2396 2396 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2397 2397 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2414,8 +2414,6 @@ 2414 2414 "motohours": 0, ~/~/ Моточасы за период, секунды 2415 2415 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2416 2416 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2417 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2418 - 2419 2419 } 2420 2420 ] 2421 2421 } ... ... @@ -2438,7 +2438,7 @@ 2438 2438 Тело запроса: 2439 2439 2440 2440 { 2441 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2428 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2442 2442 "vehicleIds": [0], ~/~/ Список ID объектов 2443 2443 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2444 2444 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2457,12 +2457,8 @@ 2457 2457 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2458 2458 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2459 2459 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2460 - "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2461 - "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2462 2462 "fuelConsumption": 0, ~/~/ Расход топлива 2463 2463 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2464 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2465 - 2466 2466 } 2467 2467 ] 2468 2468 } ... ... @@ -2508,8 +2508,7 @@ 2508 2508 "model": "string", ~/~/ Модель объекта 2509 2509 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2510 2510 { 2511 - "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 2512 - 2494 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2513 2513 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2514 2514 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2515 2515 "valueFuel": 0, ~/~/ Количество ... ... @@ -2588,50 +2588,26 @@ 2588 2588 В заголовках запроса: X-Auth: Токен авторизации 2589 2589 2590 2590 2591 -В массивеуказываемid объектов через запятую2573 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2592 2592 2593 2593 Ответ: 2594 - 2595 -[ 2596 2596 { 2597 - "vehicleId": 55728, ~/~/2598 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",Guidобъекта2599 - "vehicleNumber": " 0105 КМ",2600 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",датапоступления данных2601 - "recordTime": "202 5-06-27T12:37:19Z",датаформированиеданных2602 - "state": 4,2603 - "speed": 31,2604 - "course": 116,2605 - "latitude": 45.722128,2606 - "longitude": 39.800432,2607 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/2608 - "geozones": [ ~/~/ 2577 + "vehicleId": 0, ~/~/Идентификатор объекта. 2578 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2579 + "vehicleNumber": "string",~/~/Номер объекта. 2580 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2581 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2582 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2583 + "speed": 0,~/~/Скорость объекта. 2584 + "course": 0,~/~/Курс движения [0;360] 2585 + "latitude": 0,~/~/Широта [-90°;90°]. 2586 + "longitude": 0,~/~/Долгота [-180°;180°]. 2587 + "address": "string",~/~/Адрес. 2588 + "geozones": [ ~/~/Сведения по геозонам. 2609 2609 { 2610 - "id": 10225647, ~/~/ ID Геозоны 2611 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2612 - }, 2613 - { 2614 - "id": 10282875, ~/~/ ID Геозоны 2615 - "name": "Ё2" ~/~/ Наименование геозоны 2616 - }, 2617 - { 2618 - "id": 10226240, ~/~/ ID Геозоны 2619 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2620 - }, 2621 - { 2622 - "id": 9747869, ~/~/ ID Геозоны 2623 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2624 - }, 2625 - { 2626 - "id": 10221123, ~/~/ ID Геозоны 2627 - "name": "53r" ~/~/ Наименование геозоны 2628 - }, 2629 - { 2630 - "id": 10197638, ~/~/ ID Геозоны 2631 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2590 + "id": 0, 2591 + "name": "string" 2632 2632 } 2633 - ] 2634 - } 2635 2635 2636 2636 2637 2637 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = ... ... @@ -2762,35 +2762,6 @@ 2762 2762 } 2763 2763 ] 2764 2764 2765 - 2766 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2767 - 2768 -(% class="box successmessage" %) 2769 -((( 2770 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2771 -))) 2772 - 2773 -(% style="color:#000000" %)Метод запроса: **PUT** 2774 - 2775 -Пример запроса: 2776 - 2777 -((( 2778 -{ 2779 - "id": 0, ~/~/ Идентификатор объекта геозоны 2780 - "name": "string", ~/~/ Наименование объекта геозоны 2781 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2782 - "description": "string", ~/~/ Описание объекта геозоны 2783 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2784 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2785 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2786 -} 2787 -))) 2788 - 2789 - 2790 -Пример ответа: 2791 - 2792 -200 ~/~/ Success 2793 - 2794 2794 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2795 2795 2796 2796 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -2822,7 +2822,7 @@ 2822 2822 "id": 0, ~/~/ ID уведомления 2823 2823 "name": "string", ~/~/ Название уведомления 2824 2824 "active": true, ~/~/ Состояние true - активен, false - деактивирован 2825 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО , 13 - Назначение водителя)2754 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2826 2826 "userId": "", ~/~/ Пользователь, создавший уведомление 2827 2827 "parentId": "", ~/~/ Идентификатор клиента 2828 2828 "parentName": "string" ~/~/ Имя клиента ... ... @@ -2829,155 +2829,6 @@ 2829 2829 } 2830 2830 ] 2831 2831 2832 - 2833 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2834 - 2835 -(% class="box infomessage" %) 2836 -((( 2837 -**POST /api/v3/notifications** 2838 -))) 2839 - 2840 -Метод запроса **POST** 2841 - 2842 -(% style="text-align: left;" %) 2843 -(% style="color:#000000" %)Пример запроса 2844 - 2845 -((( 2846 -{ 2847 - "id": 0, ~/~/ ID правила 2848 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2849 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2850 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2851 - "name": "string", ~/~/ Имя правила 2852 - "active": true, ~/~/ Активность правила 2853 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2854 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2855 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2856 - ], 2857 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2858 - 0 2859 - ], 2860 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2861 - 0 2862 - ], 2863 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2864 - 0 2865 - ], 2866 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2867 - "additionalProp1": "string", 2868 - "additionalProp2": "string", 2869 - "additionalProp3": "string" 2870 - }, 2871 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2872 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2873 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2874 - ], 2875 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2876 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2877 - "string" 2878 - ], 2879 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2880 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2881 - { 2882 - "id": 0, ~/~/ Идентификатор участника чата. 2883 - "info": "string" ~/~/ Дополнительные сведения. 2884 - } 2885 - ], 2886 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2887 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2888 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2889 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2890 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2891 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2892 - "timezone": 0, ~/~/ часовой пояс 2893 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2894 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2895 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2896 - { 2897 - "type": 0, ~/~/ 0 - Нет, 1 - Превышение скорости, 2 - Вход в геозону, 3 - выход из геозоны, 4 - Паническая активация, 5 - Дискретный датчик, 6 - Отключение дискретного датчика, 7 - Работа аналогового датчика, 8 - Отсутствуют данные, 9 - Отсутствуют координаты, 10 - Бездействие, 11 - Адрес объекта, 12 - Заканчивается топливо, 13 - Заправка, 14 - Превышение скорости, 15 - Превышение скорости, 16 - Превышение нормы, 17 - Возврат к бездействию, 18 - Адрес объекта, 19 - Отсутствуют данные, 20 - отсутствуют координаты, 21 - Запланировано техническое обслуживание автомобиля, 22 - Требуется техническое обслуживание автомобиля, 23 - Техническое обслуживание автомобиля завершено, 24 - Открыто назначение водителя, 25 - Закрыто назначение водителя, 255 - Срок действия правила истек 2898 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2899 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2900 - "additionalProp1": "string", 2901 - "additionalProp2": "string", 2902 - "additionalProp3": "string" 2903 - } 2904 - } 2905 - ] 2906 -} 2907 -))) 2908 - 2909 -((( 2910 - 2911 -))) 2912 - 2913 -((( 2914 - 2915 -))) 2916 - 2917 -Ответ: 2918 - 2919 -{ 2920 - "id": 0, ~/~/ ID правила 2921 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2922 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2923 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2924 - "name": "string", ~/~/ Имя правила 2925 - "active": true, ~/~/ Активность правила 2926 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2927 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2928 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2929 - ], 2930 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2931 - 0 2932 - ], 2933 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2934 - 0 2935 - ], 2936 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2937 - 0 2938 - ], 2939 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2940 - "additionalProp1": "string", 2941 - "additionalProp2": "string", 2942 - "additionalProp3": "string" 2943 - }, 2944 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2945 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2946 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2947 - ], 2948 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2949 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2950 - "string" 2951 - ], 2952 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2953 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2954 - { 2955 - "id": 0, ~/~/ Идентификатор участника чата. 2956 - "info": "string" ~/~/ Дополнительные сведения. 2957 - } 2958 - ], 2959 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2960 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2961 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2962 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2963 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2964 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2965 - "timezone": 0, ~/~/ часовой пояс 2966 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2967 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2968 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2969 - { 2970 - "type": 0, ~/~/ 0 - Нет, 1 - Превышение скорости, 2 - Вход в геозону, 3 - выход из геозоны, 4 - Паническая активация, 5 - Дискретный датчик, 6 - Отключение дискретного датчика, 7 - Работа аналогового датчика, 8 - Отсутствуют данные, 9 - Отсутствуют координаты, 10 - Бездействие, 11 - Адрес объекта, 12 - Заканчивается топливо, 13 - Заправка, 14 - Превышение скорости, 15 - Превышение скорости, 16 - Превышение нормы, 17 - Возврат к бездействию, 18 - Адрес объекта, 19 - Отсутствуют данные, 20 - отсутствуют координаты, 21 - Запланировано техническое обслуживание автомобиля, 22 - Требуется техническое обслуживание автомобиля, 23 - Техническое обслуживание автомобиля завершено, 24 - Открыто назначение водителя, 25 - Закрыто назначение водителя, 255 - Срок действия правила истек 2971 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2972 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2973 - "additionalProp1": "string", 2974 - "additionalProp2": "string", 2975 - "additionalProp3": "string" 2976 - } 2977 - } 2978 - ] 2979 -} 2980 - 2981 2981 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2982 2982 2983 2983 (% class="box infomessage" %) ... ... @@ -4195,12 +4195,16 @@ 4195 4195 Тело запроса: 4196 4196 4197 4197 { 4198 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4199 - "Balance": 0 ~/~/ Значение баланса.3978 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3979 + "Balance": 0 4200 4200 } 4201 4201 4202 4202 Ответ: Success 4203 4203 3984 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3985 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3986 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3987 + 4204 4204 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4205 4205 4206 4206 (% class="box warningmessage" %) ... ... @@ -4212,29 +4212,16 @@ 4212 4212 4213 4213 Тело запроса: 4214 4214 4215 -((( 4216 4216 { 4217 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4218 - "a mount": 0~/~/ Сумма пополнения баланса4000 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4001 + "Balance": 0 4219 4219 } 4220 -))) 4221 4221 4222 -((( 4223 - 4224 -))) 4225 - 4226 4226 Ответ: Success 4227 4227 4228 -((( 4229 -{ 4230 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4231 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4232 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4233 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4234 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4235 - "Description": "string" ~/~/ Описание корректировки. 4236 -} 4237 -))) 4006 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4007 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4008 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4238 4238 4239 4239 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4240 4240 ... ... @@ -4247,25 +4247,16 @@ 4247 4247 4248 4248 Тело запроса: 4249 4249 4250 -((( 4251 4251 { 4252 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4253 - "a mount": 0~/~/ Сумма списания с баланса4022 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4023 + "Balance": 0 4254 4254 } 4255 -))) 4256 4256 4257 4257 Ответ: Success 4258 4258 4259 -((( 4260 -{ 4261 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4262 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4263 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4264 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4265 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4266 - "Description": "string" ~/~/ Описание корректировки 4267 -} 4268 -))) 4028 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4029 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4030 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4269 4269 4270 4270 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4271 4271 ... ... @@ -4276,35 +4276,28 @@ 4276 4276 4277 4277 Тело запроса: 4278 4278 4279 -((( 4280 4280 { 4281 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4282 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4283 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4284 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4285 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4286 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4042 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4043 + "CalculationType": 0, 4044 + "PermissibleBalance": 0, 4045 + "DefermentDays": 0, 4046 + "SendUiNotifications": true, 4047 + "SendEmailNotifications": true, 4048 + "IsPrivate": true, 4287 4287 } 4288 -))) 4289 4289 4290 -((( 4291 - 4292 -))) 4293 - 4294 4294 Ответ: Success 4295 4295 4296 -((( 4297 -{ 4298 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4299 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4300 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4301 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4302 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4303 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4304 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4305 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4306 -} 4053 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4054 +|ClientId|Идентификатор клиента 4055 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4056 +|PermissibleBalance|Допустимый баланс 4057 +|DefermentDays|((( 4058 +Отсрочка, количество дней 4307 4307 ))) 4060 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4061 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4062 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4308 4308 4309 4309 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4310 4310 ... ... @@ -4316,68 +4316,35 @@ 4316 4316 Тело запроса: 4317 4317 4318 4318 { 4319 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4320 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4321 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4074 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4075 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4076 + "Features": [ 4322 4322 { 4323 - "Feature": "string", ~/~/ Код услуги.4324 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4325 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4326 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4327 - "Price": 0, ~/~/ Цена за единицу.4328 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4329 - "PeriodValue": 0, ~/~/ Значение периода.4330 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)4078 + "Feature": "string", 4079 + "IsEnabled": true, 4080 + "IsFactual": true, 4081 + "Limit": 0, 4082 + "Price": 0, 4083 + "DebitDate": "2023-10-18T13:26:58.987Z", 4084 + "PeriodValue": 0, 4085 + "PeriodType": 0 4331 4331 } 4332 4332 ] 4333 4333 } 4334 4334 4335 - 4336 4336 Ответ: Success 4337 4337 4338 -((( 4339 -{ 4340 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4341 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4342 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4343 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4344 - "Name": "string", ~/~/ Наименование. 4345 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4346 - "Constraint": { ~/~/ Ограничения по тарифу 4347 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4348 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4349 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4350 - }, 4351 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4352 - { 4353 - "Feature": "string", ~/~/Код услуги. 4354 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4355 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4356 - "Price": 0, ~/~/ Цена за единицу. 4357 - "PeriodValue": 0, ~/~/ Значение периода. 4358 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4359 - } 4360 - ], 4361 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4362 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4363 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4364 - }, 4365 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4366 - { 4367 - "Feature": "string", ~/~/ Код услуги. 4368 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4369 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4370 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4371 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4372 - "Price": 0, ~/~/ Цена за единицу. 4373 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4374 - "PeriodValue": 0, ~/~/ Значение периода. 4375 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4376 - "Quantity": 0 ~/~/ Количество использования услуги. 4377 - } 4378 - ] 4379 -} 4380 -))) 4092 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4093 +|ClientId|Идентификатор клиента 4094 +|PlanId|Идентификатор тарифного плана 4095 +|Feature|Код услуги 4096 +|IsEnabled|Признак, определяющий активирована ли услуга 4097 +|IsFactual|Признак, определяющий расчёт по факту 4098 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4099 +|Price|Цена за единицу. 4100 +|DebitDate|Следующий момент времени списания с баланса за услугу. 4101 +|PeriodValue|Значение периода. 4102 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4381 4381 4382 4382 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4383 4383 ... ... @@ -4482,43 +4482,6 @@ 4482 4482 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4483 4483 |msgCount|Кол-во обработанных сообщений всего 4484 4484 4485 -== **Импортировать историю ТС (Асинхронный запрос)** == 4486 - 4487 -(% class="box successmessage" %) 4488 -((( 4489 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4490 -))) 4491 - 4492 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4493 - 4494 -Метод запроса: **POST** 4495 - 4496 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4497 - 4498 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4499 - 4500 - 4501 -Ответ: 4502 - 4503 -{ 4504 - 4505 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4506 - 4507 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4508 - 4509 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4510 - 4511 - "Message": "string", ~/~/ Информация о выполнении запроса 4512 - 4513 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4514 - 4515 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4516 - 4517 - "Data": "string" ~/~/ Данные 4518 - 4519 -} 4520 - 4521 - 4522 4522 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4523 4523 4524 4524 (% class="box infomessage" %) ... ... @@ -4536,59 +4536,10 @@ 4536 4536 "message": "string" 4537 4537 } 4538 4538 4539 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4540 -**Параметр** 4541 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4542 -**Описание** 4543 -))) 4544 -|((( 4545 -activity 4546 -)))|((( 4547 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4548 -))) 4549 -|((( 4550 -progress 4551 -)))|((( 4552 -Guid ТС 4553 -))) 4224 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4225 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4226 +|progress|Guid ТС 4554 4554 4555 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4556 - 4557 -(% class="box infomessage" %) 4558 -((( 4559 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4560 -))) 4561 - 4562 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4563 - 4564 -Метод запроса: **GET** 4565 - 4566 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4567 - 4568 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4569 - 4570 - 4571 -Ответ: 4572 - 4573 -{ 4574 - 4575 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4576 - 4577 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4578 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4579 - 4580 - "Message": "string", ~/~/ Информация о выполнении запроса 4581 - 4582 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4583 - 4584 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4585 - 4586 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4587 - 4588 - "Data": "string" ~/~/ Данные 4589 - 4590 -} 4591 - 4592 4592 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4593 4593 4594 4594 (% class="box infomessage" %) ... ... @@ -4747,7 +4747,7 @@ 4747 4747 4748 4748 (% class="box infomessage" %) 4749 4749 ((( 4750 - **POST /api/v3/fuelcards/transactions**4386 +POST /api/v3/fuelcards/transactions 4751 4751 ))) 4752 4752 4753 4753 Метод запроса: POST ... ... @@ -4785,32 +4785,7 @@ 4785 4785 "address": "string" ~/~/ Адрес АЗС 4786 4786 } 4787 4787 4788 -== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) == 4789 4789 4790 -(% class="box infomessage" %) 4791 -((( 4792 -**GET /api/v3/fuelcards** 4793 -))) 4794 - 4795 -Метод запроса: GET 4796 - 4797 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список 4798 - 4799 -Ответ: 4800 - 4801 -[ 4802 - { 4803 - "Name": "string", ~/~/ Определяет наименование карты. 4804 - "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора. 4805 - "Number": "string", ~/~/ Определяет № карты. 4806 - "Enabled": true, ~/~/ Определяет признак активности карты. 4807 - "Description": "string", ~/~/ Определяет описание карты. 4808 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты 4809 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 4810 - "deleted": true ~/~/ Признак удаления 4811 - } 4812 -] 4813 - 4814 4814 = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** = 4815 4815 4816 4816 ... ... @@ -5061,94 +5061,10 @@ 5061 5061 ] 5062 5062 5063 5063 5064 -== **Отчет трек-датчики** == 5065 - 5066 -(% class="box infomessage" %) 5067 -((( 5068 -**POST /api/v3/Reports/sensorsWorks** 5069 -))) 5070 - 5071 -**Пример запроса:** 5072 - 5073 -{ 5074 - "vehicleIds": [ ~/~/ Список ID объектов 5075 - 0 5076 - ], 5077 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 5078 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 5079 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5080 -} 5081 - 5082 -**Пример ответа:** 5083 - 5084 -((( 5085 -{ 5086 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 5087 - { 5088 - "vehicleId": 0, ~/~/ Идентификатор ТС 5089 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 5090 - { 5091 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 5092 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 5093 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 5094 - "name": "string", ~/~/ Наименование оборудования. 5095 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 5096 - "totalMileage": 0, ~/~/ Общий пробег. 5097 - "avgSpeed": 0 ~/~/ Средняя скорость. 5098 - } 5099 - ] 5100 - } 5101 - ] 5102 -} 5103 - 5104 - 5105 -== **Превышение скорости** == 5106 - 5107 -(% class="box infomessage" %) 5108 -((( 5109 -**POST /api/v3/Reports/overSpeedDuration** 5110 -))) 5111 - 5112 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 5113 - 5114 -Пример запроса: 5115 - 5116 -((( 5117 -{ 5118 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 5119 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 5120 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 5121 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5122 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 5123 -} 5124 -))) 5125 - 5126 -((( 5127 - 5128 -))) 5129 - 5130 -((( 5131 -Пример ответа: 5132 -))) 5133 - 5134 -((( 5135 -((( 5136 -[ 5137 - { 5138 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 5139 - "duration": 0, ~/~/ Продолжительность события в секундах 5140 - "maxSpeed": 0, ~/~/ Максимальная скорость 5141 - "speedLimit": 0 ~/~/ Ограничение скорости 5142 - } 5143 -] 5144 -))) 5145 -))) 5146 -))) 5147 - 5148 5148 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 5149 5149 5150 5150 5151 -== ** Запросспискаполей** ==4678 +== **Возвращает список полей** == 5152 5152 5153 5153 (% class="box successmessage" %) 5154 5154 ((( ... ... @@ -5211,24 +5211,141 @@ 5211 5211 } 5212 5212 ] 5213 5213 4741 + 4742 +))) 5214 5214 5215 -== ** Созданиеновогополя ** ==4744 +== **Получение поля по id** == 5216 5216 4746 +(% class="box infomessage" %) 4747 +((( 4748 +**GET /api/v3/agroLands/{id}** 4749 +))) 4750 + 4751 +Пример запроса: 4752 +id ~/~/ Идентификатор поля 4753 + 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 + 4848 +Пример запроса: 4849 +id ~/~/ Идентификатор поля 4850 + 4851 +Пример ответа: 4852 + 4853 +((( 4854 +200 ~/~/ Успех 4855 +))) 4856 + 4857 +((( 4858 + 4859 +))) 4860 + 4861 +((( 4862 +== **Сохранение поля** == 4863 + 5217 5217 (% class="box successmessage" %) 5218 5218 ((( 5219 5219 **POST /api/v3/agroLands** 5220 5220 ))) 5221 5221 5222 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 5223 -X-agent - ID клиента 5224 - 5225 5225 Пример запроса: 5226 5226 5227 5227 ((( 5228 5228 { 5229 5229 "extId": "string", 5230 - "shape": " {\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}",~/~/ Форма поля5231 - "shapeFormat": " geojson", ~/~/ Формат, в котором представлена форма поля4874 + "shape": "string", ~/~/ Форма поля 4875 + "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5232 5232 "display": "string", ~/~/ Настройки отображения 5233 5233 "year": 0, ~/~/ Год поля 5234 5234 "name": "string", ~/~/ Наименование ... ... @@ -5347,117 +5347,13 @@ 5347 5347 "perimetr": 0, ~/~/ Периметр, м 5348 5348 "createDate": "2024-12-20T08:19:59.743Z" ~/~/ Дата создания в бд 5349 5349 } 5350 - 5351 - 5352 5352 ))) 5353 -))) 5354 -))) 5355 5355 5356 -== **Получение поля по id** == 5357 - 5358 -(% class="box infomessage" %) 5359 5359 ((( 5360 -**GET /api/v3/agroLands/{id}** 5361 -))) 5362 - 5363 -Пример запроса: 5364 -id ~/~/ Идентификатор поля 5365 - 5366 -Пример ответа: 5367 - 5368 -((( 5369 -{ 5370 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5371 - "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5372 - "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5373 - "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5374 - "cropRotations": [ ~/~/ Данные по севообороту 5375 - { 5376 - "landId": 0, ~/~/ ID поля 5377 - "landName": "string", ~/~/ Название поля 5378 - "year": 0, ~/~/ Год урожая 5379 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5380 - "cultureName": "string", ~/~/ Название культуры 5381 - "productivity": 0, ~/~/ Урожайность 5382 - "area": 0, ~/~/ Площадь поля, Га 5383 - "total": 0, ~/~/ Валовый сбор 5384 - "productivityFact": 0, ~/~/ Фактическая урожайность 5385 - "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5386 - "totalFact": 0, ~/~/ Фактический валовый сбор 5387 - "start": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала работ 5388 - "sowing": "2024-12-20T07:45:52.611Z", ~/~/ Дата сева 5389 - "harvesting": "2024-12-20T07:45:52.611Z", ~/~/ Дата уборки урожая 5390 - "isyearplan": true, ~/~/ План года 5391 - "comment": "string" ~/~/ Комментарий 5392 - } 5393 - ], 5394 - "cropVegetation": [ ~/~/ История вегетации поля 5395 - { 5396 - "values": [ ~/~/ Данные вегетации и состояния посева 5397 - { 5398 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5399 - "ndvi": 0 ~/~/ Индекс вегетации 5400 - } 5401 - ], 5402 - "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5403 - { 5404 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5405 - "type": "string", ~/~/ Тип 5406 - "pictureid": "string" ~/~/ Идентификатор ресурса 5407 - } 5408 - ], 5409 - "states": [ ~/~/ Ключевые даты развития поля 5410 - { 5411 - "date": "2024-12-20T07:45:52.611Z", ~/~/ Дата 5412 - "state": 0 ~/~/ Статус 0 - Посев, 1 - Всходы, 2 - Сбор урожая 5413 - } 5414 - ] 5415 - } 5416 - ], 5417 - "endDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата закрытия года урожая 5418 - "counts": { 5419 - "fieldOperations": 0, ~/~/ Количество операций на поле 5420 - "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5421 - "facts": 0 ~/~/ Счётчик факта 5422 - }, 5423 - "planComment": "string", ~/~/ Комментарий к полю 5424 - "productivity": 0, ~/~/ Урожайность. 5425 - "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5426 -))) 5427 - 5428 -((( 5429 -((( 5430 - "startDate": "2024-12-20T07:45:52.611Z", ~/~/ Дата открытия года урожая 5431 - "year": 0, ~/~/ Год поля 5432 - "planState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5433 - "actualPlanState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5434 - "factState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5435 - "taskState": 0, ~/~/ Статус годового планирования участка (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5436 - "status": 0, ~/~/ Статус с/х поля (0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой) 5437 - "id": 0, ~/~/ Идентификатор объекта геозоны 5438 - "name": "string", ~/~/ Название объекта геозоны 5439 - "type": 0, ~/~/ Тип объекта геозоны 5440 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5441 - "fname": "string", ~/~/ Имя файла 5442 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5443 - "beginCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата начала расчетов для геозоны 5444 - "endCalc": "2024-12-20T07:45:52.611Z", ~/~/ Дата окончания расчетов для геозоны 5445 - "description": "string", ~/~/ Описание объекта геозоны 5446 - "area": 0, ~/~/ Площадь, м2 5447 - "perimetr": 0, ~/~/ Периметр, м 5448 - "createDate": "2024-12-20T07:45:52.611Z" ~/~/ Дата создания в бд 5449 -} 5450 -))) 5451 - 5452 - 5453 - 5454 -((( 5455 5455 5456 5456 ))) 5457 5457 5458 5458 ((( 5459 -((( 5460 -((( 5461 5461 == **Изменение поля** == 5462 5462 5463 5463 (% class="box infomessage" %) ... ... @@ -5599,7 +5599,7 @@ 5599 5599 ))) 5600 5600 5601 5601 5602 -== ** Редактирование года урожая5142 +== **Функция обновляет закрытие/открытие года урожая** == 5603 5603 5604 5604 (% class="box successmessage" %) 5605 5605 ((( ... ... @@ -5706,29 +5706,17 @@ 5706 5706 ))) 5707 5707 5708 5708 5709 -== **Удалениесуществующегополя**==5249 +== == 5710 5710 5711 -(% class="box errormessage" %) 5712 5712 ((( 5713 -**DELETE /api/v3/agroLands/{id}** 5714 -))) 5715 - 5716 -Пример запроса: 5717 -id ~/~/ Идентификатор поля 5718 - 5719 -Пример ответа: 5720 - 5721 -((( 5722 -200 ~/~/ Успех 5723 - 5724 5724 5725 5725 ))) 5726 - 5727 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5728 5728 ))) 5729 5729 ))) 5730 5730 ))) 5731 5731 5258 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5259 + 5732 5732 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5733 5733 5734 5734 ... ... @@ -5769,7 +5769,7 @@ 5769 5769 ] 5770 5770 5771 5771 5772 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==5300 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 5773 5773 5774 5774 (% class="box infomessage" %) 5775 5775 ((( ... ... @@ -5867,799 +5867,7 @@ 5867 5867 ] 5868 5868 5869 5869 5870 -= **Раздел: Журнал заданий ** = 5871 5871 5872 - 5873 -== **Создание задания в Журнале заданий** == 5874 - 5875 -(% class="box infomessage" %) 5876 -((( 5877 -**POST /api/v3/vehicletasks** 5878 -))) 5879 - 5880 -Пример запроса: 5881 - 5882 -((( 5883 -{ 5884 - "vehicleId": 0, ~/~/ Идентификатор ТС 5885 - "description": "string", ~/~/ Описание 5886 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5887 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5888 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 5889 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 5890 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5891 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5892 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5893 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5894 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5895 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5896 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5897 - "cost": { 5898 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5899 - "Name": "string", ~/~/ Наименование 5900 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 5901 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5902 - "Norm": 0 ~/~/ Норма внесения 5903 - }, 5904 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 5905 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5906 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 5907 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 5908 - "deleted": true, ~/~/ Признак удаления 5909 - "extId": "string", 5910 - "GeoIds": [ ~/~/ Cвязанные поля 5911 - 0 5912 - ] 5913 -} 5914 -))) 5915 - 5916 - 5917 -Пример ответа: 5918 - 5919 -{ 5920 - "vehicleId": 0, ~/~/ Идентификатор ТС 5921 - "description": "string", ~/~/ Описание 5922 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5923 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5924 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 5925 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 5926 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5927 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5928 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5929 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5930 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5931 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5932 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5933 - "cost": { 5934 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5935 - "Name": "string", ~/~/ Наименование 5936 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5937 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5938 - "Norm": 0 ~/~/ Норма внесения 5939 - }, 5940 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5941 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5942 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 5943 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 5944 - "deleted": true, ~/~/ Признак удаления 5945 - "extId": "string", ~/~/ ExtId 5946 - "GeoIds": [ ~/~/ Связанные поля 5947 - 0 5948 - ] 5949 -} 5950 - 5951 - 5952 -== **Редактирование задания в Журнале заданий** == 5953 - 5954 -(% class="box successmessage" %) 5955 -((( 5956 -**PUT /api/v3/vehicletasks** 5957 -))) 5958 - 5959 -Пример запроса: 5960 - 5961 -((( 5962 -{ 5963 - "vehicleId": 0, ~/~/ Идентификатор ТС 5964 - "description": "string", ~/~/ Описание 5965 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 5966 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 5967 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 5968 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 5969 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 5970 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 5971 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 5972 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 5973 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 5974 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 5975 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 5976 - "cost": { 5977 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 5978 - "Name": "string", ~/~/ Наименование 5979 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 5980 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 5981 - "Norm": 0 ~/~/ Норма внесения 5982 - }, 5983 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 5984 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 5985 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 5986 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 5987 - "deleted": true, ~/~/ Признак удаления 5988 - "extId": "string", ~/~/ ExtId 5989 - "GeoIds": [ ~/~/ Связанные поля 5990 - 0 5991 - ] 5992 -} 5993 -))) 5994 - 5995 - 5996 -Пример ответа: 5997 - 5998 -{ 5999 - "vehicleId": 0, ~/~/ Идентификатор ТС 6000 - "description": "string", ~/~/ Описание 6001 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6002 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6003 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 6004 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 6005 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6006 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6007 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6008 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6009 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6010 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6011 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6012 - "cost": { 6013 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6014 - "Name": "string", ~/~/ Наименование 6015 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 6016 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6017 - "Norm": 0 ~/~/ Норма внесения 6018 - }, 6019 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6020 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6021 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 6022 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 6023 - "deleted": true, ~/~/ Признак удаления 6024 - "extId": "string", ~/~/ ExtId 6025 - "GeoIds": [ ~/~/ Связанные поля 6026 - 0 6027 - ] 6028 -} 6029 - 6030 - 6031 -== **Удаление задания в Журнале заданий** == 6032 - 6033 -(% class="box warningmessage" %) 6034 -((( 6035 -**DELETE /api/v3/vehicletasks** 6036 -))) 6037 - 6038 -Пример запроса: 6039 - 6040 -((( 6041 -[ 6042 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 6043 -] 6044 -))) 6045 - 6046 -((( 6047 - 6048 -))) 6049 - 6050 -Пример ответа: 6051 - 6052 -{ 6053 - "vehicleId": 0, ~/~/ Идентификатор ТС 6054 - "description": "string", ~/~/ Описание 6055 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6056 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6057 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 6058 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 6059 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6060 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6061 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6062 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6063 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6064 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6065 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6066 - "cost": { 6067 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6068 - "Name": "string", ~/~/ Наименование 6069 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 6070 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6071 - "Norm": 0 ~/~/ Норма внесения 6072 - }, 6073 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6074 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6075 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 6076 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 6077 - "deleted": true, ~/~/ Признак удаления 6078 - "extId": "string", ~/~/ ExtId 6079 - "GeoIds": [ ~/~/ Связанные поля 6080 - 0 6081 - ] 6082 -} 6083 - 6084 - 6085 -== **Получение списка Журнала заданий** == 6086 - 6087 -(% class="box infomessage" %) 6088 -((( 6089 -**POST /api/v3/vehicletasks/getbyperiod** 6090 -))) 6091 - 6092 -Пример запроса: 6093 - 6094 -((( 6095 -{ 6096 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 6097 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 6098 - "TimeZone": 0, ~/~/ Часовой пояс. 6099 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 6100 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 6101 - ], 6102 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 6103 - 0 6104 - ], 6105 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 6106 - 0 6107 - ], 6108 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 6109 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 6110 -} 6111 -))) 6112 - 6113 - 6114 -Пример ответа: 6115 - 6116 -((( 6117 -{ 6118 - "total": 0, ~/~/ Общее количество записей 6119 - "pages": 0, ~/~/ Общее количество страниц 6120 - "currentPage": 0, ~/~/ Текущая страница 6121 - "items": [ ~/~/ Записи 6122 - { 6123 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6124 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 6125 - "name": "string", ~/~/ Название задания. 6126 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 6127 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 6128 - "workKind": "string", ~/~/ Вид работ 6129 - "techOp": "string", ~/~/ Тех. операция 6130 - "trailerModel": "string", ~/~/ Модель агрегата 6131 - "width": "string", ~/~/ Ширина, м 6132 - "speed": "string", ~/~/ Тех. скорость 6133 - "fields": "string", ~/~/ Поля 6134 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 6135 - "vehicles": "string", ~/~/ Объект-модель 6136 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 6137 - "drivers": "string", ~/~/ Водители 6138 - "tmc": "string", ~/~/ ТМЦ 6139 - "client": "string", ~/~/ Клиент 6140 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6141 - "dep": "string", ~/~/ Подразделение 6142 - "geoIds": [ ~/~/ Связанные поля 6143 - 0 6144 - ] 6145 - } 6146 - ] 6147 -} 6148 -))) 6149 - 6150 - 6151 -= **Раздел: Роли** = 6152 - 6153 -== **Получение списка клиентских и системных ролей пользователя ** == 6154 - 6155 -(% class="box successmessage" %) 6156 -((( 6157 -**POST /api/v3/groups/find** 6158 -))) 6159 - 6160 -Пример запроса: 6161 - 6162 -((( 6163 -{ 6164 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6165 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6166 -} 6167 -))) 6168 - 6169 -((( 6170 - 6171 -))) 6172 - 6173 -((( 6174 -Пример ответа: 6175 -))) 6176 - 6177 -((( 6178 -((( 6179 -{ 6180 - "groups": [ ~/~/ Системные роли пользователя 6181 - { 6182 - "code": "string", ~/~/ Код роли. 6183 - "name": "string", ~/~/ Имя 6184 - "shortName": "string" ~/~/ Короткое имя 6185 - } 6186 - ], 6187 - "customGroups": [ ~/~/ Системные роли пользователя 6188 - { 6189 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6190 - "name": "string", ~/~/ Наименование 6191 - "shortName": "string", ~/~/ Короткое наименование 6192 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6193 - } 6194 - ] 6195 -} 6196 -))) 6197 -))) 6198 - 6199 -((( 6200 - 6201 -))) 6202 - 6203 -((( 6204 - 6205 -))) 6206 - 6207 -= **Раздел: Локатор ** = 6208 - 6209 - 6210 -== **Получение данных по локатору** == 6211 - 6212 -(% class="box infomessage" %) 6213 -((( 6214 -**GET /api/v3/locators/{locatorId}** 6215 -))) 6216 - 6217 -В запросе указывается locatorid - идентификатор локатора 6218 - 6219 - 6220 -Пример ответа: 6221 - 6222 -((( 6223 -((( 6224 -{ 6225 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6226 - 0 6227 - ], 6228 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6229 - 0 6230 - ], 6231 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6232 - 0 6233 - ], 6234 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6235 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6236 - "agentName": "string", ~/~/ Наименование агента. 6237 - "isEnabled": true, ~/~/ Активность 6238 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6239 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6240 - "name": "string", ~/~/ Наименование. 6241 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6242 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6243 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6244 - "validity": 0, ~/~/ Значение срока действия 6245 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6246 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6247 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6248 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6249 - "url": "string", ~/~/ Ссылка 6250 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6251 - 6252 - "showVehicleName": true, ~/~/ Наименование объекта 6253 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6254 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6255 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6256 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6257 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6258 - 6259 - 1 6260 - 6261 - ] 6262 -} 6263 -))) 6264 -))) 6265 - 6266 - 6267 -((( 6268 -((( 6269 - 6270 -))) 6271 -))) 6272 - 6273 - 6274 -== **Создание локатора** == 6275 - 6276 -(% class="box successmessage" %) 6277 -((( 6278 -**POST /api/v3/locators** 6279 -))) 6280 - 6281 -Пример запроса: 6282 - 6283 -((( 6284 -{ 6285 - "isEnabled": true, ~/~/ Активность 6286 - "name": "string", ~/~/ Наименование локатора 6287 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6288 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6289 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6290 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6291 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6292 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6293 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6294 - 0 6295 - ], 6296 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6297 - 0 6298 - ], 6299 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6300 - 0 6301 - ], 6302 - 6303 - "showVehicleName": true, ~/~/ Наименование объекта 6304 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6305 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6306 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6307 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6308 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6309 - 6310 - 1 6311 - 6312 - ] 6313 -} 6314 -))) 6315 - 6316 - 6317 -Пример ответа: 6318 - 6319 -((( 6320 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6321 -))) 6322 - 6323 - 6324 -== **Выводит список локаторов ** == 6325 - 6326 -(% class="box successmessage" %) 6327 -((( 6328 -**POST /api/v3/locators/find** 6329 -))) 6330 - 6331 -Пример запроса: 6332 - 6333 -((( 6334 -{ 6335 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6336 -} 6337 -))) 6338 - 6339 -((( 6340 - 6341 -))) 6342 - 6343 -((( 6344 - 6345 -))) 6346 - 6347 - 6348 -Пример ответа: 6349 - 6350 -((( 6351 -[ 6352 - { 6353 - "vehiclesCount": 0, ~/~/ Количество объектов. 6354 - "geozonesCount": 0, ~/~/ Количество геозон. 6355 - "fieldsCount": 0, ~/~/ Количество полей. 6356 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6357 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6358 - "agentName": "string", ~/~/ Наименование агента. 6359 - "isEnabled": true, ~/~/ Активность локатора 6360 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6361 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6362 - "name": "string", ~/~/ Наименование локатора 6363 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6364 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6365 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6366 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6367 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6368 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6369 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6370 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6371 - "url": "string", ~/~/ ссылка на локатор 6372 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6373 - "showVehicleName": true, ~/~/ Наименование объекта 6374 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6375 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6376 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6377 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6378 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6379 - 6380 - 0 6381 - ] 6382 - } 6383 -] 6384 -))) 6385 - 6386 - 6387 - 6388 -== **Изменение локатора** == 6389 - 6390 -(% class="box infomessage" %) 6391 -((( 6392 -**PUT /api/v3/locators** 6393 -))) 6394 - 6395 -Пример запроса: 6396 - 6397 -((( 6398 -{ 6399 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6400 - "isEnabled": true, ~/~/ Активность 6401 - "name": "string", ~/~/ Наименование 6402 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6403 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6404 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6405 - "autoProlongation": true, ~/~/ Автопродление срока действия 6406 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6407 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6408 - 0 6409 - ], 6410 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6411 - 0 6412 - ], 6413 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6414 - 0 6415 - ], 6416 - "showVehicleName": true, ~/~/ Наименование объекта 6417 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6418 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6419 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6420 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6421 - "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС) 6422 - 6423 - 0 6424 - 6425 - ] 6426 -} 6427 - 6428 - 6429 -))) 6430 - 6431 -Пример ответа: 6432 - 6433 -200 ~/~/ Success 6434 - 6435 - 6436 -== **Удалить локатор** == 6437 - 6438 -(% class="box warningmessage" %) 6439 -((( 6440 -**DELETE /api/v3/locators** 6441 -))) 6442 - 6443 -Пример запроса: 6444 - 6445 -((( 6446 -[ 6447 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6448 -] 6449 -))) 6450 - 6451 - 6452 - 6453 -= **Раздел: Яндекс Маршруты** = 6454 - 6455 - 6456 -== **Возвращение списка маршрутов** == 6457 - 6458 -(% class="box infomessage" %) 6459 -((( 6460 -**GET /api/v3/TransportRoutes** 6461 -))) 6462 - 6463 -Пример запроса: 6464 -Id ~/~/ Идентификатор поля 6465 - 6466 - 6467 -Пример ответа: 6468 - 6469 -((( 6470 -[ 6471 - { 6472 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6473 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6474 - "name": "string", ~/~/ Наименование маршрута. 6475 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6476 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6477 - 0 6478 - ] 6479 - } 6480 -] 6481 -))) 6482 - 6483 - 6484 - 6485 -== **Добавить маршрут** == 6486 - 6487 -(% class="box infomessage" %) 6488 -((( 6489 -**POST /api/v3/TransportRoutes** 6490 -))) 6491 - 6492 -Пример запроса: 6493 -{ 6494 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6495 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6496 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6497 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6498 - 0 6499 - ] 6500 -} 6501 - 6502 - 6503 -Пример ответа: 6504 - 6505 -((( 6506 -{ 6507 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6508 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6509 - "name": "string", ~/~/ Определяет наименование маршрута 6510 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6511 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6512 - 0 6513 - ] 6514 -} 6515 -))) 6516 - 6517 - 6518 -== **Обновление маршрута** == 6519 - 6520 -(% class="box successmessage" %) 6521 -((( 6522 -**PUT /api/v3/TransportRoutes** 6523 -))) 6524 - 6525 -Пример запроса: 6526 - 6527 -((( 6528 -{ 6529 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6530 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6531 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6532 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6533 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6534 - 0 6535 - ] 6536 -} 6537 -))) 6538 - 6539 - 6540 -Пример ответа: 6541 - 6542 -((( 6543 -{ 6544 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6545 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6546 - "name": "string", ~/~/ Определяет наименование маршрута 6547 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6548 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6549 - 0 6550 - ] 6551 -} 6552 -))) 6553 - 6554 - 6555 -== **Получить связки маршрутов ТС** == 6556 - 6557 -(% class="box infomessage" %) 6558 -((( 6559 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6560 -))) 6561 - 6562 -Пример запроса: 6563 - 6564 -((( 6565 -[ 6566 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6567 -] 6568 -))) 6569 - 6570 - 6571 -Пример ответа: 6572 - 6573 -((( 6574 -[ 6575 - { 6576 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6577 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6578 - } 6579 -] 6580 -))) 6581 - 6582 - 6583 -== **Удалить маршрут** == 6584 - 6585 -(% class="box warningmessage" %) 6586 -((( 6587 -**DELETE /api/v3/TransportRoutes/{id}** 6588 -))) 6589 - 6590 -Пример запроса: 6591 -Id ~/~/ Идентификатор поля 6592 - 6593 - 6594 - 6595 -= **Раздел: Управление доступа к машинам** = 6596 - 6597 - 6598 -== Получение списка транспортных средств видимых пользователю == 6599 - 6600 -(% class="box infomessage" %) 6601 -((( 6602 -**GET /api/v3/UserVisibleVehicles/{userId}** 6603 -))) 6604 - 6605 -Пример ответа: 6606 - 6607 -((( 6608 -{ 6609 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6610 - 0 6611 - ] 6612 -} 6613 -))) 6614 - 6615 - 6616 - 6617 -== Задает видимость транспортных средств пользователю == 6618 - 6619 -(% class="box infomessage" %) 6620 -((( 6621 -**POST /api/v3/UserVisibleVehicles** 6622 -))) 6623 - 6624 -Пример запроса: 6625 - 6626 -((( 6627 -((( 6628 -{ 6629 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6630 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6631 - 0 6632 - ] 6633 -} 6634 -))) 6635 - 6636 -((( 6637 - 6638 -))) 6639 - 6640 -((( 6641 - 6642 -))) 6643 - 6644 -((( 6645 -Пример ответа : 6646 -))) 6647 - 6648 -((( 6649 - 6650 -))) 6651 - 6652 -((( 6653 -200 ~/~/ Success 6654 -))) 6655 -))) 6656 - 6657 - 6658 -== == 6659 - 6660 - 6661 - 6662 - 6663 6663 (% class="box" lang="en-US" style="text-align: center;" %) 6664 6664 ((( 6665 6665 (% 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]] **