Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/09/11 10:51
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -11,11 +11,6 @@ 11 11 12 12 В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов. 13 13 14 -(% class="box infomessage" %) 15 -((( 16 -**Чтобы избежать блокировки** из-за превышения количества авторизаций, вам необходимо использовать токен авторизации, полученный с помощью метода /auth/login, во всех последующих запросах к API. Этот токен имеет ограниченный срок действия, который можно изменить, настроив параметр "Длительность сессии" в настройках пользователя. 17 -\\При выполнении запросов с одним и тем же токеном его срок действия автоматически продлевается. Это позволяет пройти авторизацию только один раз и использовать полученный токен во всех последующих запросах без необходимости повторного входа в систему. 18 -))) 19 19 20 20 **Содержание страницы:** 21 21 ))) ... ... @@ -123,41 +123,29 @@ 123 123 Запрос должен содержать данные параметра "**agentId**" 124 124 125 125 (% style="color:#000000" %)Ответ: 126 - 127 -((( 128 128 { 129 - "agentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID клиента 130 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID родителя 131 - "parentName": "string", ~/~/ Наименование агента 132 - "name": "string", ~/~/ Имя клиента 133 - "fullName": "string", ~/~/ ФИО клиента 134 - "agentInfoType": 0, ~/~/ Тип клиента ((% style="color:#000000" %)0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор(%%)) 135 - "isForeign": true, ~/~/ Флаг "Иностранный контрагент" 136 - "district": "string", ~/~/ Район 137 - "region": "string", ~/~/ Область 138 - "city": "string", ~/~/ Город 139 - "email": "string", ~/~/ Email 140 - "director": "string", ~/~/ Руководитель 141 - "RegionalData": [ ~/~/ Определяет региональные сведения. 142 - { 143 - "Country": 0, ~/~/ Страна 144 - "groups": [ ~/~/ Список групп 145 - { 146 - "groupId": "string", ~/~/ Уникальный идентификатор группы 147 - "fields": [ ~/~/ Список значений полей 148 - { 149 - "name": "string", ~/~/ Имя поля формы 150 - "value": "string" ~/~/ Значение поля формы 151 - } 152 - ] 153 - } 154 - ] 155 - } 156 - ] 157 -} 158 -))) 122 + "agentId": "", (%%) 123 + "parentId": "", 124 + "parentName": "string", 125 + "name": "string", 126 + "fullName": "string", 127 + "agentInfoType": 0, 128 + "isForeign": true/false, 129 + "district": "string", 130 + "region": "string", 131 + "city": "string", 132 + "inn": "string", 133 + "kpp": "string", 134 + "address": "string", 135 + "addressFact": "string", 136 + "email": "string", 137 + "director": "string", 138 + "bankName": "string", 139 + "bankBIK": "string", 140 + "bankRS": "string", 141 + "bankKS": "string" 142 + } 159 159 160 - 161 161 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 162 162 |(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 163 163 |(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя ... ... @@ -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", ~/~/ Окончание периода ... ... @@ -2419,7 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2422 - "sampling": 86400, ~/~/ Частота дискретизации,секунд, минимум-60(если передано,то весь период бъётсяна подпериоды с указанной частотой)2494 + "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,21 +2489,12 @@ 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 - 2494 -((( 2560 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2495 2495 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2496 2496 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2497 2497 "valueFuel": 0, ~/~/ Количество 2498 2498 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2499 2499 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2500 -))) 2501 - 2502 -((( 2503 - "latitude": 0, ~/~/ Широта. 2504 - "longitude": 0 ~/~/ Долгота. 2505 -))) 2506 - 2507 2507 } 2508 2508 ] 2509 2509 } ... ... @@ -2577,241 +2577,194 @@ 2577 2577 В заголовках запроса: X-Auth: Токен авторизации 2578 2578 2579 2579 2580 -В массивеуказываемid объектов через запятую2639 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2581 2581 2582 2582 Ответ: 2583 - 2584 -[ 2585 2585 { 2586 - "vehicleId": 55728, ~/~/2587 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",Guidобъекта2588 - "vehicleNumber": " 0105 КМ",2589 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",датапоступления данных2590 - "recordTime": "202 5-06-27T12:37:19Z",датаформированиеданных2591 - "state": 4,2592 - "speed": 31,2593 - "course": 116,2594 - "latitude": 45.722128,2595 - "longitude": 39.800432,2596 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/2597 - "geozones": [ ~/~/ 2643 + "vehicleId": 0, ~/~/Идентификатор объекта. 2644 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2645 + "vehicleNumber": "string",~/~/Номер объекта. 2646 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2647 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2648 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2649 + "speed": 0,~/~/Скорость объекта. 2650 + "course": 0,~/~/Курс движения [0;360] 2651 + "latitude": 0,~/~/Широта [-90°;90°]. 2652 + "longitude": 0,~/~/Долгота [-180°;180°]. 2653 + "address": "string",~/~/Адрес. 2654 + "geozones": [ ~/~/Сведения по геозонам. 2598 2598 { 2599 - "id": 10225647, ~/~/ ID Геозоны 2600 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2601 - }, 2602 - { 2603 - "id": 10282875, ~/~/ ID Геозоны 2604 - "name": "Ё2" ~/~/ Наименование геозоны 2605 - }, 2606 - { 2607 - "id": 10226240, ~/~/ ID Геозоны 2608 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2609 - }, 2610 - { 2611 - "id": 9747869, ~/~/ ID Геозоны 2612 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2613 - }, 2614 - { 2615 - "id": 10221123, ~/~/ ID Геозоны 2616 - "name": "53r" ~/~/ Наименование геозоны 2617 - }, 2618 - { 2619 - "id": 10197638, ~/~/ ID Геозоны 2620 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2656 + "id": 0, 2657 + "name": "string" 2621 2621 } 2622 - ] 2623 - } 2624 2624 2625 2625 2626 -= = 2661 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2627 2627 2628 -= (% style="color:#000000; font-size:1 8.6667px" %)Раздел:**Уведомления**(%%) =2663 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2629 2629 2630 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2631 - 2632 2632 (% class="box infomessage" %) 2633 2633 ((( 2634 -**POST /api/v3/ notifications/find**2667 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2635 2635 ))) 2636 2636 2637 -Метод возвращаетинформациюобуведомлениях переданногоклиента иегоклиентов нижепо иерархии.2670 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2638 2638 2639 -(% style="text-align: left;" %) 2640 -Метод запроса **POST** 2672 +(% style="color:#000000" %)Метод запроса: **POST** 2641 2641 2642 -(% style="text-align: left;" %) 2643 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2674 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2644 2644 2645 -(% style="text-align: left;" %) 2646 2646 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2647 2647 2678 +(% style="text-align:left" %) 2679 +Тело запроса: 2680 + 2681 +(% style="text-align:left" %) 2648 2648 { 2649 - "parentId": "" ~/~/ id клиента2683 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2650 2650 } 2651 2651 2686 +(% style="text-align:left" %) 2652 2652 Ответ: 2653 2653 2654 2654 [ 2655 2655 { 2656 - "id": 0, ~/~/ ID уведомления 2657 - "name": "string", ~/~/ Название уведомления 2658 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 2659 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2660 - "userId": "", ~/~/ Пользователь, создавший уведомление 2661 - "parentId": "", ~/~/ Идентификатор клиента 2662 - "parentName": "string" ~/~/ Имя клиента 2691 + "id": 0, ~/~/ Идентификатор объекта геозоны 2692 + "name": "string", ~/~/ Название объекта геозоны 2693 + "type": 0, ~/~/ Тип объекта геозоны 2694 + "fname": "string", ~/~/ Имя файла 2695 + "parentId": "string", ~/~/ Идентификатор клиента 2696 + "radius": 0, ~/~/ Радиус геообъекта 2697 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2698 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2699 + "description": "string", ~/~/ Описание 2700 + "area": 0, ~/~/ Площадь, м^^2^^ 2701 + "perimetr": 0, ~/~/ Периметр, м 2702 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2663 2663 } 2664 2664 ] 2665 2665 2706 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2666 2666 2667 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2668 - 2669 2669 (% class="box infomessage" %) 2670 2670 ((( 2671 -**POST /api/v3/ notifications**2710 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2672 2672 ))) 2673 2673 2674 -Метод з апроса**POST**2713 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2675 2675 2676 -(% style="text-align: left;" %) 2677 -(% style="color:#000000" %)Пример запроса 2715 +(% style="color:#000000" %)Метод запроса: **POST** 2678 2678 2679 -((( 2717 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2718 + 2719 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2720 + 2721 +(% style="text-align:left" %) 2722 +Тело запроса: 2723 + 2680 2680 { 2681 - "id": 0, ~/~/ ID правила 2682 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2683 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2684 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2685 - "name": "string", ~/~/ Имя правила 2686 - "active": true, ~/~/ Активность правила 2687 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2688 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2689 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2690 - ], 2691 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2692 - 0 2693 - ], 2694 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2695 - 0 2696 - ], 2697 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2698 - 0 2699 - ], 2700 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2701 - "additionalProp1": "string", 2702 - "additionalProp2": "string", 2703 - "additionalProp3": "string" 2704 - }, 2705 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2706 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2707 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2708 - ], 2709 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2710 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2711 - "string" 2712 - ], 2713 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2714 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2715 - { 2716 - "id": 0, ~/~/ Идентификатор участника чата. 2717 - "info": "string" ~/~/ Дополнительные сведения. 2718 - } 2719 - ], 2720 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2721 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2722 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2723 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2724 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2725 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2726 - "timezone": 0, ~/~/ часовой пояс 2727 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2728 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2729 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2730 - { 2731 - "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 - Срок действия правила истек 2732 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2733 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2734 - "additionalProp1": "string", 2735 - "additionalProp2": "string", 2736 - "additionalProp3": "string" 2737 - } 2738 - } 2739 - ] 2725 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2726 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2727 + "ids": [ ], ~/~/ Массив id объектов 2728 + "byTime": 0, ~/~/ Объединение событий по времени 2729 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2730 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2731 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2740 2740 } 2741 -))) 2742 2742 2734 +Ответ: 2735 +[ 2736 + { 2737 + "geozoneId": 0, ~/~/ ID геообъекта 2738 + "geozoneName": "string", ~/~/ Название геообъекта 2739 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2740 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2741 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2742 + "vehicleId": 0, ~/~/ ID объекта 2743 + "vehicleName": "string" ~/~/ Имя объекта 2744 + } 2745 +] 2746 + 2747 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2748 + 2749 +(% class="box infomessage" %) 2743 2743 ((( 2744 - 2751 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2745 2745 ))) 2746 2746 2754 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2755 + 2756 +(% style="color:#000000" %)Метод запроса: **POST** 2757 + 2758 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2759 + 2760 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2761 + 2762 +(% style="text-align:left" %) 2763 +Тело запроса: 2764 + 2765 +{ 2766 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2767 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2768 + "ids": [ ], ~/~/ Массив id геообъектов 2769 + "byTime": 0, ~/~/ Объединение событий по времени 2770 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2771 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2772 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2773 +} 2774 + 2775 +Ответ: 2776 + 2777 +[ 2778 + { 2779 + "geozoneId": 0, ~/~/ ID геообъекта 2780 + "geozoneName": "string", ~/~/ Название геообъекта 2781 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2782 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2783 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2784 + "vehicleId": 0, ~/~/ ID объекта 2785 + "vehicleName": "string" ~/~/ Имя объекта 2786 + } 2787 +] 2788 + 2789 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2790 + 2791 +== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2792 + 2793 +(% class="box infomessage" %) 2747 2747 ((( 2748 - 2795 +**POST /api/v3/notifications/find** 2749 2749 ))) 2750 2750 2751 - Ответ:2798 +Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 2752 2752 2800 +(% style="text-align: left;" %) 2801 +Метод запроса **POST** 2802 + 2803 +(% style="text-align: left;" %) 2804 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2805 + 2806 +(% style="text-align: left;" %) 2807 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2808 + 2753 2753 { 2754 - "id": 0, ~/~/ ID правила 2755 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2756 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2757 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2758 - "name": "string", ~/~/ Имя правила 2759 - "active": true, ~/~/ Активность правила 2760 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2761 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2762 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2763 - ], 2764 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2765 - 0 2766 - ], 2767 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2768 - 0 2769 - ], 2770 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2771 - 0 2772 - ], 2773 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2774 - "additionalProp1": "string", 2775 - "additionalProp2": "string", 2776 - "additionalProp3": "string" 2777 - }, 2778 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2779 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2780 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2781 - ], 2782 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2783 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2784 - "string" 2785 - ], 2786 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2787 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2788 - { 2789 - "id": 0, ~/~/ Идентификатор участника чата. 2790 - "info": "string" ~/~/ Дополнительные сведения. 2791 - } 2792 - ], 2793 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2794 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2795 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2796 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2797 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2798 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2799 - "timezone": 0, ~/~/ часовой пояс 2800 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2801 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2802 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2803 - { 2804 - "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 - Срок действия правила истек 2805 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2806 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2807 - "additionalProp1": "string", 2808 - "additionalProp2": "string", 2809 - "additionalProp3": "string" 2810 - } 2811 - } 2812 - ] 2810 + "parentId": "" ~/~/ id клиента 2813 2813 } 2814 2814 2813 +Ответ: 2814 + 2815 +[ 2816 + { 2817 + "id": 0, ~/~/ ID уведомления 2818 + "name": "string", ~/~/ Название уведомления 2819 + "active": true, ~/~/ Состояние true - активен, false - деактивирован 2820 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2821 + "userId": "", ~/~/ Пользователь, создавший уведомление 2822 + "parentId": "", ~/~/ Идентификатор клиента 2823 + "parentName": "string" ~/~/ Имя клиента 2824 + } 2825 +] 2826 + 2815 2815 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2816 2816 2817 2817 (% class="box infomessage" %) ... ... @@ -4029,12 +4029,16 @@ 4029 4029 Тело запроса: 4030 4030 4031 4031 { 4032 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4033 - "Balance": 0 ~/~/ Значение баланса.4044 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4045 + "Balance": 0 4034 4034 } 4035 4035 4036 4036 Ответ: Success 4037 4037 4050 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4051 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4052 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4053 + 4038 4038 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4039 4039 4040 4040 (% class="box warningmessage" %) ... ... @@ -4046,29 +4046,16 @@ 4046 4046 4047 4047 Тело запроса: 4048 4048 4049 -((( 4050 4050 { 4051 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4052 - "a mount": 0~/~/ Сумма пополнения баланса4066 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4067 + "Balance": 0 4053 4053 } 4054 -))) 4055 4055 4056 -((( 4057 - 4058 -))) 4059 - 4060 4060 Ответ: Success 4061 4061 4062 -((( 4063 -{ 4064 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4065 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4066 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4067 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4068 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4069 - "Description": "string" ~/~/ Описание корректировки. 4070 -} 4071 -))) 4072 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4073 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4074 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4072 4072 4073 4073 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4074 4074 ... ... @@ -4081,25 +4081,16 @@ 4081 4081 4082 4082 Тело запроса: 4083 4083 4084 -((( 4085 4085 { 4086 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4087 - "a mount": 0~/~/ Сумма списания с баланса4088 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4089 + "Balance": 0 4088 4088 } 4089 -))) 4090 4090 4091 4091 Ответ: Success 4092 4092 4093 -((( 4094 -{ 4095 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4096 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4097 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4098 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4099 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4100 - "Description": "string" ~/~/ Описание корректировки 4101 -} 4102 -))) 4094 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4095 +|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4096 +|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4103 4103 4104 4104 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4105 4105 ... ... @@ -4110,35 +4110,28 @@ 4110 4110 4111 4111 Тело запроса: 4112 4112 4113 -((( 4114 4114 { 4115 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4116 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4117 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4118 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4119 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4120 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4108 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4109 + "CalculationType": 0, 4110 + "PermissibleBalance": 0, 4111 + "DefermentDays": 0, 4112 + "SendUiNotifications": true, 4113 + "SendEmailNotifications": true, 4114 + "IsPrivate": true, 4121 4121 } 4122 -))) 4123 4123 4124 -((( 4125 - 4126 -))) 4127 - 4128 4128 Ответ: Success 4129 4129 4130 -((( 4131 -{ 4132 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4133 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4134 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4135 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4136 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4137 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4138 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4139 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4140 -} 4119 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4120 +|ClientId|Идентификатор клиента 4121 +|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4122 +|PermissibleBalance|Допустимый баланс 4123 +|DefermentDays|((( 4124 +Отсрочка, количество дней 4141 4141 ))) 4126 +|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4127 +|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4128 +|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4142 4142 4143 4143 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4144 4144 ... ... @@ -4150,68 +4150,35 @@ 4150 4150 Тело запроса: 4151 4151 4152 4152 { 4153 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4154 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4155 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4140 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4141 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4142 + "Features": [ 4156 4156 { 4157 - "Feature": "string", ~/~/ Код услуги.4158 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4159 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4160 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4161 - "Price": 0, ~/~/ Цена за единицу.4162 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4163 - "PeriodValue": 0, ~/~/ Значение периода.4164 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)4144 + "Feature": "string", 4145 + "IsEnabled": true, 4146 + "IsFactual": true, 4147 + "Limit": 0, 4148 + "Price": 0, 4149 + "DebitDate": "2023-10-18T13:26:58.987Z", 4150 + "PeriodValue": 0, 4151 + "PeriodType": 0 4165 4165 } 4166 4166 ] 4167 4167 } 4168 4168 4169 - 4170 4170 Ответ: Success 4171 4171 4172 -((( 4173 -{ 4174 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4175 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4176 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4177 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4178 - "Name": "string", ~/~/ Наименование. 4179 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4180 - "Constraint": { ~/~/ Ограничения по тарифу 4181 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4182 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4183 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4184 - }, 4185 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4186 - { 4187 - "Feature": "string", ~/~/Код услуги. 4188 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4189 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4190 - "Price": 0, ~/~/ Цена за единицу. 4191 - "PeriodValue": 0, ~/~/ Значение периода. 4192 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4193 - } 4194 - ], 4195 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4196 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4197 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4198 - }, 4199 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4200 - { 4201 - "Feature": "string", ~/~/ Код услуги. 4202 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4203 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4204 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4205 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4206 - "Price": 0, ~/~/ Цена за единицу. 4207 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4208 - "PeriodValue": 0, ~/~/ Значение периода. 4209 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4210 - "Quantity": 0 ~/~/ Количество использования услуги. 4211 - } 4212 - ] 4213 -} 4214 -))) 4158 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4159 +|ClientId|Идентификатор клиента 4160 +|PlanId|Идентификатор тарифного плана 4161 +|Feature|Код услуги 4162 +|IsEnabled|Признак, определяющий активирована ли услуга 4163 +|IsFactual|Признак, определяющий расчёт по факту 4164 +|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4165 +|Price|Цена за единицу. 4166 +|DebitDate|Следующий момент времени списания с баланса за услугу. 4167 +|PeriodValue|Значение периода. 4168 +|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4215 4215 4216 4216 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4217 4217 ... ... @@ -4316,43 +4316,6 @@ 4316 4316 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4317 4317 |msgCount|Кол-во обработанных сообщений всего 4318 4318 4319 -== **Импортировать историю ТС (Асинхронный запрос)** == 4320 - 4321 -(% class="box successmessage" %) 4322 -((( 4323 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4324 -))) 4325 - 4326 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4327 - 4328 -Метод запроса: **POST** 4329 - 4330 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4331 - 4332 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4333 - 4334 - 4335 -Ответ: 4336 - 4337 -{ 4338 - 4339 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4340 - 4341 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4342 - 4343 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4344 - 4345 - "Message": "string", ~/~/ Информация о выполнении запроса 4346 - 4347 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4348 - 4349 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4350 - 4351 - "Data": "string" ~/~/ Данные 4352 - 4353 -} 4354 - 4355 - 4356 4356 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4357 4357 4358 4358 (% class="box infomessage" %) ... ... @@ -4370,59 +4370,10 @@ 4370 4370 "message": "string" 4371 4371 } 4372 4372 4373 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4374 -**Параметр** 4375 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4376 -**Описание** 4377 -))) 4378 -|((( 4379 -activity 4380 -)))|((( 4381 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4382 -))) 4383 -|((( 4384 -progress 4385 -)))|((( 4386 -Guid ТС 4387 -))) 4290 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4291 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4292 +|progress|Guid ТС 4388 4388 4389 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4390 - 4391 -(% class="box infomessage" %) 4392 -((( 4393 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4394 -))) 4395 - 4396 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4397 - 4398 -Метод запроса: **GET** 4399 - 4400 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4401 - 4402 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4403 - 4404 - 4405 -Ответ: 4406 - 4407 -{ 4408 - 4409 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4410 - 4411 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4412 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4413 - 4414 - "Message": "string", ~/~/ Информация о выполнении запроса 4415 - 4416 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4417 - 4418 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4419 - 4420 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4421 - 4422 - "Data": "string" ~/~/ Данные 4423 - 4424 -} 4425 - 4426 4426 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4427 4427 4428 4428 (% class="box infomessage" %) ... ... @@ -4934,51 +4934,8 @@ 4934 4934 } 4935 4935 ] 4936 4936 } 4937 - 4938 - 4939 -== **Превышение скорости** == 4940 - 4941 -(% class="box infomessage" %) 4942 -((( 4943 -**POST /api/v3/Reports/overSpeedDuration** 4944 4944 ))) 4945 4945 4946 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 4947 - 4948 -Пример запроса: 4949 - 4950 -((( 4951 -{ 4952 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 4953 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 4954 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 4955 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4956 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 4957 -} 4958 -))) 4959 - 4960 -((( 4961 - 4962 -))) 4963 - 4964 -((( 4965 -Пример ответа: 4966 -))) 4967 - 4968 -((( 4969 -((( 4970 -[ 4971 - { 4972 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 4973 - "duration": 0, ~/~/ Продолжительность события в секундах 4974 - "maxSpeed": 0, ~/~/ Максимальная скорость 4975 - "speedLimit": 0 ~/~/ Ограничение скорости 4976 - } 4977 -] 4978 -))) 4979 -))) 4980 -))) 4981 - 4982 4982 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4983 4983 4984 4984 ... ... @@ -5284,9 +5284,33 @@ 5284 5284 ))) 5285 5285 5286 5286 5112 +== **Удаление существующего поля** == 5113 + 5114 +(% class="box errormessage" %) 5287 5287 ((( 5116 +**DELETE /api/v3/agroLands/{id}** 5117 +))) 5118 + 5119 +Пример запроса: 5120 +id ~/~/ Идентификатор поля 5121 + 5122 +Пример ответа: 5123 + 5288 5288 ((( 5125 +200 ~/~/ Успех 5126 +))) 5127 + 5289 5289 ((( 5129 + 5130 +))) 5131 + 5132 +((( 5133 +((( 5134 +((( 5135 + 5136 +))) 5137 + 5138 +((( 5290 5290 == **Изменение поля** == 5291 5291 5292 5292 (% class="box infomessage" %) ... ... @@ -5532,102 +5532,9 @@ 5532 5532 "perimetr": 0, ~/~/ ериметр, м 5533 5533 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5534 5534 } 5535 - 5536 - 5537 -== **Какие поля посещал объект** == 5538 - 5539 -(% class="box successmessage" %) 5540 -((( 5541 -**POST /api/v3/agroLands/visitingByVehicle** 5542 5542 ))) 5543 5543 5544 -Пример запроса: 5545 5545 5546 -{ 5547 - "vehicleId": 0, ~/~/ id объекта 5548 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5549 - "byTime": 0, ~/~/ Объединение событий по времени 5550 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5551 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5552 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5553 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5554 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5555 -} 5556 - 5557 -Пример ответа: 5558 - 5559 -[ 5560 - { 5561 - "fieldId": 0, ~/~/ id объекта 5562 - "vehicleName": "string", ~/~/ Наименование объекта 5563 - "fieldName": "string", ~/~/ Наименование поля 5564 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5565 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5566 - "vehicleId": 0, ~/~/ Идентификатор ТС 5567 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5568 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5569 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5570 - "mileage": 0 ~/~/ Пробег 5571 - } 5572 -] 5573 -))) 5574 - 5575 - 5576 -== **Посещение поля объектами ** == 5577 - 5578 -(% class="box successmessage" %) 5579 -((( 5580 -**POST /api/v3/agroLands/visitingByField** 5581 -))) 5582 - 5583 -Пример запроса: 5584 -{ 5585 - "fieldId": 0, ~/~/ ID поля 5586 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5587 - "byTime": 0, ~/~/ Объединение событий по времени 5588 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5589 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5590 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5591 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5592 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5593 -} 5594 - 5595 -Пример ответа: 5596 - 5597 -[ 5598 - { 5599 - "fieldId": 0, ~/~/ ID поля 5600 - "vehicleName": "string", ~/~/ Наименование объекта 5601 - "fieldName": "string", ~/~/ Имя поля 5602 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5603 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5604 - "vehicleId": 0, ~/~/ Идентификатор ТС 5605 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5606 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5607 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5608 - "mileage": 0 ~/~/ Пробег 5609 - } 5610 -] 5611 - 5612 - 5613 -== **Удаление существующего поля** == 5614 - 5615 -(% class="box errormessage" %) 5616 -((( 5617 -**DELETE /api/v3/agroLands/{id}** 5618 -))) 5619 - 5620 -Пример запроса: 5621 -id ~/~/ Идентификатор поля 5622 - 5623 -Пример ответа: 5624 - 5625 -((( 5626 -200 ~/~/ Успех 5627 - 5628 - 5629 -))) 5630 - 5631 5631 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5632 5632 ))) 5633 5633 ))) ... ... @@ -6052,129 +6052,49 @@ 6052 6052 ))) 6053 6053 6054 6054 6055 -= **Раздел: Роли** = 6056 - 6057 -== **Получение списка клиентских и системных ролей пользователя ** == 6058 - 6059 -(% class="box successmessage" %) 6060 -((( 6061 -**POST /api/v3/groups/find** 6062 -))) 6063 - 6064 -Пример запроса: 6065 - 6066 -((( 6067 -{ 6068 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6069 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6070 -} 6071 -))) 6072 - 6073 -((( 6074 - 6075 -))) 6076 - 6077 -((( 6078 -Пример ответа: 6079 -))) 6080 - 6081 -((( 6082 -((( 6083 -{ 6084 - "groups": [ ~/~/ Системные роли пользователя 6085 - { 6086 - "code": "string", ~/~/ Код роли. 6087 - "name": "string", ~/~/ Имя 6088 - "shortName": "string" ~/~/ Короткое имя 6089 - } 6090 - ], 6091 - "customGroups": [ ~/~/ Системные роли пользователя 6092 - { 6093 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6094 - "name": "string", ~/~/ Наименование 6095 - "shortName": "string", ~/~/ Короткое наименование 6096 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6097 - } 6098 - ] 6099 -} 6100 -))) 6101 -))) 6102 - 6103 -((( 6104 - 6105 -))) 6106 - 6107 -((( 6108 - 6109 -))) 6110 - 6111 6111 = **Раздел: Локатор ** = 6112 6112 6113 6113 6114 -== **Получение данных покатору** ==5814 +== **Получение списка локаторов, доступных пользователю ** == 6115 6115 6116 6116 (% class="box infomessage" %) 6117 6117 ((( 6118 -**GET /api/v3/locators /{locatorId}**5818 +**GET /api/v3/locators** 6119 6119 ))) 6120 6120 6121 -В за просе указываетсяlocatorid- идентификаторлокатора5821 +В заголовках запроса: X-Auth: Токен авторизации 6122 6122 6123 6123 6124 6124 Пример ответа: 6125 6125 6126 6126 ((( 6127 -((( 6128 -{ 6129 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6130 - 0 6131 - ], 6132 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6133 - 0 6134 - ], 6135 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6136 - 0 6137 - ], 6138 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6139 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6140 - "agentName": "string", ~/~/ Наименование агента. 6141 - "isEnabled": true, ~/~/ Активность 6142 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6143 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6144 - "name": "string", ~/~/ Наименование. 6145 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6146 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6147 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6148 - "validity": 0, ~/~/ Значение срока действия 6149 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6150 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6151 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6152 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6153 - "url": "string", ~/~/ Ссылка 6154 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6155 - 6156 - "showVehicleName": true, ~/~/ Наименование объекта 6157 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6158 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6159 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6160 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6161 - "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ГИС) 6162 - 6163 - 1 6164 - 6165 - ] 6166 -} 5827 +[ 5828 + { 5829 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5830 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5831 + "agentName": "string", ~/~/ Наименование агента. 5832 + "isEnabled": true, ~/~/ Активен 5833 + "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5834 + "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5835 + "name": "string", ~/~/ Наименование 5836 + "status": 0, ~/~/ 5837 + "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5838 + "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5839 + "validity": 0, ~/~/ Срок действия в днях (1-90). 5840 + "autoProlongation": true, ~/~/ Автопродление срока действия. 5841 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5842 + "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5843 + "url": "string", ~/~/ Ссылка 5844 + "language": 0, ~/~/ Язык. 5845 + "vehiclesCount": 0, ~/~/ Количество объектов. 5846 + "geozonesCount": 0, ~/~/ Количество геозон. 5847 + "fieldsCount": 0 ~/~/ Количество полей. 5848 + } 5849 +] 6167 6167 ))) 6168 -))) 6169 6169 6170 6170 6171 -((( 6172 -((( 6173 - 6174 -))) 6175 -))) 6176 6176 6177 - 6178 6178 == **Создание локатора** == 6179 6179 6180 6180 (% class="box successmessage" %) ... ... @@ -6186,6 +6186,7 @@ 6186 6186 6187 6187 ((( 6188 6188 { 5865 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6189 6189 "isEnabled": true, ~/~/ Активность 6190 6190 "name": "string", ~/~/ Наименование локатора 6191 6191 "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) ... ... @@ -6192,28 +6192,8 @@ 6192 6192 "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6193 6193 "validity": 0, ~/~/ Срок действия в днях (1-90) 6194 6194 "autoProlongation": true, ~/~/ Автопродление срока действия. 6195 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6196 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6197 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6198 - 0 6199 - ], 6200 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6201 - 0 6202 - ], 6203 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6204 - 0 6205 - ], 6206 - 6207 - "showVehicleName": true, ~/~/ Наименование объекта 6208 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6209 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6210 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6211 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6212 - "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ГИС) 6213 - 6214 - 1 6215 - 6216 - ] 5872 + "url": "string", ~/~/ Ссылка 5873 + "language": 0 ~/~/ Язык 6217 6217 } 6218 6218 ))) 6219 6219 ... ... @@ -6225,69 +6225,7 @@ 6225 6225 ))) 6226 6226 6227 6227 6228 -== **Выводит список локаторов ** == 6229 6229 6230 -(% class="box successmessage" %) 6231 -((( 6232 -**POST /api/v3/locators/find** 6233 -))) 6234 - 6235 -Пример запроса: 6236 - 6237 -((( 6238 -{ 6239 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6240 -} 6241 -))) 6242 - 6243 -((( 6244 - 6245 -))) 6246 - 6247 -((( 6248 - 6249 -))) 6250 - 6251 - 6252 -Пример ответа: 6253 - 6254 -((( 6255 -[ 6256 - { 6257 - "vehiclesCount": 0, ~/~/ Количество объектов. 6258 - "geozonesCount": 0, ~/~/ Количество геозон. 6259 - "fieldsCount": 0, ~/~/ Количество полей. 6260 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6261 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6262 - "agentName": "string", ~/~/ Наименование агента. 6263 - "isEnabled": true, ~/~/ Активность локатора 6264 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6265 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6266 - "name": "string", ~/~/ Наименование локатора 6267 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6268 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6269 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6270 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6271 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6272 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6273 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6274 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6275 - "url": "string", ~/~/ ссылка на локатор 6276 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6277 - "showVehicleName": true, ~/~/ Наименование объекта 6278 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6279 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6280 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6281 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6282 - "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ГИС) 6283 - 6284 - 0 6285 - ] 6286 - } 6287 -] 6288 -))) 6289 - 6290 - 6291 6291 == **Изменение локатора** == 6292 6292 6293 6293 (% class="box infomessage" %) ... ... @@ -6306,31 +6306,12 @@ 6306 6306 "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6307 6307 "validity": 0, ~/~/ Срок действия в днях (1-90) 6308 6308 "autoProlongation": true, ~/~/ Автопродление срока действия 6309 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6310 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6311 - 0 6312 - ], 6313 - "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6314 - 0 6315 - ], 6316 - "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6317 - 0 6318 - ], 6319 - "showVehicleName": true, ~/~/ Наименование объекта 6320 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6321 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6322 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6323 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6324 - "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ГИС) 6325 - 6326 - 0 6327 - 6328 - ] 5904 + "url": "string", ~/~/ Ссылка 5905 + "language": 0 ~/~/ Язык 6329 6329 } 6330 - 6331 - 6332 6332 ))) 6333 6333 5909 + 6334 6334 Пример ответа: 6335 6335 6336 6336 200 ~/~/ Success ... ... @@ -6352,201 +6352,8 @@ 6352 6352 ))) 6353 6353 6354 6354 6355 -= **Раздел: Яндекс Маршруты** = 6356 6356 6357 6357 6358 -== **Возвращение списка маршрутов** == 6359 - 6360 -(% class="box infomessage" %) 6361 -((( 6362 -**GET /api/v3/TransportRoutes** 6363 -))) 6364 - 6365 -Пример запроса: 6366 -Id ~/~/ Идентификатор поля 6367 - 6368 -Пример ответа: 6369 - 6370 -((( 6371 -[ 6372 - { 6373 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6374 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6375 - "name": "string", ~/~/ Наименование маршрута. 6376 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6377 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6378 - 0 6379 - ] 6380 - } 6381 -] 6382 -))) 6383 - 6384 - 6385 -== **Добавить маршрут** == 6386 - 6387 -(% class="box infomessage" %) 6388 -((( 6389 -**POST /api/v3/TransportRoutes** 6390 -))) 6391 - 6392 -Пример запроса: 6393 -{ 6394 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6395 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6396 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6397 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6398 - 0 6399 - ] 6400 -} 6401 - 6402 - 6403 -Пример ответа: 6404 - 6405 -((( 6406 -{ 6407 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6408 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6409 - "name": "string", ~/~/ Определяет наименование маршрута 6410 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6411 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6412 - 0 6413 - ] 6414 -} 6415 -))) 6416 - 6417 - 6418 -== **Обновление маршрута** == 6419 - 6420 -(% class="box successmessage" %) 6421 -((( 6422 -**PUT /api/v3/TransportRoutes** 6423 -))) 6424 - 6425 -Пример запроса: 6426 - 6427 -((( 6428 -{ 6429 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6430 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6431 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6432 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6433 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6434 - 0 6435 - ] 6436 -} 6437 -))) 6438 - 6439 -Пример ответа: 6440 - 6441 -((( 6442 -{ 6443 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6444 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6445 - "name": "string", ~/~/ Определяет наименование маршрута 6446 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6447 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6448 - 0 6449 - ] 6450 -} 6451 -))) 6452 - 6453 - 6454 -== **Получить связки маршрутов ТС** == 6455 - 6456 -(% class="box infomessage" %) 6457 -((( 6458 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6459 -))) 6460 - 6461 -Пример запроса: 6462 - 6463 -((( 6464 -[ 6465 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6466 -] 6467 -))) 6468 - 6469 -Пример ответа: 6470 - 6471 -((( 6472 -[ 6473 - { 6474 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6475 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6476 - } 6477 -] 6478 -))) 6479 - 6480 - 6481 -== **Удалить маршрут** == 6482 - 6483 -(% class="box warningmessage" %) 6484 -((( 6485 -**DELETE /api/v3/TransportRoutes/{id}** 6486 -))) 6487 - 6488 -Пример запроса: 6489 -Id ~/~/ Идентификатор поля 6490 - 6491 - 6492 -= **Раздел: Управление доступа к машинам** = 6493 - 6494 - 6495 -== Получение списка транспортных средств видимых пользователю == 6496 - 6497 -(% class="box infomessage" %) 6498 -((( 6499 -**GET /api/v3/UserVisibleVehicles/{userId}** 6500 -))) 6501 - 6502 -Пример ответа: 6503 - 6504 -((( 6505 -{ 6506 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6507 - 0 6508 - ] 6509 -} 6510 -))) 6511 - 6512 - 6513 -== Задает видимость транспортных средств пользователю == 6514 - 6515 -(% class="box infomessage" %) 6516 -((( 6517 -**POST /api/v3/UserVisibleVehicles** 6518 -))) 6519 - 6520 -Пример запроса: 6521 - 6522 -((( 6523 -((( 6524 -{ 6525 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6526 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6527 - 0 6528 - ] 6529 -} 6530 -))) 6531 - 6532 -((( 6533 - 6534 -))) 6535 - 6536 -((( 6537 -Пример ответа : 6538 -))) 6539 - 6540 -((( 6541 - 6542 -))) 6543 - 6544 -((( 6545 -200 ~/~/ Success 6546 -))) 6547 -))) 6548 - 6549 - 6550 6550 (% class="box" lang="en-US" style="text-align: center;" %) 6551 6551 ((( 6552 6552 (% 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]] **