<
From version < 203.1 >
edited by Андрей Калиновский
on 2024/12/23 14:03
To version < 263.1
edited by Андрей Калиновский
on 2025/09/16 11:13
Change comment: There is no comment for this version

Summary

Details

Icon Page properties
Content
... ... @@ -11,6 +11,11 @@
11 11  
12 12  В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов.
13 13  
14 +(% class="box infomessage" %)
15 +(((
16 +**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя.
17 +\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему.
18 +)))
14 14  
15 15  **Содержание страницы:**
16 16  )))
... ... @@ -118,29 +118,41 @@
118 118  Запрос должен содержать данные параметра "**agentId**"
119 119  
120 120  (% style="color:#000000" %)Ответ:
126 +
127 +(((
121 121  {
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 - }
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 +)))
143 143  
160 +
144 144  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
145 145  |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 
146 146  |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя
... ... @@ -270,28 +270,6 @@
270 270   "bankKS": "string" ~/~/ корр. счёт
271 271  }
272 272  
273 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
274 -|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 
275 -|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя
276 -|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя
277 -|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента
278 -|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента
279 -|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)
280 -|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент
281 -|(% style="width:215px" %)district|(% style="width:861px" %)Округ
282 -|(% style="width:215px" %)region|(% style="width:861px" %)Регион
283 -|(% style="width:215px" %)city|(% style="width:861px" %)Город
284 -|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента
285 -|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента
286 -|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес
287 -|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес
288 -|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта
289 -|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя
290 -|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк
291 -|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК
292 -|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета
293 -|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет
294 -
295 295  == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) ==
296 296  
297 297  (% class="box warningmessage" %)
... ... @@ -437,7 +437,7 @@
437 437   [
438 438   "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей
439 439   ],
440 - "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
435 + "language": 1 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
441 441  }
442 442  {
443 443   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
... ... @@ -749,6 +749,11 @@
749 749  (% style="text-align:left" %)
750 750  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
751 751  
747 +(% class="wikigeneratedid" id="H" %)
748 +(((
749 +
750 +)))
751 +
752 752  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) =
753 753  
754 754  == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) ==
... ... @@ -860,7 +860,7 @@
860 860  {
861 861   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
862 862   "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
863 - "deleted": true,
863 + "deleted": false,
864 864   "extId": "string",
865 865   "name": "string",
866 866   "picture": "string",
... ... @@ -879,7 +879,7 @@
879 879  {
880 880   "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
881 881   "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
882 - "deleted": true,
882 + "deleted": false,
883 883   "extId": "string",
884 884   "name": "string",
885 885   "picture": "string",
... ... @@ -913,7 +913,7 @@
913 913  (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models**
914 914  )))
915 915  
916 -(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе.
916 +(% style="color:#000000" %)Метод позволяет изменить статус модели, указанного в запросе.
917 917  
918 918  (% style="color:#000000" %)Метод запроса: **PUT**
919 919  
... ... @@ -980,7 +980,7 @@
980 980  (% lang="en-US" %)**DELETE /api/v3/models/{Id}**
981 981  )))
982 982  
983 -(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса.
983 +(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалить модель, указанного в строке запроса.
984 984  
985 985  (% style="color:#000000" %)Метод запроса: **DELETE**
986 986  
... ... @@ -1126,6 +1126,7 @@
1126 1126   ],
1127 1127   "showInTooltip": true, ~/~/ Отображать в подсказке
1128 1128   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1129 + "color": "string", ~/~/ Код цвета датчиков
1129 1129   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1130 1130   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1131 1131   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1389,6 +1389,7 @@
1389 1389   ],
1390 1390   "showInTooltip": true, ~/~/ Отображать в подсказке
1391 1391   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1393 + "color": "string", ~/~/ код цвета датчиков
1392 1392   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1393 1393   "showWithoutIgn": true, ~/~/ Отображать трек без включенного зажигания
1394 1394   "agrFunction": 0, ~/~/ Функция, SUM, AVG, EXPRESSION
... ... @@ -1559,6 +1559,7 @@
1559 1559   ],
1560 1560   "showInTooltip": true, ~/~/ Отображение в подсказке
1561 1561   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1564 + "color": "string", ~/~/ код цвета датчиков
1562 1562   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
1563 1563   "showWithoutIgn": true, ~/~/ Отображать без включенного зажигания
1564 1564   "agrFunction": 0,  ~/~/ Агрегирующая функция. 0 - SUM, 1 - AVG, 2 - EXPRESSION
... ... @@ -1608,77 +1608,6 @@
1608 1608  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
1609 1609  
1610 1610  
1611 -== **Импортировать историю ТС (Асинхронный запрос)** ==
1612 -
1613 -(% class="box successmessage" %)
1614 -(((
1615 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
1616 -)))
1617 -
1618 -Метод запроса: **POST**
1619 -
1620 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
1621 -
1622 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
1623 -
1624 -
1625 -Ответ:
1626 -
1627 -{
1628 -
1629 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
1630 -
1631 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса
1632 -
1633 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
1634 -
1635 - "Message": "string", ~/~/ Информация о выполнении запроса
1636 -
1637 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
1638 -
1639 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
1640 -
1641 - "Data": "string" ~/~/ Данные
1642 -
1643 -}
1644 -
1645 -
1646 -== **Возвращает статус асинхронного запроса импорта истории ТС** ==
1647 -
1648 -(% class="box infomessage" %)
1649 -(((
1650 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
1651 -)))
1652 -
1653 -Метод запроса: **GET**
1654 -
1655 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
1656 -
1657 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
1658 -
1659 -
1660 -Ответ:
1661 -
1662 -{
1663 -
1664 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
1665 -
1666 - "Status": 0, ~/~/ Перечисление состояний выполения запроса
1667 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
1668 -
1669 - "Message": "string", ~/~/ Информация о выполнении запроса
1670 -
1671 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
1672 -
1673 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
1674 -
1675 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
1676 -
1677 - "Data": "string" ~/~/ Данные
1678 -
1679 -}
1680 -
1681 -
1682 1682  == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) ==
1683 1683  
1684 1684  (% class="box infomessage" %)
... ... @@ -1824,7 +1824,6 @@
1824 1824   "stage": "", ~/~/ Состояние
1825 1825  (% style="color:#000000" %) }
1826 1826  
1827 -== ==
1828 1828  
1829 1829  == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==
1830 1830  
... ... @@ -1951,7 +1951,7 @@
1951 1951   "showLastValid": true, ~/~/ Отображать последнее валидное значение
1952 1952  
1953 1953  (((
1954 - "color": "string",** ~/~/ **Цвет датчика
1885 + "color": "string",** ~/~/ **Цвет датчика
1955 1955  )))
1956 1956  
1957 1957   "showAsDutOnGraph": true, ~/~/ Отображать на графике как датчик уровня топлива
... ... @@ -2441,7 +2441,7 @@
2441 2441  Тело запроса:
2442 2442  
2443 2443  {
2444 - "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
2375 + "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
2445 2445   "vehicleIds": [0], ~/~/ Список ID объектов
2446 2446   "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода
2447 2447   "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода
... ... @@ -2464,6 +2464,8 @@
2464 2464   "motohours": 0, ~/~/ Моточасы за период, секунды
2465 2465   "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды
2466 2466   "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды
2398 + "idlingTime": 0 ~/~/  Холостой ход за период, секунд
2399 +
2467 2467   }
2468 2468   ]
2469 2469   }
... ... @@ -2486,7 +2486,6 @@
2486 2486  Тело запроса:
2487 2487  
2488 2488  {
2489 - "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
2490 2490   "vehicleIds": [0], ~/~/ Список ID объектов
2491 2491   "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода
2492 2492   "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода
... ... @@ -2505,8 +2505,12 @@
2505 2505   "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 
2506 2506   "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода
2507 2507   "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода
2440 + "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода
2441 + "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода
2508 2508   "fuelConsumption": 0, ~/~/ Расход топлива
2509 2509   "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении
2444 + "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне
2445 +
2510 2510   }
2511 2511   ]
2512 2512   }
... ... @@ -2515,7 +2515,6 @@
2515 2515  (% class="box warningmessage" %)
2516 2516  (((
2517 2517  Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"".
2518 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling".
2519 2519  )))
2520 2520  
2521 2521  == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) ==
... ... @@ -2552,12 +2552,21 @@
2552 2552   "model": "string", ~/~/ Модель объекта
2553 2553   "fuels": [ ~/~/ Массив данным по заправкам и сливам
2554 2554   {
2555 - "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив
2490 + "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
2491 +
2492 +(((
2556 2556   "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало
2557 2557   "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание
2558 2558   "valueFuel": 0, ~/~/ Количество
2559 2559   "fuelStart": 0, ~/~/ Уровень топлива на начало события
2560 2560   "fuelEnd": 0 ~/~/ Уровень топливо на конец события
2498 +)))
2499 +
2500 +(((
2501 + "latitude": 0, ~/~/ Широта.
2502 + "longitude": 0 ~/~/ Долгота.
2503 +)))
2504 +
2561 2561   }
2562 2562   ]
2563 2563   }
... ... @@ -2631,194 +2631,241 @@
2631 2631  В заголовках запроса: X-Auth: Токен авторизации
2632 2632  
2633 2633  
2634 теле запроса перечисляете массив id объектов, в квадратных скобках через запятую.
2578 массиве указываем id объектов через запятую
2635 2635  
2636 2636  Ответ:
2581 +
2582 +[
2637 2637   {
2638 - "vehicleId": 0, ~/~/Идентификатор объекта.
2639 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта.
2640 - "vehicleNumber": "string",~/~/Номер объекта.
2641 - "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер
2642 - "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве.
2643 - "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
2644 - "speed": 0,~/~/Скорость объекта.
2645 - "course": 0,~/~/Курс движения [0;360]
2646 - "latitude": 0,~/~/Широта [-90°;90°].
2647 - "longitude": 0,~/~/Долгота [-180°;180°].
2648 - "address": "string",~/~/Адрес.
2649 - "geozones": [ ~/~/Сведения по геозонам.
2584 + "vehicleId": 55728, ~/~/ Идентификатор объекта 
2585 + "vehicleGuid": "fa9c0357-9b9f-44b9-a89c-20a2cb80a9ad", ~/~/ Guid объекта 
2586 + "vehicleNumber": "0105 КМ", ~/~/ Номер объекта 
2587 + "receiveTime": "2025-06-27T12:37:46.7782735Z", ~/~/ Время и дата поступления данных 
2588 + "recordTime": "2025-06-27T12:37:19Z", ~/~/ Время и дата формирование данных 
2589 + "state": 4, ~/~/ Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
2590 + "speed": 31, ~/~/ Скорость объекта 
2591 + "course": 116, ~/~/ Курс движения [0;360]
2592 + "latitude": 45.722128, ~/~/ Широта [-90°;90°].
2593 + "longitude": 39.800432, ~/~/ Долгота [-180°;180°].
2594 + "address": "\" Краснодарский край Россия 45,722128°, 39,800432°\"", ~/~/ Адрес 
2595 + "geozones": [ ~/~/ Сведения по геозонам. 
2650 2650   {
2651 - "id": 0,
2652 - "name": "string"
2597 + "id": 10225647, ~/~/ ID Геозоны 
2598 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 
2599 + },
2600 + {
2601 + "id": 10282875, ~/~/ ID Геозоны 
2602 + "name": "Ё2" ~/~/ Наименование геозоны 
2603 + },
2604 + {
2605 + "id": 10226240, ~/~/ ID Геозоны 
2606 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 
2607 + },
2608 + {
2609 + "id": 9747869, ~/~/ ID Геозоны 
2610 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 
2611 + },
2612 + {
2613 + "id": 10221123, ~/~/ ID Геозоны 
2614 + "name": "53r" ~/~/ Наименование геозоны 
2615 + },
2616 + {
2617 + "id": 10197638, ~/~/ ID Геозоны 
2618 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 
2653 2653   }
2620 + ]
2621 + }
2654 2654  
2655 2655  
2656 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =
2624 += =
2657 2657  
2658 -== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) ==
2626 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =
2659 2659  
2628 +== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==
2629 +
2660 2660  (% class="box infomessage" %)
2661 2661  (((
2662 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find**
2632 +**POST /api/v3/notifications/find**
2663 2663  )))
2664 2664  
2665 -(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них.
2635 +Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии.
2666 2666  
2667 -(% style="color:#000000" %)Метод запроса: **POST**
2637 +(% style="text-align: left;" %)
2638 +Метод запроса **POST**
2668 2668  
2669 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find
2640 +(% style="text-align: left;" %)
2641 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find
2670 2670  
2643 +(% style="text-align: left;" %)
2671 2671  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
2672 2672  
2673 -(% style="text-align:left" %)
2674 -Тело запроса:
2675 -
2676 -(% style="text-align:left" %)
2677 2677  {
2678 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
2647 + "parentId": "" ~/~/ id клиента
2679 2679  }
2680 2680  
2681 -(% style="text-align:left" %)
2682 2682  Ответ:
2683 2683  
2684 2684  [
2685 2685   {
2686 - "id": 0, ~/~/ Идентификатор объекта геозоны
2687 - "name": "string", ~/~/ Название объекта геозоны
2688 - "type": 0, ~/~/ Тип объекта геозоны
2689 - "fname": "string", ~/~/ Имя файла
2690 - "parentId": "string", ~/~/ Идентификатор клиента
2691 - "radius": 0, ~/~/ Радиус геообъекта
2692 - "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета
2693 - "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета
2694 - "description": "string", ~/~/ Описание
2695 - "area": 0, ~/~/ Площадь, м^^2^^
2696 - "perimetr": 0, ~/~/ Периметр, м
2697 - "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания
2654 + "id": 0, ~/~/ ID уведомления
2655 + "name": "string", ~/~/ Название уведомления
2656 + "active": true, ~/~/ Состояние true - активен, false - деактивирован
2657 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 
2658 + "userId": "", ~/~/ Пользователь, создавший уведомление
2659 + "parentId": "", ~/~/ Идентификатор клиента
2660 + "parentName": "string" ~/~/ Имя клиента
2698 2698   }
2699 2699  ]
2700 2700  
2701 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) ==
2702 2702  
2665 +== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) ==
2666 +
2703 2703  (% class="box infomessage" %)
2704 2704  (((
2705 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles**
2669 +**POST /api/v3/notifications**
2706 2706  )))
2707 2707  
2708 -(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период.
2672 +Метод запроса **POST**
2709 2709  
2710 -(% style="color:#000000" %)Метод запроса: **POST**
2674 +(% style="text-align: left;" %)
2675 +(% style="color:#000000" %)Пример запроса
2711 2711  
2712 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles
2713 -
2714 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
2715 -
2716 -(% style="text-align:left" %)
2717 -Тело запроса:
2718 -
2677 +(((
2719 2719  {
2720 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса
2721 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания
2722 - "ids": [ ], ~/~/ Массив id объектов
2723 - "byTime": 0, ~/~/ Объединение событий по времени 
2724 - "byDist": 0, ~/~/ Объединение событий по расстоянию
2725 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
2726 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра
2679 + "id": 0, ~/~/ ID правила
2680 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя
2681 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило
2682 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
2683 + "name": "string", ~/~/ Имя правила
2684 + "active": true, ~/~/ Активность правила
2685 + "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто
2686 + "vehicleGroups": [ ~/~/ Список групп объектов для анализа.
2687 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 
2688 + ],
2689 + "vehicleIds": [ ~/~/ Список объектов для анализа.
2690 + 0
2691 + ],
2692 + "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам.
2693 + 0
2694 + ],
2695 + "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам.
2696 + 0
2697 + ],
2698 + "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений.
2699 + "additionalProp1": "string",  
2700 + "additionalProp2": "string",
2701 + "additionalProp3": "string"
2702 + },
2703 + "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы"
2704 + "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила
2705 + "3fa85f64-5717-4562-b3fc-2c963f66afa6"
2706 + ],
2707 + "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям"
2708 + "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений
2709 + "string"
2710 + ],
2711 + "toTelegram": true, ~/~/ Флаг активности отправки в Telegram
2712 + "telegrams": [ ~/~/ Список получателя уведомлений в Telegram.
2713 + {
2714 + "id": 0, ~/~/ Идентификатор участника чата.
2715 + "info": "string" ~/~/ Дополнительные сведения.
2716 + }
2717 + ],
2718 + "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение
2719 + "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы
2720 + "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений.
2721 + "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 
2722 + "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени)
2723 + "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC)
2724 + "timezone": 0, ~/~/ часовой пояс 
2725 + "validity": 0, ~/~/ Срок действия в днях (1-90).
2726 + "autoProlongation": true, ~/~/ Автопродление срока действия.
2727 + "templates": [ ~/~/  Переопределения шаблонов уведомлений.
2728 + {
2729 + "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 - Срок действия правила истек
2730 + "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа.
2731 + "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка.
2732 + "additionalProp1": "string",
2733 + "additionalProp2": "string",
2734 + "additionalProp3": "string"
2735 + }
2736 + }
2737 + ]
2727 2727  }
2739 +)))
2728 2728  
2729 -Ответ:
2730 -[
2731 - {
2732 - "geozoneId": 0, ~/~/ ID геообъекта
2733 - "geozoneName": "string", ~/~/ Название геообъекта
2734 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда
2735 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда
2736 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте
2737 - "vehicleId": 0, ~/~/ ID объекта
2738 - "vehicleName": "string" ~/~/ Имя объекта
2739 - }
2740 -]
2741 -
2742 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) ==
2743 -
2744 -(% class="box infomessage" %)
2745 2745  (((
2746 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones**
2742 +
2747 2747  )))
2748 2748  
2749 -(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период.
2750 -
2751 -(% style="color:#000000" %)Метод запроса: **POST**
2752 -
2753 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones
2754 -
2755 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
2756 -
2757 -(% style="text-align:left" %)
2758 -Тело запроса:
2759 -
2760 -{
2761 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса
2762 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания
2763 - "ids": [ ], ~/~/ Массив id геообъектов
2764 - "byTime": 0, ~/~/ Объединение событий по времени 
2765 - "byDist": 0, ~/~/ Объединение событий по расстоянию
2766 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
2767 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра
2768 -}
2769 -
2770 -Ответ:
2771 -
2772 -[
2773 - {
2774 - "geozoneId": 0, ~/~/ ID геообъекта
2775 - "geozoneName": "string", ~/~/ Название геообъекта
2776 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда
2777 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда
2778 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте
2779 - "vehicleId": 0, ~/~/ ID объекта
2780 - "vehicleName": "string" ~/~/ Имя объекта
2781 - }
2782 -]
2783 -
2784 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =
2785 -
2786 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==
2787 -
2788 -(% class="box infomessage" %)
2789 2789  (((
2790 -**POST /api/v3/notifications/find**
2746 +
2791 2791  )))
2792 2792  
2793 -Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии.
2749 +Ответ:
2794 2794  
2795 -(% style="text-align: left;" %)
2796 -Метод запроса **POST**
2797 -
2798 -(% style="text-align: left;" %)
2799 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find
2800 -
2801 -(% style="text-align: left;" %)
2802 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
2803 -
2804 2804  {
2805 - "parentId": "" ~/~/ id клиента
2752 + "id": 0, ~/~/ ID правила
2753 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя
2754 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило
2755 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
2756 + "name": "string", ~/~/ Имя правила
2757 + "active": true, ~/~/ Активность правила
2758 + "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто
2759 + "vehicleGroups": [ ~/~/ Список групп объектов для анализа.
2760 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 
2761 + ],
2762 + "vehicleIds": [ ~/~/ Список объектов для анализа.
2763 + 0
2764 + ],
2765 + "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам.
2766 + 0
2767 + ],
2768 + "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам.
2769 + 0
2770 + ],
2771 + "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений.
2772 + "additionalProp1": "string",  
2773 + "additionalProp2": "string",
2774 + "additionalProp3": "string"
2775 + },
2776 + "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы"
2777 + "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила
2778 + "3fa85f64-5717-4562-b3fc-2c963f66afa6"
2779 + ],
2780 + "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям"
2781 + "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений
2782 + "string"
2783 + ],
2784 + "toTelegram": true, ~/~/ Флаг активности отправки в Telegram
2785 + "telegrams": [ ~/~/ Список получателя уведомлений в Telegram.
2786 + {
2787 + "id": 0, ~/~/ Идентификатор участника чата.
2788 + "info": "string" ~/~/ Дополнительные сведения.
2789 + }
2790 + ],
2791 + "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение
2792 + "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы
2793 + "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений.
2794 + "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 
2795 + "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени)
2796 + "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC)
2797 + "timezone": 0, ~/~/ часовой пояс 
2798 + "validity": 0, ~/~/ Срок действия в днях (1-90).
2799 + "autoProlongation": true, ~/~/ Автопродление срока действия.
2800 + "templates": [ ~/~/  Переопределения шаблонов уведомлений.
2801 + {
2802 + "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 - Срок действия правила истек
2803 + "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа.
2804 + "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка.
2805 + "additionalProp1": "string",
2806 + "additionalProp2": "string",
2807 + "additionalProp3": "string"
2808 + }
2809 + }
2810 + ]
2806 2806  }
2807 2807  
2808 -Ответ:
2809 -
2810 -[
2811 - {
2812 - "id": 0, ~/~/ ID уведомления
2813 - "name": "string", ~/~/ Название уведомления
2814 - "active": true, ~/~/ Состояние true - активен, false - деактивирован
2815 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО
2816 - "userId": "", ~/~/ Пользователь, создавший уведомление
2817 - "parentId": "", ~/~/ Идентификатор клиента
2818 - "parentName": "string" ~/~/ Имя клиента
2819 - }
2820 -]
2821 -
2822 2822  == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) ==
2823 2823  
2824 2824  (% class="box infomessage" %)
... ... @@ -4036,16 +4036,12 @@
4036 4036  Тело запроса:
4037 4037  
4038 4038  {
4039 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4040 - "Balance": 0
4030 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4031 + "Balance": 0 ~/~/ Значение баланса.
4041 4041  }
4042 4042  
4043 4043  Ответ: Success
4044 4044  
4045 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4046 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
4047 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
4048 -
4049 4049  == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) ==
4050 4050  
4051 4051  (% class="box warningmessage" %)
... ... @@ -4057,16 +4057,29 @@
4057 4057  
4058 4058  Тело запроса:
4059 4059  
4047 +(((
4060 4060  {
4061 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4062 - "Balance": 0
4049 + "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4050 + "amount": 0 ~/~/ Сумма пополнения баланса 
4063 4063  }
4052 +)))
4064 4064  
4054 +(((
4055 +
4056 +)))
4057 +
4065 4065  Ответ: Success
4066 4066  
4067 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4068 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
4069 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
4060 +(((
4061 +{
4062 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки.
4063 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4064 + "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя.
4065 + "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки.
4066 + "Amount": 0, ~/~/ Значение, на которое корректируется баланс.
4067 + "Description": "string" ~/~/ Описание корректировки.
4068 +}
4069 +)))
4070 4070  
4071 4071  == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) ==
4072 4072  
... ... @@ -4079,16 +4079,25 @@
4079 4079  
4080 4080  Тело запроса:
4081 4081  
4082 +(((
4082 4082  {
4083 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4084 - "Balance": 0
4084 + "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4085 + "amount": 0 ~/~/ Сумма списания с баланса
4085 4085  }
4087 +)))
4086 4086  
4087 4087  Ответ: Success
4088 4088  
4089 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4090 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
4091 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
4091 +(((
4092 +{
4093 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки.
4094 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4095 + "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя.
4096 + "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки.
4097 + "Amount": 0, ~/~/ Значение, на которое корректируется баланс.
4098 + "Description": "string" ~/~/ Описание корректировки
4099 +}
4100 +)))
4092 4092  
4093 4093  == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) ==
4094 4094  
... ... @@ -4099,28 +4099,35 @@
4099 4099  
4100 4100  Тело запроса:
4101 4101  
4111 +(((
4102 4102  {
4103 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4104 - "CalculationType": 0,
4105 - "PermissibleBalance": 0,
4106 - "DefermentDays": 0,
4107 - "SendUiNotifications": true,
4108 - "SendEmailNotifications": true,
4109 - "IsPrivate": true,
4113 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4114 + "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни
4115 + "PermissibleBalance": 0, ~/~/ Допустимый баланс
4116 + "DefermentDays": 0, ~/~/ Отсрочка (дни).
4117 + "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено
4118 + "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено
4110 4110  }
4120 +)))
4111 4111  
4122 +(((
4123 +
4124 +)))
4125 +
4112 4112  Ответ: Success
4113 4113  
4114 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4115 -|ClientId|Идентификатор клиента
4116 -|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни
4117 -|PermissibleBalance|Допустимый баланс
4118 -|DefermentDays|(((
4119 -Отсрочка, количество дней
4128 +(((
4129 +{
4130 + "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом
4131 + "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент.
4132 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4133 + "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни
4134 + "PermissibleBalance": 0, ~/~/ Допустимый баланс.
4135 + "DefermentDays": 0, ~/~/ Отсрочка (дни)
4136 + "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено
4137 + "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено
4138 +}
4120 4120  )))
4121 -|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено
4122 -|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено
4123 -|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом
4124 4124  
4125 4125  == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) ==
4126 4126  
... ... @@ -4132,35 +4132,68 @@
4132 4132  Тело запроса:
4133 4133  
4134 4134  {
4135 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4136 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4137 - "Features": [
4151 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор клиента.
4152 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.
4153 + "Features": [ ~/~/ Набор услуг по тарифу клиента.
4138 4138   {
4139 - "Feature": "string",
4140 - "IsEnabled": true,
4141 - "IsFactual": true,
4142 - "Limit": 0,
4143 - "Price": 0,
4144 - "DebitDate": "2023-10-18T13:26:58.987Z",
4145 - "PeriodValue": 0,
4146 - "PeriodType": 0
4155 + "Feature": "string", ~/~/ Код услуги.
4156 + "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.
4157 + "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.
4158 + "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование
4159 + "Price": 0, ~/~/ Цена за единицу.
4160 + "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.
4161 + "PeriodValue": 0, ~/~/ Значение периода.
4162 + "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)
4147 4147   }
4148 4148   ]
4149 4149  }
4150 4150  
4167 +
4151 4151  Ответ: Success
4152 4152  
4153 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4154 -|ClientId|Идентификатор клиента
4155 -|PlanId|Идентификатор тарифного плана
4156 -|Feature|Код услуги
4157 -|IsEnabled|Признак, определяющий активирована ли услуга
4158 -|IsFactual|Признак, определяющий расчёт по факту
4159 -|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование.
4160 -|Price|Цена за единицу.
4161 -|DebitDate|Следующий момент времени списания с баланса за услугу.
4162 -|PeriodValue|Значение периода.
4163 -|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы
4170 +(((
4171 +{
4172 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
4173 + "Plan": { ~/~/ Определяет тарифный план (шаблон услуг)
4174 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.
4175 + "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца.
4176 + "Name": "string", ~/~/ Наименование.
4177 + "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план.
4178 + "Constraint": { ~/~/ Ограничения по тарифу 
4179 + "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 
4180 + "PermissibleBalance": 0, ~/~/ Допустимый баланс.
4181 + "DefermentDays": 0 ~/~/ Отсрочка (дни)
4182 + },
4183 + "Features": [ ~/~/ Набор услуг по тарифному плану.
4184 + {
4185 + "Feature": "string", ~/~/Код услуги.
4186 + "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту.
4187 + "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование.
4188 + "Price": 0, ~/~/ Цена за единицу.
4189 + "PeriodValue": 0, ~/~/ Значение периода.
4190 + "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 
4191 + }
4192 + ],
4193 + "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план.
4194 + "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана.
4195 + "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана.
4196 + },
4197 + "Features": [ ~/~/ Набор услуг по тарифу клиента.
4198 + {
4199 + "Feature": "string", ~/~/ Код услуги.
4200 + "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.
4201 + "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом.
4202 + "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.
4203 + "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование.
4204 + "Price": 0, ~/~/ Цена за единицу.
4205 + "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу.
4206 + "PeriodValue": 0, ~/~/ Значение периода.
4207 + "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане.
4208 + "Quantity": 0 ~/~/ Количество использования услуги.
4209 + }
4210 + ]
4211 +}
4212 +)))
4164 4164  
4165 4165  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) =
4166 4166  
... ... @@ -4265,6 +4265,43 @@
4265 4265  |producedCount|Кол-во успешно отправленных в шину данных сообщений
4266 4266  |msgCount|Кол-во обработанных сообщений всего
4267 4267  
4317 +== **Импортировать историю ТС (Асинхронный запрос)** ==
4318 +
4319 +(% class="box successmessage" %)
4320 +(((
4321 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
4322 +)))
4323 +
4324 +При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4325 +
4326 +Метод запроса: **POST**
4327 +
4328 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
4329 +
4330 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
4331 +
4332 +
4333 +Ответ:
4334 +
4335 +{
4336 +
4337 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4338 +
4339 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса
4340 +
4341 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
4342 +
4343 + "Message": "string", ~/~/ Информация о выполнении запроса
4344 +
4345 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
4346 +
4347 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4348 +
4349 + "Data": "string" ~/~/ Данные
4350 +
4351 +}
4352 +
4353 +
4268 4268  == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) ==
4269 4269  
4270 4270  (% class="box infomessage" %)
... ... @@ -4282,10 +4282,59 @@
4282 4282   "message": "string"
4283 4283  }
4284 4284  
4285 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
4286 -|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет
4287 -|progress|Guid ТС
4371 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)(((
4372 +**Параметр**
4373 +)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)(((
4374 +**Описание**
4375 +)))
4376 +|(((
4377 +activity
4378 +)))|(((
4379 +Активен ли экспорт/импорт истории сейчас, true - да, false - нет
4380 +)))
4381 +|(((
4382 +progress
4383 +)))|(((
4384 +Guid ТС
4385 +)))
4288 4288  
4387 +== **Возвращает статус асинхронного запроса импорта истории ТС** ==
4388 +
4389 +(% class="box infomessage" %)
4390 +(((
4391 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
4392 +)))
4393 +
4394 +При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
4395 +
4396 +Метод запроса: **GET**
4397 +
4398 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
4399 +
4400 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
4401 +
4402 +
4403 +Ответ:
4404 +
4405 +{
4406 +
4407 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
4408 +
4409 + "Status": 0, ~/~/ Перечисление состояний выполения запроса
4410 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
4411 +
4412 + "Message": "string", ~/~/ Информация о выполнении запроса
4413 +
4414 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
4415 +
4416 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
4417 +
4418 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
4419 +
4420 + "Data": "string" ~/~/ Данные
4421 +
4422 +}
4423 +
4289 4289  == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==
4290 4290  
4291 4291  (% class="box infomessage" %)
... ... @@ -4444,7 +4444,7 @@
4444 4444  
4445 4445  (% class="box infomessage" %)
4446 4446  (((
4447 -POST /api/v3/fuelcards/transactions
4582 +**POST /api/v3/fuelcards/transactions**
4448 4448  )))
4449 4449  
4450 4450  Метод запроса: POST
... ... @@ -4482,7 +4482,32 @@
4482 4482   "address": "string" ~/~/ Адрес АЗС
4483 4483   }
4484 4484  
4620 +== (% style="color:#000000; font-size:16px" %)**Получение списка топливных карт**(%%) ==
4485 4485  
4622 +(% class="box infomessage" %)
4623 +(((
4624 +**GET /api/v3/fuelcards**
4625 +)))
4626 +
4627 +Метод запроса: GET
4628 +
4629 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список
4630 +
4631 +Ответ:
4632 +
4633 +[
4634 + {
4635 + "Name": "string", ~/~/ Определяет наименование карты.
4636 + "OperatorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Определяет идентификатор оператора.
4637 + "Number": "string", ~/~/ Определяет № карты.
4638 + "Enabled": true, ~/~/ Определяет признак активности карты.
4639 + "Description": "string", ~/~/ Определяет описание карты.
4640 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID карты
4641 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
4642 + "deleted": true ~/~/ Признак удаления
4643 + }
4644 +]
4645 +
4486 4486  = (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
4487 4487  
4488 4488  
... ... @@ -4733,6 +4733,90 @@
4733 4733  ]
4734 4734  
4735 4735  
4896 +== **Отчет трек-датчики** ==
4897 +
4898 +(% class="box infomessage" %)
4899 +(((
4900 +**POST /api/v3/Reports/sensorsWorks**
4901 +)))
4902 +
4903 +**Пример запроса:**
4904 +
4905 +{
4906 + "vehicleIds": [ ~/~/ Список ID объектов
4907 + 0
4908 + ],
4909 + "from": "2025-02-20T06:39:23.888Z",  ~/~/ Начало периода (локальное время клиента)
4910 + "to": "2025-02-20T06:39:23.888Z", ~/~/  Конец периода (локальное время клиента)
4911 + "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4912 +}
4913 +
4914 +**Пример ответа:**
4915 +
4916 +(((
4917 +{
4918 + "vehicleSensorWorks": [  ~/~/ Интервалы работы оборудования для конкретного ТС
4919 + {
4920 + "vehicleId": 0, ~/~/ Идентификатор ТС
4921 + "sensorWorks": [ ~/~/ Интервалы работы оборудования. 
4922 + {
4923 + "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования.
4924 + "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования.
4925 + "duration": 0, ~/~/  Продолжительность интервала в секундах.
4926 + "name": "string", ~/~/ Наименование оборудования.
4927 + "mileage": 0, ~/~/ Пробег за время работы оборудования.
4928 + "totalMileage": 0, ~/~/ Общий пробег.
4929 + "avgSpeed": 0 ~/~/ Средняя скорость.
4930 + }
4931 + ]
4932 + }
4933 + ]
4934 +}
4935 +
4936 +
4937 +== **Превышение скорости** ==
4938 +
4939 +(% class="box infomessage" %)
4940 +(((
4941 +**POST /api/v3/Reports/overSpeedDuration**
4942 +)))
4943 +
4944 + Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение).
4945 +
4946 +Пример запроса:
4947 +
4948 +(((
4949 +{
4950 + "vehicleId": 0, ~/~/ идентификационный номер транспортного средства
4951 + "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента)
4952 + "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента)
4953 + "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
4954 + "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 
4955 +}
4956 +)))
4957 +
4958 +(((
4959 +
4960 +)))
4961 +
4962 +(((
4963 +Пример ответа:
4964 +)))
4965 +
4966 +(((
4967 +(((
4968 +[
4969 + {
4970 + "eventDate": "2025-04-21T10:45:25.267Z", ~/~/  Дата и время события 
4971 + "duration": 0, ~/~/ Продолжительность события в секундах 
4972 + "maxSpeed": 0, ~/~/ Максимальная скорость 
4973 + "speedLimit": 0 ~/~/ Ограничение скорости 
4974 + }
4975 +]
4976 +)))
4977 +)))
4978 +)))
4979 +
4736 4736  = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
4737 4737  
4738 4738  
... ... @@ -4807,13 +4807,16 @@
4807 4807  **POST /api/v3/agroLands**
4808 4808  )))
4809 4809  
5054 +Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 
5055 +X-agent  - ID клиента
5056 +
4810 4810  Пример запроса:
4811 4811  
4812 4812  (((
4813 4813  {
4814 4814   "extId": "string", 
4815 - "shape": "string", ~/~/ Форма поля
4816 - "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
5062 + "shape": "{\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}", ~/~/ Форма поля
5063 + "shapeFormat": "geojson", ~/~/ Формат, в котором представлена форма поля
4817 4817   "display": "string", ~/~/ Настройки отображения
4818 4818   "year": 0, ~/~/ Год поля
4819 4819   "name": "string", ~/~/ Наименование
... ... @@ -5035,33 +5035,9 @@
5035 5035  )))
5036 5036  
5037 5037  
5038 -== **Удаление существующего поля** ==
5039 -
5040 -(% class="box errormessage" %)
5041 5041  (((
5042 -**DELETE /api/v3/agroLands/{id}**
5043 -)))
5044 -
5045 -Пример запроса:
5046 -id  ~/~/ Идентификатор поля
5047 -
5048 -Пример ответа:
5049 -
5050 5050  (((
5051 -200 ~/~/ Успех
5052 -)))
5053 -
5054 5054  (((
5055 -
5056 -)))
5057 -
5058 -(((
5059 -(((
5060 -(((
5061 -
5062 -)))
5063 -
5064 -(((
5065 5065  == **Изменение поля** ==
5066 5066  
5067 5067  (% class="box infomessage" %)
... ... @@ -5307,14 +5307,107 @@
5307 5307   "perimetr": 0, ~/~/ ериметр, м
5308 5308   "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
5309 5309  }
5533 +
5534 +
5535 +== **Какие поля посещал объект** ==
5536 +
5537 +(% class="box successmessage" %)
5538 +(((
5539 +**POST /api/v3/agroLands/visitingByVehicle**
5310 5310  )))
5311 5311  
5542 +Пример запроса:
5312 5312  
5313 -== (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) ==
5544 +{
5545 + "vehicleId": 0, ~/~/ id объекта 
5546 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
5547 + "byTime": 0, ~/~/ Объединение событий по времени
5548 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
5549 + "byDist": 0, ~/~/ Объединение событий по расстоянию
5550 + "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента)
5551 + "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента)
5552 + "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK
5553 +}
5554 +
5555 +Пример ответа:
5556 +
5557 +[
5558 + {
5559 + "fieldId": 0, ~/~/ id объекта 
5560 + "vehicleName": "string", ~/~/ Наименование объекта 
5561 + "fieldName": "string", ~/~/ Наименование поля 
5562 + "fuelUsage": 0, ~/~/ Расход топлива, л/га
5563 + "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата)
5564 + "vehicleId": 0, ~/~/ Идентификатор ТС
5565 + "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения
5566 + "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения
5567 + "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 
5568 + "mileage": 0 ~/~/ Пробег 
5569 + }
5570 +]
5314 5314  )))
5572 +
5573 +
5574 +== **Посещение поля объектами ** ==
5575 +
5576 +(% class="box successmessage" %)
5577 +(((
5578 +**POST /api/v3/agroLands/visitingByField**
5315 5315  )))
5580 +
5581 +Пример запроса:
5582 +{
5583 + "fieldId": 0, ~/~/ ID поля
5584 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
5585 + "byTime": 0, ~/~/ Объединение событий по времени
5586 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
5587 + "byDist": 0, ~/~/ Объединение событий по расстоянию
5588 + "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента)
5589 + "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента)
5590 + "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK
5591 +}
5592 +
5593 +Пример ответа:
5594 +
5595 +[
5596 + {
5597 + "fieldId": 0, ~/~/ ID поля
5598 + "vehicleName": "string", ~/~/ Наименование объекта 
5599 + "fieldName": "string", ~/~/ Имя поля
5600 + "fuelUsage": 0, ~/~/ Расход топлива, л/га
5601 + "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата)
5602 + "vehicleId": 0, ~/~/ Идентификатор ТС
5603 + "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения
5604 + "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения
5605 + "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 
5606 + "mileage": 0 ~/~/ Пробег
5607 + }
5608 +]
5609 +
5610 +
5611 +== **Удаление существующего поля** ==
5612 +
5613 +(% class="box errormessage" %)
5614 +(((
5615 +**DELETE /api/v3/agroLands/{id}**
5316 5316  )))
5317 5317  
5618 +Пример запроса:
5619 +id  ~/~/ Идентификатор поля
5620 +
5621 +Пример ответа:
5622 +
5623 +(((
5624 +200 ~/~/ Успех
5625 +
5626 +
5627 +)))
5628 +
5629 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
5630 +)))
5631 +)))
5632 +)))
5633 +
5318 5318  == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
5319 5319  
5320 5320  
... ... @@ -5355,7 +5355,7 @@
5355 5355  ]
5356 5356  
5357 5357  
5358 -(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**
5674 +== (% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==
5359 5359  
5360 5360  (% class="box infomessage" %)
5361 5361  (((
... ... @@ -5453,7 +5453,782 @@
5453 5453  ]
5454 5454  
5455 5455  
5772 += **Раздел: Журнал заданий ** =
5456 5456  
5774 +
5775 +== **Создание задания в Журнале заданий** ==
5776 +
5777 +(% class="box infomessage" %)
5778 +(((
5779 +**POST /api/v3/vehicletasks**
5780 +)))
5781 +
5782 +Пример запроса:
5783 +
5784 +(((
5785 +{
5786 + "vehicleId": 0, ~/~/ Идентификатор ТС
5787 + "description": "string", ~/~/ Описание
5788 + "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5789 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5790 + "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы
5791 + "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы
5792 + "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5793 + "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5794 + "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5795 + "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5796 + "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5797 + "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5798 + "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5799 + "cost": { 
5800 + "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5801 + "Name": "string", ~/~/ Наименование
5802 + "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection )
5803 + "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5804 + "Norm": 0 ~/~/ Норма внесения
5805 + },
5806 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 
5807 + "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5808 + "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания
5809 + "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления
5810 + "deleted": true, ~/~/ Признак удаления
5811 + "extId": "string", 
5812 + "GeoIds": [ ~/~/ Cвязанные поля
5813 + 0
5814 + ]
5815 +}
5816 +)))
5817 +
5818 +
5819 +Пример ответа:
5820 +
5821 +{
5822 + "vehicleId": 0, ~/~/ Идентификатор ТС
5823 + "description": "string", ~/~/ Описание
5824 + "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5825 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5826 + "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5827 + "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5828 + "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5829 + "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5830 + "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5831 + "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5832 + "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5833 + "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5834 + "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5835 + "cost": { 
5836 + "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5837 + "Name": "string", ~/~/ Наименование
5838 + "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5839 + "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5840 + "Norm": 0 ~/~/ Норма внесения
5841 + },
5842 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5843 + "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5844 + "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5845 + "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5846 + "deleted": true, ~/~/ Признак удаления
5847 + "extId": "string", ~/~/ ExtId
5848 + "GeoIds": [ ~/~/ Связанные поля
5849 + 0
5850 + ]
5851 +}
5852 +
5853 +
5854 +== **Редактирование задания в Журнале заданий** ==
5855 +
5856 +(% class="box successmessage" %)
5857 +(((
5858 +**PUT /api/v3/vehicletasks**
5859 +)))
5860 +
5861 +Пример запроса:
5862 +
5863 +(((
5864 +{
5865 + "vehicleId": 0, ~/~/ Идентификатор ТС
5866 + "description": "string", ~/~/ Описание
5867 + "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5868 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5869 + "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы
5870 + "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы
5871 + "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5872 + "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5873 + "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5874 + "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5875 + "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5876 + "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5877 + "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5878 + "cost": { 
5879 + "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5880 + "Name": "string", ~/~/ Наименование
5881 + "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5882 + "MeasureType": 0,  ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5883 + "Norm": 0 ~/~/ Норма внесения
5884 + },
5885 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5886 + "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5887 + "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания
5888 + "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления
5889 + "deleted": true, ~/~/ Признак удаления
5890 + "extId": "string", ~/~/ ExtId
5891 + "GeoIds": [ ~/~/ Связанные поля
5892 + 0
5893 + ]
5894 +}
5895 +)))
5896 +
5897 +
5898 +Пример ответа:
5899 +
5900 +{
5901 + "vehicleId": 0, ~/~/ Идентификатор ТС
5902 + "description": "string", ~/~/ Описание
5903 + "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5904 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5905 + "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5906 + "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5907 + "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5908 + "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5909 + "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5910 + "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5911 + "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5912 + "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5913 + "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5914 + "cost": { 
5915 + "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5916 + "Name": "string", ~/~/ Наименование
5917 + "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5918 + "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5919 + "Norm": 0 ~/~/ Норма внесения
5920 + },
5921 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5922 + "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5923 + "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5924 + "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5925 + "deleted": true, ~/~/ Признак удаления
5926 + "extId": "string", ~/~/ ExtId
5927 + "GeoIds": [ ~/~/ Связанные поля
5928 + 0
5929 + ]
5930 +}
5931 +
5932 +
5933 +== **Удаление задания в Журнале заданий** ==
5934 +
5935 +(% class="box warningmessage" %)
5936 +(((
5937 +**DELETE /api/v3/vehicletasks**
5938 +)))
5939 +
5940 +Пример запроса:
5941 +
5942 +(((
5943 +[
5944 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 
5945 +]
5946 +)))
5947 +
5948 +(((
5949 +
5950 +)))
5951 +
5952 +Пример ответа:
5953 +
5954 +{
5955 + "vehicleId": 0, ~/~/ Идентификатор ТС
5956 + "description": "string", ~/~/ Описание
5957 + "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата
5958 + "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя
5959 + "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы
5960 + "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы
5961 + "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ
5962 + "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция
5963 + "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата
5964 + "minWidth": 0, ~/~/ Минимальная ширина агрегата, м
5965 + "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м
5966 + "minSpeed": 0, ~/~/ Минимальная скорость, км/ч
5967 + "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч
5968 + "cost": { 
5969 + "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор
5970 + "Name": "string", ~/~/ Наименование
5971 + "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection)
5972 + "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 
5973 + "Norm": 0 ~/~/ Норма внесения
5974 + },
5975 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
5976 + "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя
5977 + "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания
5978 + "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления
5979 + "deleted": true, ~/~/ Признак удаления
5980 + "extId": "string", ~/~/ ExtId
5981 + "GeoIds": [ ~/~/ Связанные поля
5982 + 0
5983 + ]
5984 +}
5985 +
5986 +
5987 +== **Получение списка Журнала заданий** ==
5988 +
5989 +(% class="box infomessage" %)
5990 +(((
5991 +**POST /api/v3/vehicletasks/getbyperiod**
5992 +)))
5993 +
5994 +Пример запроса:
5995 +
5996 +(((
5997 +{
5998 + "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода.
5999 + "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода.
6000 + "TimeZone": 0, ~/~/ Часовой пояс.
6001 + "OperationsIds": [  ~/~/ Идентификаторы видов работ для фильтрации журнала
6002 + "3fa85f64-5717-4562-b3fc-2c963f66afa6"
6003 + ],
6004 + "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала
6005 + 0
6006 + ],
6007 + "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала
6008 + 0
6009 + ],
6010 + "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска.
6011 + "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 
6012 +}
6013 +)))
6014 +
6015 +
6016 +Пример ответа:
6017 +
6018 +(((
6019 +{
6020 + "total": 0,  ~/~/ Общее количество записей
6021 + "pages": 0,  ~/~/ Общее количество страниц
6022 + "currentPage": 0, ~/~/ Текущая страница
6023 + "items": [  ~/~/ Записи 
6024 + {
6025 + "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
6026 + "isGroup": true,  ~/~/ Вид задания (true - групповое, иначе - одиночное).
6027 + "name": "string", ~/~/ Название задания.
6028 + "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc
6029 + "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc
6030 + "workKind": "string", ~/~/ Вид работ
6031 + "techOp": "string", ~/~/ Тех. операция
6032 + "trailerModel": "string", ~/~/ Модель агрегата
6033 + "width": "string", ~/~/ Ширина, м
6034 + "speed": "string", ~/~/ Тех. скорость
6035 + "fields": "string", ~/~/ Поля
6036 + "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га)
6037 + "vehicles": "string", ~/~/ Объект-модель
6038 + "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов)
6039 + "drivers": "string", ~/~/ Водители
6040 + "tmc": "string", ~/~/ ТМЦ
6041 + "client": "string", ~/~/  Клиент
6042 + "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания
6043 + "dep": "string", ~/~/ Подразделение
6044 + "geoIds": [ ~/~/  Связанные поля
6045 + 0
6046 + ]
6047 + }
6048 + ]
6049 +}
6050 +)))
6051 +
6052 +
6053 += **Раздел: Роли** =
6054 +
6055 +== **Получение списка клиентских и системных ролей пользователя ** ==
6056 +
6057 +(% class="box successmessage" %)
6058 +(((
6059 +**POST /api/v3/groups/find**
6060 +)))
6061 +
6062 +Пример запроса:
6063 +
6064 +(((
6065 +{
6066 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли
6067 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 
6068 +}
6069 +)))
6070 +
6071 +(((
6072 +
6073 +)))
6074 +
6075 +(((
6076 +Пример ответа:
6077 +)))
6078 +
6079 +(((
6080 +(((
6081 +{
6082 + "groups": [  ~/~/ Системные роли пользователя
6083 + {
6084 + "code": "string", ~/~/ Код роли.
6085 + "name": "string", ~/~/ Имя  
6086 + "shortName": "string" ~/~/ Короткое имя 
6087 + }
6088 + ],
6089 + "customGroups": [ ~/~/ Системные роли пользователя
6090 + {
6091 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли.
6092 + "name": "string", ~/~/ Наименование 
6093 + "shortName": "string", ~/~/ Короткое наименование 
6094 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца
6095 + }
6096 + ]
6097 +}
6098 +)))
6099 +)))
6100 +
6101 +(((
6102 +
6103 +)))
6104 +
6105 +(((
6106 +
6107 +)))
6108 +
6109 += **Раздел: Локатор ** =
6110 +
6111 +
6112 +== **Получение данных по локатору** ==
6113 +
6114 +(% class="box infomessage" %)
6115 +(((
6116 +**GET /api/v3/locators/{locatorId}**
6117 +)))
6118 +
6119 +В запросе указывается locatorid - идентификатор локатора
6120 +
6121 +
6122 +Пример ответа:
6123 +
6124 +(((
6125 +(((
6126 +{
6127 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 
6128 + 0
6129 + ],
6130 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 
6131 + 0
6132 + ],
6133 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 
6134 + 0
6135 + ],
6136 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора.
6137 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
6138 + "agentName": "string", ~/~/ Наименование агента.
6139 + "isEnabled": true, ~/~/ Активность 
6140 + "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания
6141 + "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления
6142 + "name": "string", ~/~/ Наименование.
6143 + "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 
6144 + "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время)
6145 + "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации
6146 + "validity": 0, ~/~/ Значение срока действия
6147 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 
6148 + "autoProlongation": true, ~/~/ Автопродление срока действия.
6149 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
6150 + "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
6151 + "url": "string", ~/~/ Ссылка
6152 + "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
6153 +
6154 + "showVehicleName": true, ~/~/ Наименование объекта
6155 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
6156 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
6157 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
6158 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
6159 + "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ГИС)
6160 +
6161 + 1
6162 +
6163 + ]
6164 +}
6165 +)))
6166 +)))
6167 +
6168 +
6169 +(((
6170 +(((
6171 +
6172 +)))
6173 +)))
6174 +
6175 +
6176 +== **Создание локатора** ==
6177 +
6178 +(% class="box successmessage" %)
6179 +(((
6180 +**POST /api/v3/locators**
6181 +)))
6182 +
6183 +Пример запроса:
6184 +
6185 +(((
6186 +{
6187 + "isEnabled": true, ~/~/ Активность
6188 + "name": "string", ~/~/ Наименование локатора
6189 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени)
6190 + "activationTime": "2025-03-12T07:00:08.272Z", ~/~/  Время активации
6191 + "validity": 0, ~/~/ Срок действия в днях (1-90)
6192 + "autoProlongation": true, ~/~/ Автопродление срока действия.
6193 + "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
6194 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
6195 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 
6196 + 0
6197 + ],
6198 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 
6199 + 0
6200 + ],
6201 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 
6202 + 0
6203 + ],
6204 +
6205 + "showVehicleName": true, ~/~/ Наименование объекта
6206 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
6207 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
6208 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
6209 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
6210 + "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ГИС)
6211 +
6212 + 1
6213 +
6214 + ]
6215 +}
6216 +)))
6217 +
6218 +
6219 +Пример ответа:
6220 +
6221 +(((
6222 +3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора
6223 +)))
6224 +
6225 +
6226 +== **Выводит список локаторов ** ==
6227 +
6228 +(% class="box successmessage" %)
6229 +(((
6230 +**POST /api/v3/locators/find**
6231 +)))
6232 +
6233 +Пример запроса:
6234 +
6235 +(((
6236 +{
6237 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента
6238 +}
6239 +)))
6240 +
6241 +(((
6242 +
6243 +)))
6244 +
6245 +(((
6246 +
6247 +)))
6248 +
6249 +
6250 +Пример ответа:
6251 +
6252 +(((
6253 +[
6254 + {
6255 + "vehiclesCount": 0, ~/~/ Количество объектов.
6256 + "geozonesCount": 0, ~/~/ Количество геозон.
6257 + "fieldsCount": 0, ~/~/ Количество полей.
6258 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора.
6259 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
6260 + "agentName": "string", ~/~/ Наименование агента.
6261 + "isEnabled": true, ~/~/ Активность локатора
6262 + "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания
6263 + "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 
6264 + "name": "string", ~/~/ Наименование локатора 
6265 + "status": 0,  ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 
6266 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 
6267 + "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC)
6268 + "validity": 0, ~/~/ Срок действия в днях (1-90)
6269 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 
6270 + "autoProlongation": true, ~/~/ Автоматическая пролонгация 
6271 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
6272 + "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 
6273 + "url": "string", ~/~/ ссылка на локатор 
6274 + "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
6275 + "showVehicleName": true, ~/~/ Наименование объекта
6276 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
6277 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
6278 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
6279 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
6280 + "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ГИС)
6281 +
6282 + 0
6283 + ]
6284 + }
6285 +]
6286 +)))
6287 +
6288 +
6289 +== **Изменение локатора** ==
6290 +
6291 +(% class="box infomessage" %)
6292 +(((
6293 +**PUT /api/v3/locators**
6294 +)))
6295 +
6296 +Пример запроса:
6297 +
6298 +(((
6299 +{
6300 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
6301 + "isEnabled": true, ~/~/ Активность 
6302 + "name": "string", ~/~/ Наименование
6303 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 
6304 + "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации
6305 + "validity": 0, ~/~/ Срок действия в днях (1-90)
6306 + "autoProlongation": true, ~/~/ Автопродление срока действия
6307 + "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
6308 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 
6309 + 0
6310 + ],
6311 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 
6312 + 0
6313 + ],
6314 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 
6315 + 0
6316 + ],
6317 + "showVehicleName": true, ~/~/ Наименование объекта
6318 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
6319 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
6320 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
6321 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
6322 + "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ГИС)
6323 +
6324 + 0
6325 +
6326 + ]
6327 +}
6328 +
6329 +
6330 +)))
6331 +
6332 +Пример ответа:
6333 +
6334 +200 ~/~/ Success
6335 +
6336 +
6337 +== **Удалить локатор** ==
6338 +
6339 +(% class="box warningmessage" %)
6340 +(((
6341 +**DELETE /api/v3/locators**
6342 +)))
6343 +
6344 +Пример запроса:
6345 +
6346 +(((
6347 +[
6348 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора
6349 +]
6350 +)))
6351 +
6352 +
6353 += **Раздел: Яндекс Маршруты** =
6354 +
6355 +
6356 +== **Возвращение списка маршрутов** ==
6357 +
6358 +(% class="box infomessage" %)
6359 +(((
6360 +**GET /api/v3/TransportRoutes**
6361 +)))
6362 +
6363 +Пример запроса:
6364 +Id  ~/~/ Идентификатор поля
6365 +
6366 +Пример ответа:
6367 +
6368 +(((
6369 +[
6370 + {
6371 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 
6372 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6373 + "name": "string", ~/~/ Наименование маршрута.
6374 + "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6375 + "vehicles": [  ~/~/ Определяет список ТС для маршрута
6376 + 0
6377 + ]
6378 + }
6379 +]
6380 +)))
6381 +
6382 +
6383 +== **Добавить маршрут** ==
6384 +
6385 +(% class="box infomessage" %)
6386 +(((
6387 +**POST /api/v3/TransportRoutes**
6388 +)))
6389 +
6390 +Пример запроса: 
6391 +{
6392 + "name": "string",  ~/~/  Опредлеляет наименование маршрута.
6393 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6394 + "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6395 + "vehicles": [  ~/~/ Определяет список ТС для маршрута
6396 + 0
6397 + ]
6398 +}
6399 +
6400 +
6401 +Пример ответа:
6402 +
6403 +(((
6404 +{
6405 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6406 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6407 + "name": "string", ~/~/ Определяет наименование маршрута 
6408 + "kind": 0,  ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 
6409 + "vehicles": [ ~/~/ Определяет список ТС для маршрута
6410 + 0
6411 + ]
6412 +}
6413 +)))
6414 +
6415 +
6416 +== **Обновление маршрута** ==
6417 +
6418 +(% class="box successmessage" %)
6419 +(((
6420 +**PUT /api/v3/TransportRoutes**
6421 +)))
6422 +
6423 +Пример запроса:
6424 +
6425 +(((
6426 +{
6427 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6428 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6429 + "name": "string", ~/~/ Опредлеляет наименование маршрута.
6430 + "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water)
6431 + "vehicles": [ ~/~/ Определяет список ТС для маршрута
6432 + 0
6433 + ]
6434 +}
6435 +)))
6436 +
6437 +Пример ответа:
6438 +
6439 +(((
6440 +{
6441 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID
6442 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут
6443 + "name": "string", ~/~/ Определяет наименование маршрута 
6444 + "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water )
6445 + "vehicles": [ ~/~/ Определяет список ТС для маршрута
6446 + 0
6447 + ]
6448 +}
6449 +)))
6450 +
6451 +
6452 +== **Получить связки маршрутов ТС** ==
6453 +
6454 +(% class="box infomessage" %)
6455 +(((
6456 +**POST /api/v3/TransportRoutes/getroutesvehicles**
6457 +)))
6458 +
6459 +Пример запроса:
6460 +
6461 +(((
6462 +[
6463 + "3fa85f64-5717-4562-b3fc-2c963f66afa6"  ~/~/ идентификатор маршрута
6464 +]
6465 +)))
6466 +
6467 +Пример ответа:
6468 +
6469 +(((
6470 +[
6471 + {
6472 + "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС
6473 + "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута
6474 + }
6475 +]
6476 +)))
6477 +
6478 +
6479 +== **Удалить маршрут** ==
6480 +
6481 +(% class="box warningmessage" %)
6482 +(((
6483 +**DELETE /api/v3/TransportRoutes/{id}**
6484 +)))
6485 +
6486 +Пример запроса:
6487 +Id  ~/~/ Идентификатор поля
6488 +
6489 +
6490 += **Раздел: Управление доступа к машинам** =
6491 +
6492 +
6493 +== Получение списка транспортных средств видимых пользователю ==
6494 +
6495 +(% class="box infomessage" %)
6496 +(((
6497 +**GET /api/v3/UserVisibleVehicles/{userId}**
6498 +)))
6499 +
6500 +Пример ответа:
6501 +
6502 +(((
6503 +{
6504 + "vehicleIds": [  ~/~/ Идентификаторы ТС
6505 + 0
6506 + ]
6507 +}
6508 +)))
6509 +
6510 +
6511 +== Задает видимость транспортных средств пользователю ==
6512 +
6513 +(% class="box infomessage" %)
6514 +(((
6515 +**POST /api/v3/UserVisibleVehicles**
6516 +)))
6517 +
6518 +Пример запроса:
6519 +
6520 +(((
6521 +(((
6522 +{
6523 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор пользователя
6524 + "vehicleIds": [ ~/~/ Идентификаторы ТС
6525 + 0
6526 + ]
6527 +}
6528 +)))
6529 +
6530 +(((
6531 +
6532 +)))
6533 +
6534 +(((
6535 +Пример ответа :
6536 +)))
6537 +
6538 +(((
6539 +
6540 +)))
6541 +
6542 +(((
6543 +200 ~/~/ Success
6544 +)))
6545 +)))
6546 +
6547 +
5457 5457  (% class="box" lang="en-US" style="text-align: center;" %)
5458 5458  (((
5459 5459  (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **

Меню

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