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,7 +6,7 @@ 6 6 просим вас соблюдать несколько простых правил при использовании API-команд:## 7 7 ))) 8 8 9 -* Формировать не более 2запросавсекунду с кратковременным разрешением до3-х.9 +* Формировать не более 3 отчётов одновременно. 10 10 * Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. ... ... @@ -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 -))) 127 + "agentId": "", (%%) 128 + "parentId": "", 129 + "parentName": "string", 130 + "name": "string", 131 + "fullName": "string", 132 + "agentInfoType": 0, 133 + "isForeign": true/false, 134 + "district": "string", 135 + "region": "string", 136 + "city": "string", 137 + "inn": "string", 138 + "kpp": "string", 139 + "address": "string", 140 + "addressFact": "string", 141 + "email": "string", 142 + "director": "string", 143 + "bankName": "string", 144 + "bankBIK": "string", 145 + "bankRS": "string", 146 + "bankKS": "string" 147 + } 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 278 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 279 +|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 280 +|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 281 +|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 282 +|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 283 +|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 284 +|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 285 +|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 286 +|(% style="width:215px" %)district|(% style="width:861px" %)Округ 287 +|(% style="width:215px" %)region|(% style="width:861px" %)Регион 288 +|(% style="width:215px" %)city|(% style="width:861px" %)Город 289 +|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 290 +|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 291 +|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 292 +|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 293 +|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 294 +|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 295 +|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 296 +|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 297 +|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 298 +|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 299 + 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 - Азербайджанский445 + "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,868 + "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,887 + "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" %)Метод позволяет изменить статус модели, указанного в запросе.921 +(% 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" %)Метод позволяет удалить модели. Метод позволяет удалитьмодель, указанного в строке запроса.988 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 984 984 985 985 (% style="color:#000000" %)Метод запроса: **DELETE** 986 986 ... ... @@ -1611,6 +1611,77 @@ 1611 1611 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1612 1612 1613 1613 1619 +== **Импортировать историю ТС (Асинхронный запрос)** == 1620 + 1621 +(% class="box successmessage" %) 1622 +((( 1623 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1624 +))) 1625 + 1626 +Метод запроса: **POST** 1627 + 1628 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1629 + 1630 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1631 + 1632 + 1633 +Ответ: 1634 + 1635 +{ 1636 + 1637 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1638 + 1639 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1640 + 1641 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1642 + 1643 + "Message": "string", ~/~/ Информация о выполнении запроса 1644 + 1645 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1646 + 1647 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1648 + 1649 + "Data": "string" ~/~/ Данные 1650 + 1651 +} 1652 + 1653 + 1654 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 1655 + 1656 +(% class="box infomessage" %) 1657 +((( 1658 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1659 +))) 1660 + 1661 +Метод запроса: **GET** 1662 + 1663 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1664 + 1665 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1666 + 1667 + 1668 +Ответ: 1669 + 1670 +{ 1671 + 1672 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1673 + 1674 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 1675 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1676 + 1677 + "Message": "string", ~/~/ Информация о выполнении запроса 1678 + 1679 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1680 + 1681 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1682 + 1683 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1684 + 1685 + "Data": "string" ~/~/ Данные 1686 + 1687 +} 1688 + 1689 + 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 1835 +== == 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 секунд. Весь период разбивает на подпериоды с указанной частотой.2452 + "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", ~/~/ Окончание периода ... ... @@ -2419,7 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2422 - "sampling": 0, ~/~/ Частота дискретизации, п араметригнорируется2499 + "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,8 +2438,6 @@ 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 2445 "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне ... ... @@ -2569,415 +2569,156 @@ 2569 2569 В заголовках запроса: X-Auth: Токен авторизации 2570 2570 2571 2571 2572 -В массивеуказываемid объектов через запятую2647 +В теле запроса перечисляете массив 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": [ ~/~/ Сведения по геозонам.2651 + "vehicleId": 0, ~/~/Идентификатор объекта. 2652 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2653 + "vehicleNumber": "string",~/~/Номер объекта. 2654 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2655 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2656 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2657 + "speed": 0,~/~/Скорость объекта. 2658 + "course": 0,~/~/Курс движения [0;360] 2659 + "latitude": 0,~/~/Широта [-90°;90°]. 2660 + "longitude": 0,~/~/Долгота [-180°;180°]. 2661 + "address": "string",~/~/Адрес. 2662 + "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" ~/~/ Наименование геозоны 2664 + "id": 0, 2665 + "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 геозоны**(%%) ==2671 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2621 2621 2622 2622 (% class="box infomessage" %) 2623 2623 ((( 2624 -** GET/api/v3/gis/{geozoneId}**2675 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2625 2625 ))) 2626 2626 2627 -Пример запроса: 2628 -\\geozoneId ~/~/ id геозоны 2678 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2629 2629 2680 +(% style="color:#000000" %)Метод запроса: **POST** 2630 2630 2631 -(% style="text-align:left" %) 2632 -Ответ: 2682 +(% 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 -))) 2684 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2649 2649 2650 -((( 2651 - 2652 -))) 2686 +(% style="text-align:left" %) 2687 +Тело запроса: 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 -((( 2689 +(% 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 ~/~/ Флаг, включать ли моточасы в отчет 2691 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2725 2725 } 2726 -))) 2727 -))) 2728 2728 2729 -((( 2730 - 2731 -))) 2694 +(% style="text-align:left" %) 2695 +Ответ: 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 ~/~/ Моточасы 2699 + "id": 0, ~/~/ Идентификатор объекта геозоны 2700 + "name": "string", ~/~/ Название объекта геозоны 2701 + "type": 0, ~/~/ Тип объекта геозоны 2702 + "fname": "string", ~/~/ Имя файла 2703 + "parentId": "string", ~/~/ Идентификатор клиента 2704 + "radius": 0, ~/~/ Радиус геообъекта 2705 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2706 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2707 + "description": "string", ~/~/ Описание 2708 + "area": 0, ~/~/ Площадь, м^^2^^ 2709 + "perimetr": 0, ~/~/ Периметр, м 2710 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2749 2749 } 2750 2750 ] 2751 -))) 2752 -))) 2753 2753 2714 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2715 + 2716 +(% class="box infomessage" %) 2754 2754 ((( 2755 - 2718 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2756 2756 ))) 2757 2757 2758 -= =**Возвращениеданныхпо пересечениюгеозондляобъектов с заданнымиID ** ==2721 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2759 2759 2760 -((( 2761 - 2762 -))) 2723 +(% style="color:#000000" %)Метод запроса: **POST** 2763 2763 2764 -(% class="box successmessage" %) 2765 -((( 2766 -**POST /api/v3/gis/intersections/vehicles** 2767 -))) 2725 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2768 2768 2769 -((( 2770 -Пример запроса: 2771 -))) 2727 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2772 2772 2773 -((( 2774 - 2775 -))) 2729 +(% style="text-align:left" %) 2730 +Тело запроса: 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 ~/~/ Флаг, включать ли моточасы в отчет 2733 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2734 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2735 + "ids": [ ], ~/~/ Массив id объектов 2736 + "byTime": 0, ~/~/ Объединение событий по времени 2737 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2738 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2739 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2790 2790 } 2791 -))) 2792 -))) 2793 2793 2794 -((( 2795 - 2796 -))) 2797 - 2798 -((( 2799 -Пример ответа: 2800 -))) 2801 - 2802 -((( 2742 +Ответ: 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, ~/~/ Продолжительностьвнутри геозоны2745 + "geozoneId": 0, ~/~/ ID геообъекта 2746 + "geozoneName": "string", ~/~/ Название геообъекта 2747 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2748 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2749 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2810 2810 "vehicleId": 0, ~/~/ ID объекта 2811 - "vehicleName": "string", ~/~/ Имя объекта 2812 - "motoHours": 0 ~/~/ Моточасы 2751 + "vehicleName": "string" ~/~/ Имя объекта 2813 2813 } 2814 2814 ] 2815 -))) 2816 2816 2755 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2756 + 2757 +(% class="box infomessage" %) 2817 2817 ((( 2818 - 2759 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2819 2819 ))) 2820 2820 2821 -= =**Получениесписка геозон**==2762 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2822 2822 2823 -((( 2824 - 2825 -))) 2764 +(% style="color:#000000" %)Метод запроса: **POST** 2826 2826 2827 -(% class="box successmessage" %) 2828 -((( 2829 -**POST /api/v3/gis/find** 2830 -))) 2766 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2831 2831 2832 -((( 2833 -((( 2834 -Пример запроса: 2835 -))) 2768 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2836 2836 2837 -((( 2838 - 2839 -))) 2770 +(% style="text-align:left" %) 2771 +Тело запроса: 2840 2840 2841 -((( 2842 2842 { 2843 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента, для которого надо получить данные. 2774 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2775 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2776 + "ids": [ ], ~/~/ Массив id геообъектов 2777 + "byTime": 0, ~/~/ Объединение событий по времени 2778 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2779 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2780 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2844 2844 } 2845 -))) 2846 -))) 2847 2847 2848 -((( 2849 - 2850 -))) 2783 +Ответ: 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" ~/~/ Дата создания в бд 2787 + "geozoneId": 0, ~/~/ ID геообъекта 2788 + "geozoneName": "string", ~/~/ Название геообъекта 2789 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2790 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2791 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2792 + "vehicleId": 0, ~/~/ ID объекта 2793 + "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 - Назначение водителя)2828 + "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 ~/~/ Значение баланса.4052 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4053 + "Balance": 0 4383 4383 } 4384 4384 4385 4385 Ответ: Success 4386 4386 4058 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4059 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4060 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4061 + 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~/~/ Сумма пополнения баланса4074 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4075 + "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 -))) 4080 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4081 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4082 +|(% 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~/~/ Сумма списания с баланса4096 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4097 + "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 -))) 4102 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4103 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4104 +|(% 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 - выключено 4116 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4117 + "CalculationType": 0, 4118 + "PermissibleBalance": 0, 4119 + "DefermentDays": 0, 4120 + "SendUiNotifications": true, 4121 + "SendEmailNotifications": true, 4122 + "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 -} 4127 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4128 +|ClientId|Идентификатор клиента 4129 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4130 +|PermissibleBalance|Допустимый баланс 4131 +|DefermentDays|((( 4132 +Отсрочка, количество дней 4490 4490 ))) 4134 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4135 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4136 +|(% 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": [ ~/~/ Набор услуг по тарифу клиента.4148 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4149 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4150 + "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 - Месяцы)4152 + "Feature": "string", 4153 + "IsEnabled": true, 4154 + "IsFactual": true, 4155 + "Limit": 0, 4156 + "Price": 0, 4157 + "DebitDate": "2023-10-18T13:26:58.987Z", 4158 + "PeriodValue": 0, 4159 + "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 -))) 4166 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4167 +|ClientId|Идентификатор клиента 4168 +|PlanId|Идентификатор тарифного плана 4169 +|Feature|Код услуги 4170 +|IsEnabled|Признак, определяющий активирована ли услуга 4171 +|IsFactual|Признак, определяющий расчёт по факту 4172 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4173 +|Price|Цена за единицу. 4174 +|DebitDate|Следующий момент времени списания с баланса за услугу. 4175 +|PeriodValue|Значение периода. 4176 +|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 -))) 4298 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4299 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4300 +|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" %) ... ... @@ -5283,51 +5283,8 @@ 5283 5283 } 5284 5284 ] 5285 5285 } 5286 - 5287 - 5288 -== **Превышение скорости** == 5289 - 5290 -(% class="box infomessage" %) 5291 -((( 5292 -**POST /api/v3/Reports/overSpeedDuration** 5293 5293 ))) 5294 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 ... ... @@ -5633,9 +5633,33 @@ 5633 5633 ))) 5634 5634 5635 5635 5120 +== **Удаление существующего поля** == 5121 + 5122 +(% class="box errormessage" %) 5636 5636 ((( 5124 +**DELETE /api/v3/agroLands/{id}** 5125 +))) 5126 + 5127 +Пример запроса: 5128 +id ~/~/ Идентификатор поля 5129 + 5130 +Пример ответа: 5131 + 5637 5637 ((( 5133 +200 ~/~/ Успех 5134 +))) 5135 + 5638 5638 ((( 5137 + 5138 +))) 5139 + 5140 +((( 5141 +((( 5142 +((( 5143 + 5144 +))) 5145 + 5146 +((( 5639 5639 == **Изменение поля** == 5640 5640 5641 5641 (% class="box infomessage" %) ... ... @@ -5881,102 +5881,9 @@ 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 -] 5922 -))) 5923 - 5924 - 5925 -== **Посещение поля объектами ** == 5926 - 5927 -(% class="box successmessage" %) 5928 -((( 5929 -**POST /api/v3/agroLands/visitingByField** 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 -))) 5968 - 5969 -Пример запроса: 5970 -id ~/~/ Идентификатор поля 5971 - 5972 -Пример ответа: 5973 - 5974 -((( 5975 -200 ~/~/ Успех 5976 - 5977 - 5978 -))) 5979 - 5980 5980 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5981 5981 ))) 5982 5982 ))) ... ... @@ -6079,6 +6079,7 @@ 6079 6079 6080 6080 В заголовках запроса: X-Auth: Токен авторизации 6081 6081 5497 + 6082 6082 Пример запроса: 6083 6083 6084 6084 ((( ... ... @@ -6165,6 +6165,7 @@ 6165 6165 } 6166 6166 ))) 6167 6167 5584 + 6168 6168 Пример ответа: 6169 6169 6170 6170 { ... ... @@ -6295,9 +6295,11 @@ 6295 6295 ))) 6296 6296 6297 6297 ((( 6298 - Примерответа:5715 + 6299 6299 ))) 6300 6300 5718 +Пример ответа: 5719 + 6301 6301 { 6302 6302 "vehicleId": 0, ~/~/ Идентификатор ТС 6303 6303 "description": "string", ~/~/ Описание ... ... @@ -6397,117 +6397,49 @@ 6397 6397 ))) 6398 6398 6399 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 6452 = **Раздел: Локатор ** = 6453 6453 6454 6454 6455 -== **Получение данных полокатору** ==5822 +== **Получение списка локаторов, доступных пользователю ** == 6456 6456 6457 6457 (% class="box infomessage" %) 6458 6458 ((( 6459 -**GET /api/v3/locators /{locatorId}**5826 +**GET /api/v3/locators** 6460 6460 ))) 6461 6461 6462 -В за просе указываетсяlocatorid- идентификаторлокатора5829 +В заголовках запроса: X-Auth: Токен авторизации 6463 6463 5831 + 6464 6464 Пример ответа: 6465 6465 6466 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 -} 5835 +[ 5836 + { 5837 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5838 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5839 + "agentName": "string", ~/~/ Наименование агента. 5840 + "isEnabled": true, ~/~/ Активен 5841 + "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5842 + "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5843 + "name": "string", ~/~/ Наименование 5844 + "status": 0, ~/~/ 5845 + "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5846 + "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5847 + "validity": 0, ~/~/ Срок действия в днях (1-90). 5848 + "autoProlongation": true, ~/~/ Автопродление срока действия. 5849 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5850 + "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5851 + "url": "string", ~/~/ Ссылка 5852 + "language": 0, ~/~/ Язык. 5853 + "vehiclesCount": 0, ~/~/ Количество объектов. 5854 + "geozonesCount": 0, ~/~/ Количество геозон. 5855 + "fieldsCount": 0 ~/~/ Количество полей. 5856 + } 5857 +] 6507 6507 ))) 6508 -))) 6509 6509 6510 6510 5861 + 6511 6511 == **Создание локатора** == 6512 6512 6513 6513 (% class="box successmessage" %) ... ... @@ -6519,6 +6519,7 @@ 6519 6519 6520 6520 ((( 6521 6521 { 5873 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6522 6522 "isEnabled": true, ~/~/ Активность 6523 6523 "name": "string", ~/~/ Наименование локатора 6524 6524 "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) ... ... @@ -6525,31 +6525,12 @@ 6525 6525 "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6526 6526 "validity": 0, ~/~/ Срок действия в днях (1-90) 6527 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 - ] 5880 + "url": "string", ~/~/ Ссылка 5881 + "language": 0 ~/~/ Язык 6550 6550 } 6551 6551 ))) 6552 6552 5885 + 6553 6553 Пример ответа: 6554 6554 6555 6555 ((( ... ... @@ -6557,64 +6557,7 @@ 6557 6557 ))) 6558 6558 6559 6559 6560 -== **Выводит список локаторов ** == 6561 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 6618 == **Изменение локатора** == 6619 6619 6620 6620 (% class="box infomessage" %) ... ... @@ -6633,31 +6633,12 @@ 6633 6633 "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6634 6634 "validity": 0, ~/~/ Срок действия в днях (1-90) 6635 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 - ] 5912 + "url": "string", ~/~/ Ссылка 5913 + "language": 0 ~/~/ Язык 6656 6656 } 6657 - 6658 - 6659 6659 ))) 6660 6660 5917 + 6661 6661 Пример ответа: 6662 6662 6663 6663 200 ~/~/ Success ... ... @@ -6679,15 +6679,8 @@ 6679 6679 ))) 6680 6680 6681 6681 6682 -= = 6683 6683 6684 -((( 6685 -((( 6686 - 6687 -))) 6688 -))) 6689 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]] **