Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/06/27 16:12
<
>
edited by Андрей Калиновский
on 2025/06/10 15:42
on 2025/06/10 15:42
edited by Андрей Калиновский
on 2025/02/25 16:35
on 2025/02/25 16:35
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" %)Идентификатор клиента-родителя ... ... @@ -877,7 +877,7 @@ 877 877 { 878 878 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 879 879 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 880 - "deleted": false,863 + "deleted": true, 881 881 "extId": "string", 882 882 "name": "string", 883 883 "picture": "string", ... ... @@ -896,7 +896,7 @@ 896 896 { 897 897 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 898 898 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 899 - "deleted": false,882 + "deleted": true, 900 900 "extId": "string", 901 901 "name": "string", 902 902 "picture": "string", ... ... @@ -930,7 +930,7 @@ 930 930 (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models** 931 931 ))) 932 932 933 -(% style="color:#000000" %)Метод позволяет изменить статус модели, указанного в запросе.916 +(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе. 934 934 935 935 (% style="color:#000000" %)Метод запроса: **PUT** 936 936 ... ... @@ -997,7 +997,7 @@ 997 997 (% lang="en-US" %)**DELETE /api/v3/models/{Id}** 998 998 ))) 999 999 1000 -(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалитьмодель, указанного в строке запроса.983 +(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса. 1001 1001 1002 1002 (% style="color:#000000" %)Метод запроса: **DELETE** 1003 1003 ... ... @@ -1628,6 +1628,77 @@ 1628 1628 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1629 1629 1630 1630 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 + 1631 1631 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1632 1632 1633 1633 (% class="box infomessage" %) ... ... @@ -1773,6 +1773,7 @@ 1773 1773 "stage": "", ~/~/ Состояние 1774 1774 (% style="color:#000000" %) } 1775 1775 1830 +== == 1776 1776 1777 1777 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1778 1778 ... ... @@ -2455,12 +2455,8 @@ 2455 2455 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2456 2456 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2457 2457 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2458 - "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2459 - "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2460 2460 "fuelConsumption": 0, ~/~/ Расход топлива 2461 2461 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2462 - "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне 2463 - 2464 2464 } 2465 2465 ] 2466 2466 } ... ... @@ -2506,8 +2506,7 @@ 2506 2506 "model": "string", ~/~/ Модель объекта 2507 2507 "fuels": [ ~/~/ Массив данным по заправкам и сливам 2508 2508 { 2509 - "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 2510 - 2560 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 2511 2511 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2512 2512 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2513 2513 "valueFuel": 0, ~/~/ Количество ... ... @@ -2736,35 +2736,6 @@ 2736 2736 } 2737 2737 ] 2738 2738 2739 - 2740 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2741 - 2742 -(% class="box successmessage" %) 2743 -((( 2744 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2745 -))) 2746 - 2747 -(% style="color:#000000" %)Метод запроса: **PUT** 2748 - 2749 -Пример запроса: 2750 - 2751 -((( 2752 -{ 2753 - "id": 0, ~/~/ Идентификатор объекта геозоны 2754 - "name": "string", ~/~/ Наименование объекта геозоны 2755 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2756 - "description": "string", ~/~/ Описание объекта геозоны 2757 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2758 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2759 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2760 -} 2761 -))) 2762 - 2763 - 2764 -Пример ответа: 2765 - 2766 -200 ~/~/ Success 2767 - 2768 2768 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2769 2769 2770 2770 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -2796,7 +2796,7 @@ 2796 2796 "id": 0, ~/~/ ID уведомления 2797 2797 "name": "string", ~/~/ Название уведомления 2798 2798 "active": true, ~/~/ Состояние true - активен, false - деактивирован 2799 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО , 13 - Назначение водителя)2820 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2800 2800 "userId": "", ~/~/ Пользователь, создавший уведомление 2801 2801 "parentId": "", ~/~/ Идентификатор клиента 2802 2802 "parentName": "string" ~/~/ Имя клиента ... ... @@ -2803,155 +2803,6 @@ 2803 2803 } 2804 2804 ] 2805 2805 2806 - 2807 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2808 - 2809 -(% class="box infomessage" %) 2810 -((( 2811 -**POST /api/v3/notifications** 2812 -))) 2813 - 2814 -Метод запроса **POST** 2815 - 2816 -(% style="text-align: left;" %) 2817 -(% style="color:#000000" %)Пример запроса 2818 - 2819 -((( 2820 -{ 2821 - "id": 0, ~/~/ ID правила 2822 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2823 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2824 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2825 - "name": "string", ~/~/ Имя правила 2826 - "active": true, ~/~/ Активность правила 2827 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2828 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2829 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2830 - ], 2831 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2832 - 0 2833 - ], 2834 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2835 - 0 2836 - ], 2837 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2838 - 0 2839 - ], 2840 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2841 - "additionalProp1": "string", 2842 - "additionalProp2": "string", 2843 - "additionalProp3": "string" 2844 - }, 2845 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2846 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2847 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2848 - ], 2849 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2850 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2851 - "string" 2852 - ], 2853 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2854 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2855 - { 2856 - "id": 0, ~/~/ Идентификатор участника чата. 2857 - "info": "string" ~/~/ Дополнительные сведения. 2858 - } 2859 - ], 2860 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2861 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2862 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2863 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2864 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2865 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2866 - "timezone": 0, ~/~/ часовой пояс 2867 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2868 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2869 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2870 - { 2871 - "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 - Срок действия правила истек 2872 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2873 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2874 - "additionalProp1": "string", 2875 - "additionalProp2": "string", 2876 - "additionalProp3": "string" 2877 - } 2878 - } 2879 - ] 2880 -} 2881 -))) 2882 - 2883 -((( 2884 - 2885 -))) 2886 - 2887 -((( 2888 - 2889 -))) 2890 - 2891 -Ответ: 2892 - 2893 -{ 2894 - "id": 0, ~/~/ ID правила 2895 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2896 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2897 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2898 - "name": "string", ~/~/ Имя правила 2899 - "active": true, ~/~/ Активность правила 2900 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2901 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2902 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2903 - ], 2904 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2905 - 0 2906 - ], 2907 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2908 - 0 2909 - ], 2910 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2911 - 0 2912 - ], 2913 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2914 - "additionalProp1": "string", 2915 - "additionalProp2": "string", 2916 - "additionalProp3": "string" 2917 - }, 2918 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2919 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2920 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2921 - ], 2922 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2923 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2924 - "string" 2925 - ], 2926 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2927 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2928 - { 2929 - "id": 0, ~/~/ Идентификатор участника чата. 2930 - "info": "string" ~/~/ Дополнительные сведения. 2931 - } 2932 - ], 2933 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2934 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2935 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2936 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2937 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2938 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2939 - "timezone": 0, ~/~/ часовой пояс 2940 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2941 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2942 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2943 - { 2944 - "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 - Срок действия правила истек 2945 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2946 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2947 - "additionalProp1": "string", 2948 - "additionalProp2": "string", 2949 - "additionalProp3": "string" 2950 - } 2951 - } 2952 - ] 2953 -} 2954 - 2955 2955 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2956 2956 2957 2957 (% class="box infomessage" %) ... ... @@ -4169,12 +4169,16 @@ 4169 4169 Тело запроса: 4170 4170 4171 4171 { 4172 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4173 - "Balance": 0 ~/~/ Значение баланса.4044 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4045 + "Balance": 0 4174 4174 } 4175 4175 4176 4176 Ответ: Success 4177 4177 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 + 4178 4178 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4179 4179 4180 4180 (% class="box warningmessage" %) ... ... @@ -4186,29 +4186,16 @@ 4186 4186 4187 4187 Тело запроса: 4188 4188 4189 -((( 4190 4190 { 4191 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4192 - "a mount": 0~/~/ Сумма пополнения баланса4066 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4067 + "Balance": 0 4193 4193 } 4194 -))) 4195 4195 4196 -((( 4197 - 4198 -))) 4199 - 4200 4200 Ответ: Success 4201 4201 4202 -((( 4203 -{ 4204 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4205 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4206 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4207 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4208 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4209 - "Description": "string" ~/~/ Описание корректировки. 4210 -} 4211 -))) 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" %)Значение баланса 4212 4212 4213 4213 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4214 4214 ... ... @@ -4221,25 +4221,16 @@ 4221 4221 4222 4222 Тело запроса: 4223 4223 4224 -((( 4225 4225 { 4226 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4227 - "a mount": 0~/~/ Сумма списания с баланса4088 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4089 + "Balance": 0 4228 4228 } 4229 -))) 4230 4230 4231 4231 Ответ: Success 4232 4232 4233 -((( 4234 -{ 4235 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4236 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4237 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4238 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4239 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4240 - "Description": "string" ~/~/ Описание корректировки 4241 -} 4242 -))) 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" %)Значение баланса 4243 4243 4244 4244 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4245 4245 ... ... @@ -4250,35 +4250,28 @@ 4250 4250 4251 4251 Тело запроса: 4252 4252 4253 -((( 4254 4254 { 4255 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4256 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4257 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4258 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4259 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4260 - "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, 4261 4261 } 4262 -))) 4263 4263 4264 -((( 4265 - 4266 -))) 4267 - 4268 4268 Ответ: Success 4269 4269 4270 -((( 4271 -{ 4272 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4273 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4274 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4275 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4276 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4277 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4278 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4279 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4280 -} 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 +Отсрочка, количество дней 4281 4281 ))) 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" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4282 4282 4283 4283 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4284 4284 ... ... @@ -4290,68 +4290,35 @@ 4290 4290 Тело запроса: 4291 4291 4292 4292 { 4293 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4294 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4295 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4140 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4141 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4142 + "Features": [ 4296 4296 { 4297 - "Feature": "string", ~/~/ Код услуги.4298 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4299 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4300 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4301 - "Price": 0, ~/~/ Цена за единицу.4302 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4303 - "PeriodValue": 0, ~/~/ Значение периода.4304 - "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 4305 4305 } 4306 4306 ] 4307 4307 } 4308 4308 4309 - 4310 4310 Ответ: Success 4311 4311 4312 -((( 4313 -{ 4314 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4315 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4316 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4317 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4318 - "Name": "string", ~/~/ Наименование. 4319 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4320 - "Constraint": { ~/~/ Ограничения по тарифу 4321 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4322 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4323 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4324 - }, 4325 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4326 - { 4327 - "Feature": "string", ~/~/Код услуги. 4328 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4329 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4330 - "Price": 0, ~/~/ Цена за единицу. 4331 - "PeriodValue": 0, ~/~/ Значение периода. 4332 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4333 - } 4334 - ], 4335 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4336 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4337 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4338 - }, 4339 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4340 - { 4341 - "Feature": "string", ~/~/ Код услуги. 4342 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4343 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4344 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4345 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4346 - "Price": 0, ~/~/ Цена за единицу. 4347 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4348 - "PeriodValue": 0, ~/~/ Значение периода. 4349 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4350 - "Quantity": 0 ~/~/ Количество использования услуги. 4351 - } 4352 - ] 4353 -} 4354 -))) 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 - Месяцы 4355 4355 4356 4356 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4357 4357 ... ... @@ -4456,43 +4456,6 @@ 4456 4456 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4457 4457 |msgCount|Кол-во обработанных сообщений всего 4458 4458 4459 -== **Импортировать историю ТС (Асинхронный запрос)** == 4460 - 4461 -(% class="box successmessage" %) 4462 -((( 4463 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4464 -))) 4465 - 4466 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4467 - 4468 -Метод запроса: **POST** 4469 - 4470 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4471 - 4472 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4473 - 4474 - 4475 -Ответ: 4476 - 4477 -{ 4478 - 4479 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4480 - 4481 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4482 - 4483 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4484 - 4485 - "Message": "string", ~/~/ Информация о выполнении запроса 4486 - 4487 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4488 - 4489 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4490 - 4491 - "Data": "string" ~/~/ Данные 4492 - 4493 -} 4494 - 4495 - 4496 4496 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4497 4497 4498 4498 (% class="box infomessage" %) ... ... @@ -4510,59 +4510,10 @@ 4510 4510 "message": "string" 4511 4511 } 4512 4512 4513 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4514 -**Параметр** 4515 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4516 -**Описание** 4517 -))) 4518 -|((( 4519 -activity 4520 -)))|((( 4521 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4522 -))) 4523 -|((( 4524 -progress 4525 -)))|((( 4526 -Guid ТС 4527 -))) 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 ТС 4528 4528 4529 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4530 - 4531 -(% class="box infomessage" %) 4532 -((( 4533 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4534 -))) 4535 - 4536 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4537 - 4538 -Метод запроса: **GET** 4539 - 4540 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4541 - 4542 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4543 - 4544 - 4545 -Ответ: 4546 - 4547 -{ 4548 - 4549 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4550 - 4551 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4552 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4553 - 4554 - "Message": "string", ~/~/ Информация о выполнении запроса 4555 - 4556 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4557 - 4558 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4559 - 4560 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4561 - 4562 - "Data": "string" ~/~/ Данные 4563 - 4564 -} 4565 - 4566 4566 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4567 4567 4568 4568 (% class="box infomessage" %) ... ... @@ -5074,51 +5074,8 @@ 5074 5074 } 5075 5075 ] 5076 5076 } 5077 - 5078 - 5079 -== **Превышение скорости** == 5080 - 5081 -(% class="box infomessage" %) 5082 -((( 5083 -**POST /api/v3/Reports/overSpeedDuration** 5084 5084 ))) 5085 5085 5086 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 5087 - 5088 -Пример запроса: 5089 - 5090 -((( 5091 -{ 5092 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 5093 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 5094 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 5095 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5096 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 5097 -} 5098 -))) 5099 - 5100 -((( 5101 - 5102 -))) 5103 - 5104 -((( 5105 -Пример ответа: 5106 -))) 5107 - 5108 -((( 5109 -((( 5110 -[ 5111 - { 5112 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 5113 - "duration": 0, ~/~/ Продолжительность события в секундах 5114 - "maxSpeed": 0, ~/~/ Максимальная скорость 5115 - "speedLimit": 0 ~/~/ Ограничение скорости 5116 - } 5117 -] 5118 -))) 5119 -))) 5120 -))) 5121 - 5122 5122 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 5123 5123 5124 5124 ... ... @@ -5193,16 +5193,13 @@ 5193 5193 **POST /api/v3/agroLands** 5194 5194 ))) 5195 5195 5196 -Если необходимо указывать конкретного клиента, в котором нужно создать поле, то в заголовке надо прописать 5197 -X-agent - ID клиента 5198 - 5199 5199 Пример запроса: 5200 5200 5201 5201 ((( 5202 5202 { 5203 5203 "extId": "string", 5204 - "shape": " {\"type\":\"Polygon\",\"coordinates\":~[~[[50.299112,54.769317],[50.299369,54.76691],[50.303702,54.767878],[50.299112,54.769317]]]}",~/~/ Форма поля5205 - "shapeFormat": " geojson", ~/~/ Формат, в котором представлена форма поля4886 + "shape": "string", ~/~/ Форма поля 4887 + "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 5206 5206 "display": "string", ~/~/ Настройки отображения 5207 5207 "year": 0, ~/~/ Год поля 5208 5208 "name": "string", ~/~/ Наименование ... ... @@ -6123,479 +6123,6 @@ 6123 6123 ))) 6124 6124 6125 6125 6126 -= **Раздел: Роли** = 6127 - 6128 -== **Получение списка клиентских и системных ролей пользователя ** == 6129 - 6130 -(% class="box successmessage" %) 6131 -((( 6132 -**POST /api/v3/groups/find** 6133 -))) 6134 - 6135 -Пример запроса: 6136 - 6137 -((( 6138 -{ 6139 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6140 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6141 -} 6142 -))) 6143 - 6144 -((( 6145 - 6146 -))) 6147 - 6148 -((( 6149 -Пример ответа: 6150 -))) 6151 - 6152 -((( 6153 -((( 6154 -{ 6155 - "groups": [ ~/~/ Системные роли пользователя 6156 - { 6157 - "code": "string", ~/~/ Код роли. 6158 - "name": "string", ~/~/ Имя 6159 - "shortName": "string" ~/~/ Короткое имя 6160 - } 6161 - ], 6162 - "customGroups": [ ~/~/ Системные роли пользователя 6163 - { 6164 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6165 - "name": "string", ~/~/ Наименование 6166 - "shortName": "string", ~/~/ Короткое наименование 6167 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6168 - } 6169 - ] 6170 -} 6171 -))) 6172 -))) 6173 - 6174 -((( 6175 - 6176 -))) 6177 - 6178 -((( 6179 - 6180 -))) 6181 - 6182 -= **Раздел: Локатор ** = 6183 - 6184 - 6185 -== **Получение списка локаторов, доступных пользователю ** == 6186 - 6187 -(% class="box infomessage" %) 6188 -((( 6189 -**GET /api/v3/locators ** 6190 -))) 6191 - 6192 -В заголовках запроса: X-Auth: Токен авторизации 6193 - 6194 - 6195 -Пример ответа: 6196 - 6197 -((( 6198 -((( 6199 -{ 6200 - "vehiclesIds": [ ~/~/ Объекты 6201 - 0 6202 - ], 6203 - "geoIds": [ ~/~/ Геозоны 6204 - 0 6205 - ], 6206 - "fieldsIds": [ ~/~/ Поля 6207 - 0 6208 - ], 6209 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6210 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6211 - "agentName": "string", ~/~/ Наименование агента. 6212 - "isEnabled": true, ~/~/ Активность 6213 - "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6214 - "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6215 - "name": "string", ~/~/ Наименование. 6216 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6217 - "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6218 - "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6219 - "validity": 0, ~/~/ Значение срока действия 6220 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6221 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6222 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6223 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6224 - "url": "string", ~/~/ Ссылка 6225 - "language": 0, ~/~/ Язык 6226 - "showVehicleName": true, ~/~/ Наименование объекта 6227 - "showVehicleDirection": true, ~/~/ Направление движения на треке 6228 - "allowTrackReport": true, ~/~/ Трек 6229 - "showTrackTracing": true, ~/~/ Трассировка трека 6230 - "showSensors": true, ~/~/ Датчик 6231 - "availableMapLayers": [ ~/~/ Слои на карте 6232 - 0 6233 - ] 6234 -} 6235 -))) 6236 -))) 6237 - 6238 - 6239 -== **Получение перечня моделей ** == 6240 - 6241 -(% class="box successmessage" %) 6242 -((( 6243 -**POST /api/v3/models/find** 6244 -))) 6245 - 6246 -Пример запроса: 6247 - 6248 -((( 6249 -((( 6250 -{ 6251 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6252 - "name": "string", ~/~/ Наименование локатора 6253 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6254 -))) 6255 - 6256 - 6257 - 6258 - Пример ответа: 6259 - 6260 - 6261 -((( 6262 -[ 6263 - { 6264 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6265 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6266 - "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6267 - "name": "string", ~/~/ Наименование локатора 6268 - "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 6269 - } 6270 -] 6271 -))) 6272 -))) 6273 - 6274 - 6275 -== **Создание локатора** == 6276 - 6277 -(% class="box successmessage" %) 6278 -((( 6279 -**POST /api/v3/locators** 6280 -))) 6281 - 6282 -Пример запроса: 6283 - 6284 -((( 6285 -{ 6286 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6287 - "isEnabled": true, ~/~/ Активность 6288 - "name": "string", ~/~/ Наименование локатора 6289 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6290 - "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6291 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6292 - "autoProlongation": true, ~/~/ Автопродление срока действия. 6293 - "url": "string", ~/~/ Ссылка 6294 - "language": 0 ~/~/ Язык 6295 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6296 - "vehiclesIds": [ ~/~/ Oбъекты 6297 - 0 6298 - ], 6299 - "geoIds": [ ~/~/ Геозоны 6300 - 0 6301 - ], 6302 - "fieldsIds": [ ~/~/ Поля 6303 - 0 6304 - ], 6305 - "showVehicleName": true, ~/~/ Наименование объекта 6306 - "showVehicleDirection": true, ~/~/ Направление движения на треке 6307 - "allowTrackReport": true, ~/~/ Трек 6308 - "showTrackTracing": true, ~/~/ Трассировка трека 6309 - "showSensors": true, ~/~/ Датчик 6310 - "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6311 - 0 6312 - ] 6313 -} 6314 -))) 6315 - 6316 - 6317 -Пример ответа: 6318 - 6319 -((( 6320 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6321 -))) 6322 - 6323 - 6324 - 6325 -== **Изменение локатора** == 6326 - 6327 -(% class="box infomessage" %) 6328 -((( 6329 -**PUT /api/v3/locators** 6330 -))) 6331 - 6332 -Пример запроса: 6333 - 6334 -((( 6335 -{ 6336 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6337 - "isEnabled": true, ~/~/ Активность 6338 - "name": "string", ~/~/ Наименование 6339 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6340 - "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6341 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6342 - "autoProlongation": true, ~/~/ Автопродление срока действия 6343 - "url": "string", ~/~/ Ссылка 6344 - "language": 0 ~/~/ Язык 6345 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6346 - "vehiclesIds": [ ~/~/ Oбъекты 6347 - 0 6348 - ], 6349 - "geoIds": [ ~/~/ Геозоны 6350 - 0 6351 - ], 6352 - "fieldsIds": [ ~/~/ Поля 6353 - 0 6354 - ], 6355 - "showVehicleName": true, ~/~/ Наименование объекта 6356 - "showVehicleDirection": true, ~/~/ Направление движения на треке 6357 - "allowTrackReport": true, ~/~/ Трек 6358 - "showTrackTracing": true, ~/~/ Трассировка трека 6359 - "showSensors": true, ~/~/ Датчик 6360 - "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6361 - 0 6362 - ] 6363 -} 6364 - 6365 - 6366 -))) 6367 - 6368 -Пример ответа: 6369 - 6370 -200 ~/~/ Success 6371 - 6372 - 6373 -== **Удалить локатор** == 6374 - 6375 -(% class="box warningmessage" %) 6376 -((( 6377 -**DELETE /api/v3/locators** 6378 -))) 6379 - 6380 -Пример запроса: 6381 - 6382 -((( 6383 -[ 6384 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор локатора 6385 -] 6386 -))) 6387 - 6388 - 6389 - 6390 -= **Раздел: Яндекс Маршруты** = 6391 - 6392 - 6393 -== **Возвращение списка маршрутов** == 6394 - 6395 -(% class="box infomessage" %) 6396 -((( 6397 -**GET /api/v3/TransportRoutes** 6398 -))) 6399 - 6400 -Пример запроса: 6401 -Id ~/~/ Идентификатор поля 6402 - 6403 - 6404 -Пример ответа: 6405 - 6406 -((( 6407 -[ 6408 - { 6409 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6410 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6411 - "name": "string", ~/~/ Наименование маршрута. 6412 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6413 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6414 - 0 6415 - ] 6416 - } 6417 -] 6418 -))) 6419 - 6420 - 6421 - 6422 -== **Добавить маршрут** == 6423 - 6424 -(% class="box infomessage" %) 6425 -((( 6426 -**POST /api/v3/TransportRoutes** 6427 -))) 6428 - 6429 -Пример запроса: 6430 -{ 6431 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6432 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6433 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6434 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6435 - 0 6436 - ] 6437 -} 6438 - 6439 - 6440 -Пример ответа: 6441 - 6442 -((( 6443 -{ 6444 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6445 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6446 - "name": "string", ~/~/ Определяет наименование маршрута 6447 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6448 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6449 - 0 6450 - ] 6451 -} 6452 -))) 6453 - 6454 - 6455 -== **Обновление маршрута** == 6456 - 6457 -(% class="box successmessage" %) 6458 -((( 6459 -**PUT /api/v3/TransportRoutes** 6460 -))) 6461 - 6462 -Пример запроса: 6463 - 6464 -((( 6465 -{ 6466 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6467 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6468 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6469 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6470 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6471 - 0 6472 - ] 6473 -} 6474 -))) 6475 - 6476 - 6477 -Пример ответа: 6478 - 6479 -((( 6480 -{ 6481 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6482 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6483 - "name": "string", ~/~/ Определяет наименование маршрута 6484 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6485 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6486 - 0 6487 - ] 6488 -} 6489 -))) 6490 - 6491 - 6492 -== **Получить связки маршрутов ТС** == 6493 - 6494 -(% class="box infomessage" %) 6495 -((( 6496 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6497 -))) 6498 - 6499 -Пример запроса: 6500 - 6501 -((( 6502 -[ 6503 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6504 -] 6505 -))) 6506 - 6507 - 6508 -Пример ответа: 6509 - 6510 -((( 6511 -[ 6512 - { 6513 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6514 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6515 - } 6516 -] 6517 -))) 6518 - 6519 - 6520 -== **Удалить маршрут** == 6521 - 6522 -(% class="box warningmessage" %) 6523 -((( 6524 -**DELETE /api/v3/TransportRoutes/{id}** 6525 -))) 6526 - 6527 -Пример запроса: 6528 -Id ~/~/ Идентификатор поля 6529 - 6530 - 6531 - 6532 -= **Раздел: Управление доступа к машинам** = 6533 - 6534 - 6535 -== Получение списка транспортных средств видимых пользователю == 6536 - 6537 -(% class="box infomessage" %) 6538 -((( 6539 -**GET /api/v3/UserVisibleVehicles/{userId}** 6540 -))) 6541 - 6542 -Пример ответа: 6543 - 6544 -((( 6545 -{ 6546 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6547 - 0 6548 - ] 6549 -} 6550 -))) 6551 - 6552 - 6553 - 6554 -== Задает видимость транспортных средств пользователю == 6555 - 6556 -(% class="box infomessage" %) 6557 -((( 6558 -**POST /api/v3/UserVisibleVehicles** 6559 -))) 6560 - 6561 -Пример запроса: 6562 - 6563 -((( 6564 -((( 6565 -{ 6566 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6567 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6568 - 0 6569 - ] 6570 -} 6571 -))) 6572 - 6573 -((( 6574 - 6575 -))) 6576 - 6577 -((( 6578 - 6579 -))) 6580 - 6581 -((( 6582 -Пример ответа : 6583 -))) 6584 - 6585 -((( 6586 - 6587 -))) 6588 - 6589 -((( 6590 -200 ~/~/ Success 6591 -))) 6592 -))) 6593 - 6594 - 6595 - 6596 - 6597 - 6598 - 6599 6599 (% class="box" lang="en-US" style="text-align: center;" %) 6600 6600 ((( 6601 6601 (% 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]] **