Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Павел Субботин on 2025/12/11 11:25
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. subbotinpa1 +XWiki.Gadmin - Content
-
... ... @@ -6,16 +6,11 @@ 6 6 просим вас соблюдать несколько простых правил при использовании API-команд:## 7 7 ))) 8 8 9 -* Формировать не более 2запросавсекунду с кратковременным разрешением до3-х.9 +* Формировать не более 3 отчётов одновременно. 10 10 * Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 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" %)Идентификатор клиента-родителя ... ... @@ -287,6 +287,28 @@ 287 287 "bankKS": "string" ~/~/ корр. счёт 288 288 } 289 289 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 + 290 290 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 291 291 292 292 (% class="box warningmessage" %) ... ... @@ -432,7 +432,7 @@ 432 432 [ 433 433 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 434 434 ], 435 - "language": 1~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский440 + "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 436 436 } 437 437 { 438 438 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -744,11 +744,6 @@ 744 744 (% style="text-align:left" %) 745 745 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 746 746 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": false,863 + "deleted": true, 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": false,882 + "deleted": true, 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 ... ... @@ -1611,6 +1611,77 @@ 1611 1611 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1612 1612 1613 1613 1614 +== **Импортировать историю ТС (Асинхронный запрос)** == 1615 + 1616 +(% class="box successmessage" %) 1617 +((( 1618 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1619 +))) 1620 + 1621 +Метод запроса: **POST** 1622 + 1623 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1624 + 1625 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1626 + 1627 + 1628 +Ответ: 1629 + 1630 +{ 1631 + 1632 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1633 + 1634 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1635 + 1636 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1637 + 1638 + "Message": "string", ~/~/ Информация о выполнении запроса 1639 + 1640 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1641 + 1642 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1643 + 1644 + "Data": "string" ~/~/ Данные 1645 + 1646 +} 1647 + 1648 + 1649 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 1650 + 1651 +(% class="box infomessage" %) 1652 +((( 1653 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1654 +))) 1655 + 1656 +Метод запроса: **GET** 1657 + 1658 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1659 + 1660 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1661 + 1662 + 1663 +Ответ: 1664 + 1665 +{ 1666 + 1667 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1668 + 1669 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 1670 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1671 + 1672 + "Message": "string", ~/~/ Информация о выполнении запроса 1673 + 1674 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1675 + 1676 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1677 + 1678 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1679 + 1680 + "Data": "string" ~/~/ Данные 1681 + 1682 +} 1683 + 1684 + 1614 1614 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1615 1615 1616 1616 (% class="box infomessage" %) ... ... @@ -1756,6 +1756,7 @@ 1756 1756 "stage": "", ~/~/ Состояние 1757 1757 (% style="color:#000000" %) } 1758 1758 1830 +== == 1759 1759 1760 1760 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1761 1761 ... ... @@ -2372,7 +2372,7 @@ 2372 2372 Тело запроса: 2373 2373 2374 2374 { 2375 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2447 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2376 2376 "vehicleIds": [0], ~/~/ Список ID объектов 2377 2377 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2378 2378 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2395,8 +2395,6 @@ 2395 2395 "motohours": 0, ~/~/ Моточасы за период, секунды 2396 2396 "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2397 2397 "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2398 - "idlingTime": 0 ~/~/ Холостой ход за период, секунд 2399 - 2400 2400 } 2401 2401 ] 2402 2402 } ... ... @@ -2419,7 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2422 - "sampling": 86400, ~/~/ Частота дискретизации,секунд, минимум-60(если передано,то весь период бъётсяна подпериоды с указанной частотой)2492 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2423 2423 "vehicleIds": [0], ~/~/ Список ID объектов 2424 2424 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2425 2425 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2438,12 +2438,8 @@ 2438 2438 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2439 2439 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2440 2440 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2441 - "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2442 - "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2443 2443 "fuelConsumption": 0, ~/~/ Расход топлива 2444 2444 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2445 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2446 - 2447 2447 } 2448 2448 ] 2449 2449 } ... ... @@ -2489,8 +2489,7 @@ 2489 2489 "model": "string", ~/~/ Модель объекта 2490 2490 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2491 2491 { 2492 - "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 2493 - 2558 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2494 2494 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2495 2495 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2496 2496 "valueFuel": 0, ~/~/ Количество ... ... @@ -2569,415 +2569,156 @@ 2569 2569 В заголовках запроса: X-Auth: Токен авторизации 2570 2570 2571 2571 2572 -В массивеуказываемid объектов через запятую2637 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2573 2573 2574 2574 Ответ: 2575 - 2576 -[ 2577 2577 { 2578 - "vehicleId": 55728, ~/~/Идентификатор объекта2579 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",~/~/Guidобъекта2580 - "vehicleNumber": " 0105 КМ",~/~/Номер объекта2581 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",~/~/Время идатапоступления данных2582 - "recordTime": "202 5-06-27T12:37:19Z",~/~/Время идатаформированиеданных2583 - "state": 4,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.2584 - "speed": 31,~/~/Скорость объекта2585 - "course": 116,~/~/Курс движения [0;360]2586 - "latitude": 45.722128,~/~/Широта [-90°;90°].2587 - "longitude": 39.800432,~/~/Долгота [-180°;180°].2588 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/Адрес2589 - "geozones": [ ~/~/ Сведения по геозонам.2641 + "vehicleId": 0, ~/~/Идентификатор объекта. 2642 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2643 + "vehicleNumber": "string",~/~/Номер объекта. 2644 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2645 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2646 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2647 + "speed": 0,~/~/Скорость объекта. 2648 + "course": 0,~/~/Курс движения [0;360] 2649 + "latitude": 0,~/~/Широта [-90°;90°]. 2650 + "longitude": 0,~/~/Долгота [-180°;180°]. 2651 + "address": "string",~/~/Адрес. 2652 + "geozones": [ ~/~/Сведения по геозонам. 2590 2590 { 2591 - "id": 10225647, ~/~/ ID Геозоны 2592 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2593 - }, 2594 - { 2595 - "id": 10282875, ~/~/ ID Геозоны 2596 - "name": "Ё2" ~/~/ Наименование геозоны 2597 - }, 2598 - { 2599 - "id": 10226240, ~/~/ ID Геозоны 2600 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2601 - }, 2602 - { 2603 - "id": 9747869, ~/~/ ID Геозоны 2604 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2605 - }, 2606 - { 2607 - "id": 10221123, ~/~/ ID Геозоны 2608 - "name": "53r" ~/~/ Наименование геозоны 2609 - }, 2610 - { 2611 - "id": 10197638, ~/~/ ID Геозоны 2612 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2654 + "id": 0, 2655 + "name": "string" 2613 2613 } 2614 - ] 2615 - } 2616 2616 2617 2617 2618 2618 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2619 2619 2620 -== (% style="color:#000000; font-size:16px" %)**Получение и нформацииогеозонепоID геозоны**(%%) ==2661 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2621 2621 2622 2622 (% class="box infomessage" %) 2623 2623 ((( 2624 -** GET/api/v3/gis/{geozoneId}**2665 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2625 2625 ))) 2626 2626 2627 -Пример запроса: 2628 -\\geozoneId ~/~/ id геозоны 2668 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2629 2629 2670 +(% style="color:#000000" %)Метод запроса: **POST** 2630 2630 2631 -(% style="text-align:left" %) 2632 -Ответ: 2672 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2633 2633 2634 -((( 2635 -{ 2636 - "id": 0, ~/~/ Идентификатор объекта геозоны 2637 - "name": "string", ~/~/ Наименование объекта геозоны 2638 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2639 - "description": "string", ~/~/ Описание объекта геозоны 2640 - "beginCalc": "2025-12-04T07:13:04.658Z", ~/~/ Дата начала расчетов для геозоны 2641 - "endCalc": "2025-12-04T07:13:04.658Z", ~/~/ Дата окончания расчетов для геозоны 2642 - "settingsData": "string", ~/~/ Параметры отображения в формате XML. 2643 - "type": 0, ~/~/ Тип геозоны - линия,полигон 2644 - "radius": 0, ~/~/ Радиус геозоны 2645 - "shape": "string", ~/~/ Координаты геозоны 2646 - "shape_format": "string" ~/~/ Формат xml,json 2647 -} 2648 -))) 2674 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2649 2649 2650 -((( 2651 - 2652 -))) 2676 +(% style="text-align:left" %) 2677 +Тело запроса: 2653 2653 2654 -== **Удаление геообъекта ** == 2655 - 2656 -((( 2657 - 2658 -))) 2659 - 2660 -(% class="box errormessage" %) 2661 -((( 2662 -**DELETE /api/v3/gis/{geozoneId}** 2663 -))) 2664 - 2665 -((( 2666 -Пример запроса: 2667 -))) 2668 - 2669 -((( 2670 - 2671 -))) 2672 - 2673 -((( 2674 -geozoneId ~/~/ Id геообъекта 2675 -))) 2676 - 2677 -((( 2678 - 2679 -))) 2680 - 2681 -((( 2682 -Пример ответа: 2683 -))) 2684 - 2685 -((( 2686 - 2687 -))) 2688 - 2689 -((( 2690 -200 ~/~/ Success 2691 -))) 2692 - 2693 -((( 2694 - 2695 -))) 2696 - 2697 -== **Возвращение данных по пересечению объектами геозон ** == 2698 - 2699 -((( 2700 - 2701 -))) 2702 - 2703 -(% class="box successmessage" %) 2704 -((( 2705 -**POST /api/v3/gis/intersections/geozones** 2706 -))) 2707 - 2708 -((( 2709 -Пример запроса: 2710 -))) 2711 - 2712 -((( 2713 -((( 2679 +(% style="text-align:left" %) 2714 2714 { 2715 - "startDate": "2025-12-04T07:19:27.628Z", ~/~/ Дата и время начала расчета 2716 - "endDate": "2025-12-04T07:19:27.628Z", ~/~/ Дата и время конца расчета 2717 - "ids": [ ~/~/ Идентификаторы объектов 2718 - 0 2719 - ], 2720 - "byTime": 0, ~/~/ объединение геообъектов по времени (секунды) 2721 - "byDist": 0, ~/~/ объединение геообъектов по расстоянию(метры) 2722 - "filterByTime": 0, ~/~/ Фильтрация посещений по времени, сек. 2723 - "filterByHalfPerimeter": true, ~/~/ Фильтрация по половине периметра геообъекта 2724 - "includeMotoHours": true ~/~/ Флаг, включать ли моточасы в отчет 2681 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2725 2725 } 2726 -))) 2727 -))) 2728 2728 2729 -((( 2730 - 2731 -))) 2684 +(% style="text-align:left" %) 2685 +Ответ: 2732 2732 2733 -((( 2734 -Пример ответа: 2735 -))) 2736 - 2737 -((( 2738 -((( 2739 2739 [ 2740 2740 { 2741 - "geozoneId": 0, ~/~/ ID геозоны 2742 - "geozoneName": "string", ~/~/ Наименование геозоны 2743 - "startDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время входа из геозоны 2744 - "endDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время выхода из геозоны 2745 - "duration": 0, ~/~/ Продолжительность внутри геозоны 2746 - "vehicleId": 0, ~/~/ ID объекта 2747 - "vehicleName": "string", ~/~/ Имя объекта 2748 - "motoHours": 0 ~/~/ Моточасы 2689 + "id": 0, ~/~/ Идентификатор объекта геозоны 2690 + "name": "string", ~/~/ Название объекта геозоны 2691 + "type": 0, ~/~/ Тип объекта геозоны 2692 + "fname": "string", ~/~/ Имя файла 2693 + "parentId": "string", ~/~/ Идентификатор клиента 2694 + "radius": 0, ~/~/ Радиус геообъекта 2695 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2696 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2697 + "description": "string", ~/~/ Описание 2698 + "area": 0, ~/~/ Площадь, м^^2^^ 2699 + "perimetr": 0, ~/~/ Периметр, м 2700 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2749 2749 } 2750 2750 ] 2751 -))) 2752 -))) 2753 2753 2704 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2705 + 2706 +(% class="box infomessage" %) 2754 2754 ((( 2755 - 2708 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2756 2756 ))) 2757 2757 2758 -= =**Возвращениеданныхпо пересечениюгеозондляобъектов с заданнымиID ** ==2711 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2759 2759 2760 -((( 2761 - 2762 -))) 2713 +(% style="color:#000000" %)Метод запроса: **POST** 2763 2763 2764 -(% class="box successmessage" %) 2765 -((( 2766 -**POST /api/v3/gis/intersections/vehicles** 2767 -))) 2715 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2768 2768 2769 -((( 2770 -Пример запроса: 2771 -))) 2717 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2772 2772 2773 -((( 2774 - 2775 -))) 2719 +(% style="text-align:left" %) 2720 +Тело запроса: 2776 2776 2777 -((( 2778 -((( 2779 2779 { 2780 - "startDate": "2025-12-04T07:26:11.520Z", ~/~/ Дата и время начала расчета 2781 - "endDate": "2025-12-04T07:26:11.520Z", ~/~/ Дата и время конца расчета 2782 - "ids": [ ~/~/ Идентификаторы объектов 2783 - 0 2784 - ], 2785 - "byTime": 0, ~/~/ объединение геообъектов по времени (секунды) 2786 - "byDist": 0, ~/~/ объединение геообъектов по расстоянию(метры) 2787 - "filterByTime": 0, ~/~/ Фильтрация посещений по времени, сек. 2788 - "filterByHalfPerimeter": true, ~/~/ Фильтрация по половине периметра геообъекта 2789 - "includeMotoHours": true ~/~/ Флаг, включать ли моточасы в отчет 2723 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2724 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2725 + "ids": [ ], ~/~/ Массив id объектов 2726 + "byTime": 0, ~/~/ Объединение событий по времени 2727 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2728 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2729 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2790 2790 } 2791 -))) 2792 -))) 2793 2793 2794 -((( 2795 - 2796 -))) 2797 - 2798 -((( 2799 -Пример ответа: 2800 -))) 2801 - 2802 -((( 2732 +Ответ: 2803 2803 [ 2804 2804 { 2805 - "geozoneId": 0, ~/~/ ID гео зоны2806 - "geozoneName": "string", ~/~/ Наименование геозоны2807 - "startDate": "202 5-12-04T07:19:27.629Z", ~/~/Датуивремя входаиз геозоны2808 - "endDate": "202 5-12-04T07:19:27.629Z", ~/~/Датуивремя выхода из геозоны2809 - "duration": 0, ~/~/ Продолжительностьвнутри геозоны2735 + "geozoneId": 0, ~/~/ ID геообъекта 2736 + "geozoneName": "string", ~/~/ Название геообъекта 2737 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2738 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2739 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2810 2810 "vehicleId": 0, ~/~/ ID объекта 2811 - "vehicleName": "string", ~/~/ Имя объекта 2812 - "motoHours": 0 ~/~/ Моточасы 2741 + "vehicleName": "string" ~/~/ Имя объекта 2813 2813 } 2814 2814 ] 2815 -))) 2816 2816 2745 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2746 + 2747 +(% class="box infomessage" %) 2817 2817 ((( 2818 - 2749 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2819 2819 ))) 2820 2820 2821 -= =**Получениесписка геозон**==2752 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2822 2822 2823 -((( 2824 - 2825 -))) 2754 +(% style="color:#000000" %)Метод запроса: **POST** 2826 2826 2827 -(% class="box successmessage" %) 2828 -((( 2829 -**POST /api/v3/gis/find** 2830 -))) 2756 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2831 2831 2832 -((( 2833 -((( 2834 -Пример запроса: 2835 -))) 2758 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2836 2836 2837 -((( 2838 - 2839 -))) 2760 +(% style="text-align:left" %) 2761 +Тело запроса: 2840 2840 2841 -((( 2842 2842 { 2843 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента, для которого надо получить данные. 2764 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2765 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2766 + "ids": [ ], ~/~/ Массив id геообъектов 2767 + "byTime": 0, ~/~/ Объединение событий по времени 2768 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2769 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2770 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2844 2844 } 2845 -))) 2846 -))) 2847 2847 2848 -((( 2849 - 2850 -))) 2773 +Ответ: 2851 2851 2852 -((( 2853 -Пример ответа: 2854 -))) 2855 - 2856 -((( 2857 -((( 2858 2858 [ 2859 2859 { 2860 - "id": 0, ~/~/ Идентификатор объекта геозоны 2861 - "name": "string", ~/~/ Название объекта геозоны 2862 - "type": 0, ~/~/ Тип объекта геозоны 2863 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2864 - "fname": "string", ~/~/ Имя файла 2865 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента 2866 - "beginCalc": "2025-12-04T07:31:23.082Z", ~/~/ Дата начала расчетов для геозоны 2867 - "endCalc": "2025-12-04T07:31:23.082Z", ~/~/ Дата окончания расчетов для геозоны 2868 - "description": "string", ~/~/ Описание объекта геозоны 2869 - "area": 0, ~/~/ Площадь, м2 2870 - "perimetr": 0, ~/~/ Периметр, м 2871 - "createDate": "2025-12-04T07:31:23.082Z" ~/~/ Дата создания в бд 2777 + "geozoneId": 0, ~/~/ ID геообъекта 2778 + "geozoneName": "string", ~/~/ Название геообъекта 2779 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2780 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2781 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2782 + "vehicleId": 0, ~/~/ ID объекта 2783 + "vehicleName": "string" ~/~/ Имя объекта 2872 2872 } 2873 2873 ] 2874 -))) 2875 -))) 2876 2876 2877 -((( 2878 - 2879 -))) 2880 - 2881 -== **Создание геообъекта** == 2882 - 2883 -((( 2884 - 2885 -))) 2886 - 2887 -(% class="box successmessage" %) 2888 -((( 2889 -**POST /api/v3/gis** 2890 -))) 2891 - 2892 -((( 2893 -((( 2894 -Пример запроса: 2895 -\\{ 2896 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента 2897 - "name": "string", ~/~/ Наименование объекта геозоны 2898 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2899 - "description": "string", ~/~/ Описание объекта геозоны 2900 - "beginCalc": "2025-12-04T07:35:07.395Z", ~/~/ Дата начала расчетов для геозоны 2901 - "endCalc": "2025-12-04T07:35:07.395Z", ~/~/ Дата окончания расчетов для геозоны 2902 - "settingsData": "string", ~/~/ Параметры отображения в формате XML 2903 - "type": 0, ~/~/ Тип геозоны - линия,полигон 2904 - "radius": 0, ~/~/ Радиус геозоны 2905 - "shape": "string", ~/~/ Координаты геозоны 2906 - "shape_format": "string" ~/~/ Формат xml,json, 2907 -} 2908 -))) 2909 -))) 2910 - 2911 -((( 2912 - 2913 -))) 2914 - 2915 -((( 2916 -Пример ответа: 2917 -))) 2918 - 2919 -((( 2920 - 2921 -))) 2922 - 2923 -((( 2924 -200 ~/~/ Success 2925 -))) 2926 - 2927 -((( 2928 - 2929 -))) 2930 - 2931 -== **Редактирование геообъекта ** == 2932 - 2933 -((( 2934 - 2935 -))) 2936 - 2937 -(% class="box warningmessage" %) 2938 -((( 2939 -**PUT /api/v3/gis** 2940 -))) 2941 - 2942 -((( 2943 -((( 2944 -Пример запроса: 2945 -{ 2946 - "id": 0, ~/~/ Идентификатор объекта геозоны 2947 - "name": "string", ~/~/ Наименование объекта геозоны 2948 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2949 - "description": "string", ~/~/ Описание объекта геозоны 2950 - "beginCalc": "2025-12-04T07:38:55.221Z", ~/~/ Дата начала расчетов для геозоны 2951 - "endCalc": "2025-12-04T07:38:55.221Z", ~/~/ Дата окончания расчетов для геозоны 2952 - "settingsData": "string", ~/~/ Параметры отображения в формате XML. 2953 - "type": 0, ~/~/ Тип геозоны - линия,полигон 2954 - "radius": 0, ~/~/ Радиус геозоны 2955 - "shape": "string", ~/~/ Координаты геозоны 2956 - "shape_format": "string" ~/~/Формат xml,json 2957 -} 2958 -))) 2959 -))) 2960 - 2961 -((( 2962 - 2963 -))) 2964 - 2965 -((( 2966 -Пример ответа: 2967 -))) 2968 - 2969 -((( 2970 - 2971 -))) 2972 - 2973 -((( 2974 -200 ~/~/ Success 2975 -))) 2976 - 2977 -((( 2978 - 2979 -))) 2980 - 2981 2981 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2982 2982 2983 2983 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -3009,7 +3009,7 @@ 3009 3009 "id": 0, ~/~/ ID уведомления 3010 3010 "name": "string", ~/~/ Название уведомления 3011 3011 "active": true, ~/~/ Состояние true - активен, false - деактивирован 3012 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО , 13 - Назначение водителя)2818 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 3013 3013 "userId": "", ~/~/ Пользователь, создавший уведомление 3014 3014 "parentId": "", ~/~/ Идентификатор клиента 3015 3015 "parentName": "string" ~/~/ Имя клиента ... ... @@ -3016,151 +3016,6 @@ 3016 3016 } 3017 3017 ] 3018 3018 3019 - 3020 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 3021 - 3022 -(% class="box infomessage" %) 3023 -((( 3024 -**POST /api/v3/notifications** 3025 -))) 3026 - 3027 -Метод запроса **POST** 3028 - 3029 -(% style="text-align: left;" %) 3030 -(% style="color:#000000" %)Пример запроса 3031 - 3032 -((( 3033 -{ 3034 - "id": 0, ~/~/ ID правила 3035 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 3036 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 3037 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 3038 - "name": "string", ~/~/ Имя правила 3039 - "active": true, ~/~/ Активность правила 3040 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 3041 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 3042 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 3043 - ], 3044 - "vehicleIds": [ ~/~/ Список объектов для анализа. 3045 - 0 3046 - ], 3047 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 3048 - 0 3049 - ], 3050 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 3051 - 0 3052 - ], 3053 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 3054 - "additionalProp1": "string", 3055 - "additionalProp2": "string", 3056 - "additionalProp3": "string" 3057 - }, 3058 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 3059 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 3060 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 3061 - ], 3062 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 3063 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 3064 - "string" 3065 - ], 3066 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 3067 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 3068 - { 3069 - "id": 0, ~/~/ Идентификатор участника чата. 3070 - "info": "string" ~/~/ Дополнительные сведения. 3071 - } 3072 - ], 3073 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 3074 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 3075 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 3076 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 3077 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 3078 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 3079 - "timezone": 0, ~/~/ часовой пояс 3080 - "validity": 0, ~/~/ Срок действия в днях (1-90). 3081 - "autoProlongation": true, ~/~/ Автопродление срока действия. 3082 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 3083 - { 3084 - "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 - Срок действия правила истек 3085 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 3086 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 3087 - "additionalProp1": "string", 3088 - "additionalProp2": "string", 3089 - "additionalProp3": "string" 3090 - } 3091 - } 3092 - ] 3093 -} 3094 -))) 3095 - 3096 -((( 3097 - 3098 -))) 3099 - 3100 -Ответ: 3101 - 3102 -{ 3103 - "id": 0, ~/~/ ID правила 3104 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 3105 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 3106 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 3107 - "name": "string", ~/~/ Имя правила 3108 - "active": true, ~/~/ Активность правила 3109 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 3110 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 3111 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 3112 - ], 3113 - "vehicleIds": [ ~/~/ Список объектов для анализа. 3114 - 0 3115 - ], 3116 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 3117 - 0 3118 - ], 3119 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 3120 - 0 3121 - ], 3122 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 3123 - "additionalProp1": "string", 3124 - "additionalProp2": "string", 3125 - "additionalProp3": "string" 3126 - }, 3127 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 3128 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 3129 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 3130 - ], 3131 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 3132 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 3133 - "string" 3134 - ], 3135 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 3136 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 3137 - { 3138 - "id": 0, ~/~/ Идентификатор участника чата. 3139 - "info": "string" ~/~/ Дополнительные сведения. 3140 - } 3141 - ], 3142 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 3143 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 3144 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 3145 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 3146 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 3147 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 3148 - "timezone": 0, ~/~/ часовой пояс 3149 - "validity": 0, ~/~/ Срок действия в днях (1-90). 3150 - "autoProlongation": true, ~/~/ Автопродление срока действия. 3151 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 3152 - { 3153 - "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 - Срок действия правила истек 3154 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 3155 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 3156 - "additionalProp1": "string", 3157 - "additionalProp2": "string", 3158 - "additionalProp3": "string" 3159 - } 3160 - } 3161 - ] 3162 -} 3163 - 3164 3164 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 3165 3165 3166 3166 (% class="box infomessage" %) ... ... @@ -4378,12 +4378,16 @@ 4378 4378 Тело запроса: 4379 4379 4380 4380 { 4381 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4382 - "Balance": 0 ~/~/ Значение баланса.4042 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4043 + "Balance": 0 4383 4383 } 4384 4384 4385 4385 Ответ: Success 4386 4386 4048 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4049 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4050 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4051 + 4387 4387 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4388 4388 4389 4389 (% class="box warningmessage" %) ... ... @@ -4395,29 +4395,16 @@ 4395 4395 4396 4396 Тело запроса: 4397 4397 4398 -((( 4399 4399 { 4400 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4401 - "a mount": 0~/~/ Сумма пополнения баланса4064 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4065 + "Balance": 0 4402 4402 } 4403 -))) 4404 4404 4405 -((( 4406 - 4407 -))) 4408 - 4409 4409 Ответ: Success 4410 4410 4411 -((( 4412 -{ 4413 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4414 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4415 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4416 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4417 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4418 - "Description": "string" ~/~/ Описание корректировки. 4419 -} 4420 -))) 4070 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4071 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4072 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4421 4421 4422 4422 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4423 4423 ... ... @@ -4430,25 +4430,16 @@ 4430 4430 4431 4431 Тело запроса: 4432 4432 4433 -((( 4434 4434 { 4435 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4436 - "a mount": 0~/~/ Сумма списания с баланса4086 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4087 + "Balance": 0 4437 4437 } 4438 -))) 4439 4439 4440 4440 Ответ: Success 4441 4441 4442 -((( 4443 -{ 4444 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4445 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4446 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4447 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4448 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4449 - "Description": "string" ~/~/ Описание корректировки 4450 -} 4451 -))) 4092 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4093 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4094 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4452 4452 4453 4453 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4454 4454 ... ... @@ -4459,35 +4459,28 @@ 4459 4459 4460 4460 Тело запроса: 4461 4461 4462 -((( 4463 4463 { 4464 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4465 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4466 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4467 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4468 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4469 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4106 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4107 + "CalculationType": 0, 4108 + "PermissibleBalance": 0, 4109 + "DefermentDays": 0, 4110 + "SendUiNotifications": true, 4111 + "SendEmailNotifications": true, 4112 + "IsPrivate": true, 4470 4470 } 4471 -))) 4472 4472 4473 -((( 4474 - 4475 -))) 4476 - 4477 4477 Ответ: Success 4478 4478 4479 -((( 4480 -{ 4481 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4482 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4483 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4484 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4485 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4486 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4487 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4488 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4489 -} 4117 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4118 +|ClientId|Идентификатор клиента 4119 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4120 +|PermissibleBalance|Допустимый баланс 4121 +|DefermentDays|((( 4122 +Отсрочка, количество дней 4490 4490 ))) 4124 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4125 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4126 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4491 4491 4492 4492 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4493 4493 ... ... @@ -4499,68 +4499,35 @@ 4499 4499 Тело запроса: 4500 4500 4501 4501 { 4502 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4503 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4504 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4138 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4139 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4140 + "Features": [ 4505 4505 { 4506 - "Feature": "string", ~/~/ Код услуги.4507 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4508 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4509 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4510 - "Price": 0, ~/~/ Цена за единицу.4511 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4512 - "PeriodValue": 0, ~/~/ Значение периода.4513 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)4142 + "Feature": "string", 4143 + "IsEnabled": true, 4144 + "IsFactual": true, 4145 + "Limit": 0, 4146 + "Price": 0, 4147 + "DebitDate": "2023-10-18T13:26:58.987Z", 4148 + "PeriodValue": 0, 4149 + "PeriodType": 0 4514 4514 } 4515 4515 ] 4516 4516 } 4517 4517 4518 - 4519 4519 Ответ: Success 4520 4520 4521 -((( 4522 -{ 4523 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4524 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4525 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4526 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4527 - "Name": "string", ~/~/ Наименование. 4528 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4529 - "Constraint": { ~/~/ Ограничения по тарифу 4530 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4531 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4532 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4533 - }, 4534 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4535 - { 4536 - "Feature": "string", ~/~/Код услуги. 4537 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4538 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4539 - "Price": 0, ~/~/ Цена за единицу. 4540 - "PeriodValue": 0, ~/~/ Значение периода. 4541 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4542 - } 4543 - ], 4544 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4545 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4546 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4547 - }, 4548 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4549 - { 4550 - "Feature": "string", ~/~/ Код услуги. 4551 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4552 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4553 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4554 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4555 - "Price": 0, ~/~/ Цена за единицу. 4556 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4557 - "PeriodValue": 0, ~/~/ Значение периода. 4558 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4559 - "Quantity": 0 ~/~/ Количество использования услуги. 4560 - } 4561 - ] 4562 -} 4563 -))) 4156 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4157 +|ClientId|Идентификатор клиента 4158 +|PlanId|Идентификатор тарифного плана 4159 +|Feature|Код услуги 4160 +|IsEnabled|Признак, определяющий активирована ли услуга 4161 +|IsFactual|Признак, определяющий расчёт по факту 4162 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4163 +|Price|Цена за единицу. 4164 +|DebitDate|Следующий момент времени списания с баланса за услугу. 4165 +|PeriodValue|Значение периода. 4166 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4564 4564 4565 4565 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4566 4566 ... ... @@ -4665,43 +4665,6 @@ 4665 4665 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4666 4666 |msgCount|Кол-во обработанных сообщений всего 4667 4667 4668 -== **Импортировать историю ТС (Асинхронный запрос)** == 4669 - 4670 -(% class="box successmessage" %) 4671 -((( 4672 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4673 -))) 4674 - 4675 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4676 - 4677 -Метод запроса: **POST** 4678 - 4679 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4680 - 4681 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4682 - 4683 - 4684 -Ответ: 4685 - 4686 -{ 4687 - 4688 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4689 - 4690 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4691 - 4692 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4693 - 4694 - "Message": "string", ~/~/ Информация о выполнении запроса 4695 - 4696 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4697 - 4698 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4699 - 4700 - "Data": "string" ~/~/ Данные 4701 - 4702 -} 4703 - 4704 - 4705 4705 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4706 4706 4707 4707 (% class="box infomessage" %) ... ... @@ -4719,59 +4719,10 @@ 4719 4719 "message": "string" 4720 4720 } 4721 4721 4722 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4723 -**Параметр** 4724 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4725 -**Описание** 4726 -))) 4727 -|((( 4728 -activity 4729 -)))|((( 4730 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4731 -))) 4732 -|((( 4733 -progress 4734 -)))|((( 4735 -Guid ТС 4736 -))) 4288 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4289 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4290 +|progress|Guid ТС 4737 4737 4738 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4739 - 4740 -(% class="box infomessage" %) 4741 -((( 4742 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4743 -))) 4744 - 4745 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4746 - 4747 -Метод запроса: **GET** 4748 - 4749 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4750 - 4751 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4752 - 4753 - 4754 -Ответ: 4755 - 4756 -{ 4757 - 4758 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4759 - 4760 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4761 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4762 - 4763 - "Message": "string", ~/~/ Информация о выполнении запроса 4764 - 4765 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4766 - 4767 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4768 - 4769 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4770 - 4771 - "Data": "string" ~/~/ Данные 4772 - 4773 -} 4774 - 4775 4775 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4776 4776 4777 4777 (% class="box infomessage" %) ... ... @@ -4977,7 +4977,7 @@ 4977 4977 4978 4978 Метод запроса: GET 4979 4979 4980 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента ~/~/ ID клиента у которого нужно запросить список4497 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/fuelcards?ownerId=ID_клиента 4981 4981 4982 4982 Ответ: 4983 4983 ... ... @@ -5244,90 +5244,6 @@ 5244 5244 ] 5245 5245 5246 5246 5247 -== **Отчет трек-датчики** == 5248 - 5249 -(% class="box infomessage" %) 5250 -((( 5251 -**POST /api/v3/Reports/sensorsWorks** 5252 -))) 5253 - 5254 -**Пример запроса:** 5255 - 5256 -{ 5257 - "vehicleIds": [ ~/~/ Список ID объектов 5258 - 0 5259 - ], 5260 - "from": "2025-02-20T06:39:23.888Z", ~/~/ Начало периода (локальное время клиента) 5261 - "to": "2025-02-20T06:39:23.888Z", ~/~/ Конец периода (локальное время клиента) 5262 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5263 -} 5264 - 5265 -**Пример ответа:** 5266 - 5267 -((( 5268 -{ 5269 - "vehicleSensorWorks": [ ~/~/ Интервалы работы оборудования для конкретного ТС 5270 - { 5271 - "vehicleId": 0, ~/~/ Идентификатор ТС 5272 - "sensorWorks": [ ~/~/ Интервалы работы оборудования. 5273 - { 5274 - "start": "2025-02-20T06:39:23.979Z", ~/~/ Начало интервала работы оборудования. 5275 - "end": "2025-02-20T06:39:23.979Z", ~/~/ Конец интервала работы оборудования. 5276 - "duration": 0, ~/~/ Продолжительность интервала в секундах. 5277 - "name": "string", ~/~/ Наименование оборудования. 5278 - "mileage": 0, ~/~/ Пробег за время работы оборудования. 5279 - "totalMileage": 0, ~/~/ Общий пробег. 5280 - "avgSpeed": 0 ~/~/ Средняя скорость. 5281 - } 5282 - ] 5283 - } 5284 - ] 5285 -} 5286 - 5287 - 5288 -== **Превышение скорости** == 5289 - 5290 -(% class="box infomessage" %) 5291 -((( 5292 -**POST /api/v3/Reports/overSpeedDuration** 5293 -))) 5294 - 5295 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 5296 - 5297 -Пример запроса: 5298 - 5299 -((( 5300 -{ 5301 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 5302 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 5303 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 5304 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5305 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 5306 -} 5307 -))) 5308 - 5309 -((( 5310 - 5311 -))) 5312 - 5313 -((( 5314 -Пример ответа: 5315 -))) 5316 - 5317 -((( 5318 -((( 5319 -[ 5320 - { 5321 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 5322 - "duration": 0, ~/~/ Продолжительность события в секундах 5323 - "maxSpeed": 0, ~/~/ Максимальная скорость 5324 - "speedLimit": 0 ~/~/ Ограничение скорости 5325 - } 5326 -] 5327 -))) 5328 -))) 5329 -))) 5330 - 5331 5331 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 5332 5332 5333 5333 ... ... @@ -5402,16 +5402,13 @@ 5402 5402 **POST /api/v3/agroLands** 5403 5403 ))) 5404 5404 5405 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 5406 -X-agent - ID клиента 5407 - 5408 5408 Пример запроса: 5409 5409 5410 5410 ((( 5411 5411 { 5412 5412 "extId": "string", 5413 - "shape": " {\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}",~/~/ Форма поля5414 - "shapeFormat": " geojson", ~/~/ Формат, в котором представлена форма поля4843 + "shape": "string", ~/~/ Форма поля 4844 + "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5415 5415 "display": "string", ~/~/ Настройки отображения 5416 5416 "year": 0, ~/~/ Год поля 5417 5417 "name": "string", ~/~/ Наименование ... ... @@ -5633,9 +5633,33 @@ 5633 5633 ))) 5634 5634 5635 5635 5066 +== **Удаление существующего поля** == 5067 + 5068 +(% class="box errormessage" %) 5636 5636 ((( 5070 +**DELETE /api/v3/agroLands/{id}** 5071 +))) 5072 + 5073 +Пример запроса: 5074 +id ~/~/ Идентификатор поля 5075 + 5076 +Пример ответа: 5077 + 5637 5637 ((( 5079 +200 ~/~/ Успех 5080 +))) 5081 + 5638 5638 ((( 5083 + 5084 +))) 5085 + 5086 +((( 5087 +((( 5088 +((( 5089 + 5090 +))) 5091 + 5092 +((( 5639 5639 == **Изменение поля** == 5640 5640 5641 5641 (% class="box infomessage" %) ... ... @@ -5881,107 +5881,14 @@ 5881 5881 "perimetr": 0, ~/~/ ериметр, м 5882 5882 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5883 5883 } 5884 - 5885 - 5886 -== **Какие поля посещал объект** == 5887 - 5888 -(% class="box successmessage" %) 5889 -((( 5890 -**POST /api/v3/agroLands/visitingByVehicle** 5891 5891 ))) 5892 5892 5893 -Пример запроса: 5894 5894 5895 -{ 5896 - "vehicleId": 0, ~/~/ id объекта 5897 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5898 - "byTime": 0, ~/~/ Объединение событий по времени 5899 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5900 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5901 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5902 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5903 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5904 -} 5905 - 5906 -Пример ответа: 5907 - 5908 -[ 5909 - { 5910 - "fieldId": 0, ~/~/ id объекта 5911 - "vehicleName": "string", ~/~/ Наименование объекта 5912 - "fieldName": "string", ~/~/ Наименование поля 5913 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5914 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5915 - "vehicleId": 0, ~/~/ Идентификатор ТС 5916 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5917 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5918 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5919 - "mileage": 0 ~/~/ Пробег 5920 - } 5921 -] 5341 +== (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) == 5922 5922 ))) 5923 - 5924 - 5925 -== **Посещение поля объектами ** == 5926 - 5927 -(% class="box successmessage" %) 5928 -((( 5929 -**POST /api/v3/agroLands/visitingByField** 5930 5930 ))) 5931 - 5932 -Пример запроса: 5933 -{ 5934 - "fieldId": 0, ~/~/ ID поля 5935 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5936 - "byTime": 0, ~/~/ Объединение событий по времени 5937 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5938 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5939 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5940 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5941 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5942 -} 5943 - 5944 -Пример ответа: 5945 - 5946 -[ 5947 - { 5948 - "fieldId": 0, ~/~/ ID поля 5949 - "vehicleName": "string", ~/~/ Наименование объекта 5950 - "fieldName": "string", ~/~/ Имя поля 5951 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5952 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5953 - "vehicleId": 0, ~/~/ Идентификатор ТС 5954 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5955 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5956 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5957 - "mileage": 0 ~/~/ Пробег 5958 - } 5959 -] 5960 - 5961 - 5962 -== **Удаление существующего поля** == 5963 - 5964 -(% class="box errormessage" %) 5965 -((( 5966 -**DELETE /api/v3/agroLands/{id}** 5967 5967 ))) 5968 5968 5969 -Пример запроса: 5970 -id ~/~/ Идентификатор поля 5971 - 5972 -Пример ответа: 5973 - 5974 -((( 5975 -200 ~/~/ Успех 5976 - 5977 - 5978 -))) 5979 - 5980 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5981 -))) 5982 -))) 5983 -))) 5984 - 5985 5985 == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) == 5986 5986 5987 5987 ... ... @@ -6022,7 +6022,7 @@ 6022 6022 ] 6023 6023 6024 6024 6025 - ==(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины**(%%) ==5386 +(% style="color:#000000; font-size:16px" %)**Запрос на удаление объектов из корзины** 6026 6026 6027 6027 (% class="box infomessage" %) 6028 6028 ((( ... ... @@ -6079,6 +6079,7 @@ 6079 6079 6080 6080 В заголовках запроса: X-Auth: Токен авторизации 6081 6081 5443 + 6082 6082 Пример запроса: 6083 6083 6084 6084 ((( ... ... @@ -6119,575 +6119,7 @@ 6119 6119 ] 6120 6120 6121 6121 6122 -= **Раздел: Журнал заданий ** = 6123 6123 6124 - 6125 -== **Создание задания в Журнале заданий** == 6126 - 6127 -(% class="box infomessage" %) 6128 -((( 6129 -**POST /api/v3/vehicletasks** 6130 -))) 6131 - 6132 -Пример запроса: 6133 - 6134 -((( 6135 -{ 6136 - "vehicleId": 0, ~/~/ Идентификатор ТС 6137 - "description": "string", ~/~/ Описание 6138 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6139 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6140 - "startDate": "2025-02-25T12:11:04.874Z", ~/~/ Начало работы 6141 - "endDate": "2025-02-25T12:11:04.874Z", ~/~/ Окончание работы 6142 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6143 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6144 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6145 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6146 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6147 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6148 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6149 - "cost": { 6150 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6151 - "Name": "string", ~/~/ Наименование 6152 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection ) 6153 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6154 - "Norm": 0 ~/~/ Норма внесения 6155 - }, 6156 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id 6157 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6158 - "created": "2025-02-25T12:11:04.874Z", ~/~/ Дата создания 6159 - "updated": "2025-02-25T12:11:04.874Z", ~/~/ Дата обновления 6160 - "deleted": true, ~/~/ Признак удаления 6161 - "extId": "string", 6162 - "GeoIds": [ ~/~/ Cвязанные поля 6163 - 0 6164 - ] 6165 -} 6166 -))) 6167 - 6168 -Пример ответа: 6169 - 6170 -{ 6171 - "vehicleId": 0, ~/~/ Идентификатор ТС 6172 - "description": "string", ~/~/ Описание 6173 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6174 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6175 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 6176 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 6177 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6178 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6179 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6180 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6181 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6182 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6183 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6184 - "cost": { 6185 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6186 - "Name": "string", ~/~/ Наименование 6187 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 6188 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6189 - "Norm": 0 ~/~/ Норма внесения 6190 - }, 6191 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6192 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6193 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 6194 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 6195 - "deleted": true, ~/~/ Признак удаления 6196 - "extId": "string", ~/~/ ExtId 6197 - "GeoIds": [ ~/~/ Связанные поля 6198 - 0 6199 - ] 6200 -} 6201 - 6202 - 6203 -== **Редактирование задания в Журнале заданий** == 6204 - 6205 -(% class="box successmessage" %) 6206 -((( 6207 -**PUT /api/v3/vehicletasks** 6208 -))) 6209 - 6210 -Пример запроса: 6211 - 6212 -((( 6213 -{ 6214 - "vehicleId": 0, ~/~/ Идентификатор ТС 6215 - "description": "string", ~/~/ Описание 6216 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6217 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6218 - "startDate": "2025-02-25T12:25:51.090Z", ~/~/ Начало работы 6219 - "endDate": "2025-02-25T12:25:51.090Z", ~/~/ Окончание работы 6220 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6221 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6222 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6223 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6224 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6225 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6226 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6227 - "cost": { 6228 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6229 - "Name": "string", ~/~/ Наименование 6230 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 6231 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6232 - "Norm": 0 ~/~/ Норма внесения 6233 - }, 6234 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6235 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6236 - "created": "2025-02-25T12:25:51.090Z", ~/~/ Дата создания 6237 - "updated": "2025-02-25T12:25:51.090Z", ~/~/ Дата обновления 6238 - "deleted": true, ~/~/ Признак удаления 6239 - "extId": "string", ~/~/ ExtId 6240 - "GeoIds": [ ~/~/ Связанные поля 6241 - 0 6242 - ] 6243 -} 6244 -))) 6245 - 6246 - 6247 -Пример ответа: 6248 - 6249 -{ 6250 - "vehicleId": 0, ~/~/ Идентификатор ТС 6251 - "description": "string", ~/~/ Описание 6252 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6253 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6254 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 6255 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 6256 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6257 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6258 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6259 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6260 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6261 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6262 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6263 - "cost": { 6264 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6265 - "Name": "string", ~/~/ Наименование 6266 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 6267 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6268 - "Norm": 0 ~/~/ Норма внесения 6269 - }, 6270 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6271 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6272 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 6273 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 6274 - "deleted": true, ~/~/ Признак удаления 6275 - "extId": "string", ~/~/ ExtId 6276 - "GeoIds": [ ~/~/ Связанные поля 6277 - 0 6278 - ] 6279 -} 6280 - 6281 - 6282 -== **Удаление задания в Журнале заданий** == 6283 - 6284 -(% class="box warningmessage" %) 6285 -((( 6286 -**DELETE /api/v3/vehicletasks** 6287 -))) 6288 - 6289 -Пример запроса: 6290 - 6291 -((( 6292 -[ 6293 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор 6294 -] 6295 -))) 6296 - 6297 -((( 6298 -Пример ответа: 6299 -))) 6300 - 6301 -{ 6302 - "vehicleId": 0, ~/~/ Идентификатор ТС 6303 - "description": "string", ~/~/ Описание 6304 - "trailerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агрегата 6305 - "driverId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор водителя 6306 - "startDate": "2025-02-25T12:11:04.964Z", ~/~/ Начало работы 6307 - "endDate": "2025-02-25T12:11:04.964Z", ~/~/ Окончание работы 6308 - "techOperationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Вид работ 6309 - "techOperationDataId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Тех. операция 6310 - "trailerModelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Модель агрегата 6311 - "minWidth": 0, ~/~/ Минимальная ширина агрегата, м 6312 - "maxWidth": 0, ~/~/ Максимальная ширина агрегата, м 6313 - "minSpeed": 0, ~/~/ Минимальная скорость, км/ч 6314 - "maxSpeed": 0, ~/~/ Максимальная скорость, км/ч 6315 - "cost": { 6316 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор 6317 - "Name": "string", ~/~/ Наименование 6318 - "Type": 0, ~/~/ Тим ТМЦ (0 - Seed, 1 - Crop, 2 - Fertilizer, 3 - PlantProtection) 6319 - "MeasureType": 0, ~/~/ Единицы измерения (0 - Кг, 1 - Тонн, 2 - Центнеры, 3 - Литры) 6320 - "Norm": 0 ~/~/ Норма внесения 6321 - }, 6322 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6323 - "owner": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid родителя 6324 - "created": "2025-02-25T12:11:04.964Z", ~/~/ Дата создания 6325 - "updated": "2025-02-25T12:11:04.964Z", ~/~/ Дата обновления 6326 - "deleted": true, ~/~/ Признак удаления 6327 - "extId": "string", ~/~/ ExtId 6328 - "GeoIds": [ ~/~/ Связанные поля 6329 - 0 6330 - ] 6331 -} 6332 - 6333 - 6334 -== **Получение списка Журнала заданий** == 6335 - 6336 -(% class="box infomessage" %) 6337 -((( 6338 -**POST /api/v3/vehicletasks/getbyperiod** 6339 -))) 6340 - 6341 -Пример запроса: 6342 - 6343 -((( 6344 -{ 6345 - "Start": "2025-02-25T12:35:31.107Z", ~/~/ Начало периода. 6346 - "End": "2025-02-25T12:35:31.107Z", ~/~/ Окончание периода. 6347 - "TimeZone": 0, ~/~/ Часовой пояс. 6348 - "OperationsIds": [ ~/~/ Идентификаторы видов работ для фильтрации журнала 6349 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 6350 - ], 6351 - "GeoIds": [ ~/~/ Идентификаторы полей для фильтрации журнала 6352 - 0 6353 - ], 6354 - "VehiclesIds": [ ~/~/ Идентификаторы ТС для фильтрации журнала 6355 - 0 6356 - ], 6357 - "Offset": 0, ~/~/ Смещение от начала результата. Количество записей журнала для пропуска. 6358 - "Limit": 0 ~/~/ Размер страницы (количество записей на странице) 6359 -} 6360 -))) 6361 - 6362 - 6363 -Пример ответа: 6364 - 6365 -((( 6366 -{ 6367 - "total": 0, ~/~/ Общее количество записей 6368 - "pages": 0, ~/~/ Общее количество страниц 6369 - "currentPage": 0, ~/~/ Текущая страница 6370 - "items": [ ~/~/ Записи 6371 - { 6372 - "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6373 - "isGroup": true, ~/~/ Вид задания (true - групповое, иначе - одиночное). 6374 - "name": "string", ~/~/ Название задания. 6375 - "startDate": "2025-02-25T12:35:31.110Z", ~/~/ Начало, utc 6376 - "endDate": "2025-02-25T12:35:31.110Z", ~/~/ Окончание, utc 6377 - "workKind": "string", ~/~/ Вид работ 6378 - "techOp": "string", ~/~/ Тех. операция 6379 - "trailerModel": "string", ~/~/ Модель агрегата 6380 - "width": "string", ~/~/ Ширина, м 6381 - "speed": "string", ~/~/ Тех. скорость 6382 - "fields": "string", ~/~/ Поля 6383 - "fieldsInfo": "string", ~/~/ Количество полей (суммарная площадь га) 6384 - "vehicles": "string", ~/~/ Объект-модель 6385 - "vehiclesCount": 0, ~/~/ Объектов (суммарное количество объектов) 6386 - "drivers": "string", ~/~/ Водители 6387 - "tmc": "string", ~/~/ ТМЦ 6388 - "client": "string", ~/~/ Клиент 6389 - "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор задания 6390 - "dep": "string", ~/~/ Подразделение 6391 - "geoIds": [ ~/~/ Связанные поля 6392 - 0 6393 - ] 6394 - } 6395 - ] 6396 -} 6397 -))) 6398 - 6399 - 6400 -= **Раздел: Роли** = 6401 - 6402 -== **Получение списка клиентских и системных ролей пользователя ** == 6403 - 6404 -(% class="box successmessage" %) 6405 -((( 6406 -**POST /api/v3/groups/find** 6407 -))) 6408 - 6409 -Пример запроса: 6410 - 6411 -((( 6412 -{ 6413 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6414 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6415 -} 6416 -))) 6417 - 6418 -((( 6419 - 6420 -))) 6421 - 6422 -((( 6423 -Пример ответа: 6424 -))) 6425 - 6426 -((( 6427 -((( 6428 -{ 6429 - "groups": [ ~/~/ Системные роли пользователя 6430 - { 6431 - "code": "string", ~/~/ Код роли. 6432 - "name": "string", ~/~/ Имя 6433 - "shortName": "string" ~/~/ Короткое имя 6434 - } 6435 - ], 6436 - "customGroups": [ ~/~/ Системные роли пользователя 6437 - { 6438 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6439 - "name": "string", ~/~/ Наименование 6440 - "shortName": "string", ~/~/ Короткое наименование 6441 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6442 - } 6443 - ] 6444 -} 6445 -))) 6446 -))) 6447 - 6448 -((( 6449 - 6450 -))) 6451 - 6452 -= **Раздел: Локатор ** = 6453 - 6454 - 6455 -== **Получение данных по локатору** == 6456 - 6457 -(% class="box infomessage" %) 6458 -((( 6459 -**GET /api/v3/locators/{locatorId}** 6460 -))) 6461 - 6462 -В запросе указывается locatorid - идентификатор локатора 6463 - 6464 -Пример ответа: 6465 - 6466 -((( 6467 -((( 6468 -{ 6469 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6470 - 0 6471 - ], 6472 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6473 - 0 6474 - ], 6475 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6476 - 0 6477 - ], 6478 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6479 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6480 - "agentName": "string", ~/~/ Наименование агента. 6481 - "isEnabled": true, ~/~/ Активность 6482 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6483 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6484 - "name": "string", ~/~/ Наименование. 6485 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6486 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6487 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6488 - "validity": 0, ~/~/ Значение срока действия 6489 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6490 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6491 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6492 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6493 - "url": "string", ~/~/ Ссылка 6494 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6495 - 6496 - "showVehicleName": true, ~/~/ Наименование объекта 6497 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6498 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6499 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6500 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6501 - "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ГИС) 6502 - 6503 - 1 6504 - 6505 - ] 6506 -} 6507 -))) 6508 -))) 6509 - 6510 - 6511 -== **Создание локатора** == 6512 - 6513 -(% class="box successmessage" %) 6514 -((( 6515 -**POST /api/v3/locators** 6516 -))) 6517 - 6518 -Пример запроса: 6519 - 6520 -((( 6521 -{ 6522 - "isEnabled": true, ~/~/ Активность 6523 - "name": "string", ~/~/ Наименование локатора 6524 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6525 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6526 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6527 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6528 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6529 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6530 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6531 - 0 6532 - ], 6533 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6534 - 0 6535 - ], 6536 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6537 - 0 6538 - ], 6539 - 6540 - "showVehicleName": true, ~/~/ Наименование объекта 6541 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6542 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6543 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6544 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6545 - "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ГИС) 6546 - 6547 - 1 6548 - 6549 - ] 6550 -} 6551 -))) 6552 - 6553 -Пример ответа: 6554 - 6555 -((( 6556 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6557 -))) 6558 - 6559 - 6560 -== **Выводит список локаторов ** == 6561 - 6562 -(% class="box successmessage" %) 6563 -((( 6564 -**POST /api/v3/locators/find** 6565 -))) 6566 - 6567 -Пример запроса: 6568 - 6569 -((( 6570 -{ 6571 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6572 -} 6573 -))) 6574 - 6575 -((( 6576 - 6577 -))) 6578 - 6579 -Пример ответа: 6580 - 6581 -((( 6582 -[ 6583 - { 6584 - "vehiclesCount": 0, ~/~/ Количество объектов. 6585 - "geozonesCount": 0, ~/~/ Количество геозон. 6586 - "fieldsCount": 0, ~/~/ Количество полей. 6587 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6588 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6589 - "agentName": "string", ~/~/ Наименование агента. 6590 - "isEnabled": true, ~/~/ Активность локатора 6591 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6592 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6593 - "name": "string", ~/~/ Наименование локатора 6594 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6595 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6596 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6597 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6598 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6599 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6600 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6601 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6602 - "url": "string", ~/~/ ссылка на локатор 6603 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6604 - "showVehicleName": true, ~/~/ Наименование объекта 6605 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6606 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6607 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6608 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6609 - "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ГИС) 6610 - 6611 - 0 6612 - ] 6613 - } 6614 -] 6615 -))) 6616 - 6617 - 6618 -== **Изменение локатора** == 6619 - 6620 -(% class="box infomessage" %) 6621 -((( 6622 -**PUT /api/v3/locators** 6623 -))) 6624 - 6625 -Пример запроса: 6626 - 6627 -((( 6628 -{ 6629 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6630 - "isEnabled": true, ~/~/ Активность 6631 - "name": "string", ~/~/ Наименование 6632 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6633 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6634 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6635 - "autoProlongation": true, ~/~/ Автопродление срока действия 6636 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6637 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6638 - 0 6639 - ], 6640 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6641 - 0 6642 - ], 6643 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6644 - 0 6645 - ], 6646 - "showVehicleName": true, ~/~/ Наименование объекта 6647 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6648 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6649 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6650 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6651 - "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ГИС) 6652 - 6653 - 0 6654 - 6655 - ] 6656 -} 6657 - 6658 - 6659 -))) 6660 - 6661 -Пример ответа: 6662 - 6663 -200 ~/~/ Success 6664 - 6665 - 6666 -== **Удалить локатор** == 6667 - 6668 -(% class="box warningmessage" %) 6669 -((( 6670 -**DELETE /api/v3/locators** 6671 -))) 6672 - 6673 -Пример запроса: 6674 - 6675 -((( 6676 -[ 6677 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6678 -] 6679 -))) 6680 - 6681 - 6682 -= = 6683 - 6684 -((( 6685 -((( 6686 - 6687 -))) 6688 -))) 6689 - 6690 - 6691 6691 (% class="box" lang="en-US" style="text-align: center;" %) 6692 6692 ((( 6693 6693 (% 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]] **