Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/06/27 16:12
<
>
edited by Андрей Калиновский
on 2025/04/24 15:44
on 2025/04/24 15:44
edited by Андрей Калиновский
on 2025/06/09 16:36
on 2025/06/09 16:36
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -877,7 +877,7 @@ 877 877 { 878 878 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 879 879 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 880 - "deleted": true,880 + "deleted": false, 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": true,899 + "deleted": false, 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" %)Метод позволяет изменить статус пользователя, указанного в запросе.933 +(% 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" %)Метод позволяет удалить пользователя. Метод позволяет удалитьпользователя, указанного в строке запроса.1000 +(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалить модель, указанного в строке запроса. 1001 1001 1002 1002 (% style="color:#000000" %)Метод запроса: **DELETE** 1003 1003 ... ... @@ -1628,77 +1628,6 @@ 1628 1628 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1629 1629 1630 1630 1631 -== **Импортировать историю ТС (Асинхронный запрос)** == 1632 - 1633 -(% class="box successmessage" %) 1634 -((( 1635 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1636 -))) 1637 - 1638 -Метод запроса: **POST** 1639 - 1640 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1641 - 1642 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1643 - 1644 - 1645 -Ответ: 1646 - 1647 -{ 1648 - 1649 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1650 - 1651 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1652 - 1653 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1654 - 1655 - "Message": "string", ~/~/ Информация о выполнении запроса 1656 - 1657 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1658 - 1659 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1660 - 1661 - "Data": "string" ~/~/ Данные 1662 - 1663 -} 1664 - 1665 - 1666 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 1667 - 1668 -(% class="box infomessage" %) 1669 -((( 1670 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1671 -))) 1672 - 1673 -Метод запроса: **GET** 1674 - 1675 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1676 - 1677 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1678 - 1679 - 1680 -Ответ: 1681 - 1682 -{ 1683 - 1684 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1685 - 1686 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 1687 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1688 - 1689 - "Message": "string", ~/~/ Информация о выполнении запроса 1690 - 1691 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1692 - 1693 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1694 - 1695 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1696 - 1697 - "Data": "string" ~/~/ Данные 1698 - 1699 -} 1700 - 1701 - 1702 1702 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1703 1703 1704 1704 (% class="box infomessage" %) ... ... @@ -1844,7 +1844,6 @@ 1844 1844 "stage": "", ~/~/ Состояние 1845 1845 (% style="color:#000000" %) } 1846 1846 1847 -== == 1848 1848 1849 1849 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1850 1850 ... ... @@ -2527,6 +2527,8 @@ 2527 2527 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2528 2528 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2529 2529 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2458 + "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2459 + "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2530 2530 "fuelConsumption": 0, ~/~/ Расход топлива 2531 2531 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2532 2532 "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне ... ... @@ -2866,7 +2866,7 @@ 2866 2866 "id": 0, ~/~/ ID уведомления 2867 2867 "name": "string", ~/~/ Название уведомления 2868 2868 "active": true, ~/~/ Состояние true - активен, false - деактивирован 2869 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2799 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2870 2870 "userId": "", ~/~/ Пользователь, создавший уведомление 2871 2871 "parentId": "", ~/~/ Идентификатор клиента 2872 2872 "parentName": "string" ~/~/ Имя клиента ... ... @@ -2873,6 +2873,155 @@ 2873 2873 } 2874 2874 ] 2875 2875 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 + 2876 2876 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2877 2877 2878 2878 (% class="box infomessage" %) ... ... @@ -4319,6 +4319,43 @@ 4319 4319 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4320 4320 |msgCount|Кол-во обработанных сообщений всего 4321 4321 4401 +== **Импортировать историю ТС (Асинхронный запрос)** == 4402 + 4403 +(% class="box successmessage" %) 4404 +((( 4405 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4406 +))) 4407 + 4408 +При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4409 + 4410 +Метод запроса: **POST** 4411 + 4412 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4413 + 4414 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4415 + 4416 + 4417 +Ответ: 4418 + 4419 +{ 4420 + 4421 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4422 + 4423 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4424 + 4425 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4426 + 4427 + "Message": "string", ~/~/ Информация о выполнении запроса 4428 + 4429 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4430 + 4431 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4432 + 4433 + "Data": "string" ~/~/ Данные 4434 + 4435 +} 4436 + 4437 + 4322 4322 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4323 4323 4324 4324 (% class="box infomessage" %) ... ... @@ -4336,10 +4336,59 @@ 4336 4336 "message": "string" 4337 4337 } 4338 4338 4339 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4340 -|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4341 -|progress|Guid ТС 4455 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4456 +**Параметр** 4457 +)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4458 +**Описание** 4459 +))) 4460 +|((( 4461 +activity 4462 +)))|((( 4463 +Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4464 +))) 4465 +|((( 4466 +progress 4467 +)))|((( 4468 +Guid ТС 4469 +))) 4342 4342 4471 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 4472 + 4473 +(% class="box infomessage" %) 4474 +((( 4475 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4476 +))) 4477 + 4478 +При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4479 + 4480 +Метод запроса: **GET** 4481 + 4482 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4483 + 4484 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4485 + 4486 + 4487 +Ответ: 4488 + 4489 +{ 4490 + 4491 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4492 + 4493 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 4494 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4495 + 4496 + "Message": "string", ~/~/ Информация о выполнении запроса 4497 + 4498 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4499 + 4500 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4501 + 4502 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4503 + 4504 + "Data": "string" ~/~/ Данные 4505 + 4506 +} 4507 + 4343 4343 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4344 4344 4345 4345 (% class="box infomessage" %) ... ... @@ -5900,6 +5900,62 @@ 5900 5900 ))) 5901 5901 5902 5902 6068 += **Раздел: Роли** = 6069 + 6070 +== **Получение списка клиентских и системных ролей пользователя ** == 6071 + 6072 +(% class="box successmessage" %) 6073 +((( 6074 +**POST /api/v3/groups/find** 6075 +))) 6076 + 6077 +Пример запроса: 6078 + 6079 +((( 6080 +{ 6081 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 6082 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6083 +} 6084 +))) 6085 + 6086 +((( 6087 + 6088 +))) 6089 + 6090 +((( 6091 +Пример ответа: 6092 +))) 6093 + 6094 +((( 6095 +((( 6096 +{ 6097 + "groups": [ ~/~/ Системные роли пользователя 6098 + { 6099 + "code": "string", ~/~/ Код роли. 6100 + "name": "string", ~/~/ Имя 6101 + "shortName": "string" ~/~/ Короткое имя 6102 + } 6103 + ], 6104 + "customGroups": [ ~/~/ Системные роли пользователя 6105 + { 6106 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 6107 + "name": "string", ~/~/ Наименование 6108 + "shortName": "string", ~/~/ Короткое наименование 6109 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 6110 + } 6111 + ] 6112 +} 6113 +))) 6114 +))) 6115 + 6116 +((( 6117 + 6118 +))) 6119 + 6120 +((( 6121 + 6122 +))) 6123 + 5903 5903 = **Раздел: Локатор ** = 5904 5904 5905 5905 ... ... @@ -5907,7 +5907,7 @@ 5907 5907 5908 5908 (% class="box infomessage" %) 5909 5909 ((( 5910 -**GET /api/v3/locators** 6131 +**GET /api/v3/locators ** 5911 5911 ))) 5912 5912 5913 5913 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5916,33 +5916,83 @@ 5916 5916 Пример ответа: 5917 5917 5918 5918 ((( 6140 +((( 6141 +{ 6142 + "vehiclesIds": [ ~/~/ Объекты 6143 + 0 6144 + ], 6145 + "geoIds": [ ~/~/ Геозоны 6146 + 0 6147 + ], 6148 + "fieldsIds": [ ~/~/ Поля 6149 + 0 6150 + ], 6151 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6152 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6153 + "agentName": "string", ~/~/ Наименование агента. 6154 + "isEnabled": true, ~/~/ Активность 6155 + "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6156 + "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6157 + "name": "string", ~/~/ Наименование. 6158 + "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6159 + "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6160 + "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6161 + "validity": 0, ~/~/ Значение срока действия 6162 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6163 + "autoProlongation": true, ~/~/ Автопродление срока действия. 6164 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6165 + "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6166 + "url": "string", ~/~/ Ссылка 6167 + "language": 0, ~/~/ Язык 6168 + "showVehicleName": true, ~/~/ Наименование объекта 6169 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6170 + "allowTrackReport": true, ~/~/ Трек 6171 + "showTrackTracing": true, ~/~/ Трассировка трека 6172 + "showSensors": true, ~/~/ Датчик 6173 + "availableMapLayers": [ ~/~/ Слои на карте 6174 + 0 6175 + ] 6176 +} 6177 +))) 6178 +))) 6179 + 6180 + 6181 +== **Получение перечня моделей ** == 6182 + 6183 +(% class="box successmessage" %) 6184 +((( 6185 +**POST /api/v3/models/find** 6186 +))) 6187 + 6188 +Пример запроса: 6189 + 6190 +((( 6191 +((( 6192 +{ 6193 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6194 + "name": "string", ~/~/ Наименование локатора 6195 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6196 +))) 6197 + 6198 + 6199 + 6200 + Пример ответа: 6201 + 6202 + 6203 +((( 5919 5919 [ 5920 5920 { 5921 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5922 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5923 - "agentName": "string", ~/~/ Наименование агента. 5924 - "isEnabled": true, ~/~/ Активен 5925 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5926 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5927 - "name": "string", ~/~/ Наименование 5928 - "status": 0, ~/~/ 5929 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5930 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5931 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5932 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5933 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5934 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5935 - "url": "string", ~/~/ Ссылка 5936 - "language": 0, ~/~/ Язык. 5937 - "vehiclesCount": 0, ~/~/ Количество объектов. 5938 - "geozonesCount": 0, ~/~/ Количество геозон. 5939 - "fieldsCount": 0 ~/~/ Количество полей. 6206 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6207 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6208 + "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6209 + "name": "string", ~/~/ Наименование локатора 6210 + "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 5940 5940 } 5941 5941 ] 5942 5942 ))) 6214 +))) 5943 5943 5944 5944 5945 - 5946 5946 == **Создание локатора** == 5947 5947 5948 5948 (% class="box successmessage" %) ... ... @@ -5963,6 +5963,24 @@ 5963 5963 "autoProlongation": true, ~/~/ Автопродление срока действия. 5964 5964 "url": "string", ~/~/ Ссылка 5965 5965 "language": 0 ~/~/ Язык 6237 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6238 + "vehiclesIds": [ ~/~/ Oбъекты 6239 + 0 6240 + ], 6241 + "geoIds": [ ~/~/ Геозоны 6242 + 0 6243 + ], 6244 + "fieldsIds": [ ~/~/ Поля 6245 + 0 6246 + ], 6247 + "showVehicleName": true, ~/~/ Наименование объекта 6248 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6249 + "allowTrackReport": true, ~/~/ Трек 6250 + "showTrackTracing": true, ~/~/ Трассировка трека 6251 + "showSensors": true, ~/~/ Датчик 6252 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6253 + 0 6254 + ] 5966 5966 } 5967 5967 ))) 5968 5968 ... ... @@ -5995,10 +5995,29 @@ 5995 5995 "autoProlongation": true, ~/~/ Автопродление срока действия 5996 5996 "url": "string", ~/~/ Ссылка 5997 5997 "language": 0 ~/~/ Язык 6287 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6288 + "vehiclesIds": [ ~/~/ Oбъекты 6289 + 0 6290 + ], 6291 + "geoIds": [ ~/~/ Геозоны 6292 + 0 6293 + ], 6294 + "fieldsIds": [ ~/~/ Поля 6295 + 0 6296 + ], 6297 + "showVehicleName": true, ~/~/ Наименование объекта 6298 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6299 + "allowTrackReport": true, ~/~/ Трек 6300 + "showTrackTracing": true, ~/~/ Трассировка трека 6301 + "showSensors": true, ~/~/ Датчик 6302 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6303 + 0 6304 + ] 5998 5998 } 6306 + 6307 + 5999 5999 ))) 6000 6000 6001 - 6002 6002 Пример ответа: 6003 6003 6004 6004 200 ~/~/ Success ... ... @@ -6162,7 +6162,6 @@ 6162 6162 Id ~/~/ Идентификатор поля 6163 6163 6164 6164 6165 -==== ==== 6166 6166 6167 6167 = **Раздел: Управление доступа к машинам** = 6168 6168