Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Михаил Жучков on 2025/07/10 13:02
<
>
edited by Андрей Калиновский
on 2025/06/09 16:20
on 2025/06/09 16:20
edited by Андрей Калиновский
on 2025/07/03 16:18
on 2025/07/03 16:18
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -454,7 +454,7 @@ 454 454 [ 455 455 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 456 456 ], 457 - "language": 0~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский457 + "language": 1 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 458 458 } 459 459 { 460 460 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -766,6 +766,9 @@ 766 766 (% style="text-align:left" %) 767 767 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 768 768 769 +(% class="wikigeneratedid" %) 770 += = 771 + 769 769 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 770 770 771 771 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -2586,26 +2586,50 @@ 2586 2586 В заголовках запроса: X-Auth: Токен авторизации 2587 2587 2588 2588 2589 -В теле запроса перечисляетемассив id объектов, вквадратных скобкахчерез запятую.2592 +В массиве указываем id объектов через запятую 2590 2590 2591 2591 Ответ: 2595 + 2596 +[ 2592 2592 { 2593 - "vehicleId": 0, ~/~/Идентификатор объекта.2594 - "vehicleGuid": " 3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификаторобъекта.2595 - "vehicleNumber": " string",~/~/Номер объекта.2596 - "receiveTime": "202 4-02-27T14:11:00.315Z",~/~/Времяполучениязаписи на сервере,т.е. время срабатывания+ время передачи от устройствана сервер2597 - "recordTime": "202 4-02-27T14:11:00.315Z",~/~/Времязаписиотустройства, т.е. время фактическогособытия натранспортном средстве.2598 - "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.2599 - "speed": 0,~/~/Скорость объекта.2600 - "course": 0,~/~/Курс движения [0;360]2601 - "latitude": 0,~/~/Широта [-90°;90°].2602 - "longitude": 0,~/~/Долгота [-180°;180°]. 2603 - "address": " string",~/~/Адрес.2604 - "geozones": [ ~/~/Сведения по геозонам. 2598 + "vehicleId": 55728, ~/~/ Идентификатор объекта 2599 + "vehicleGuid": "fa9c0357-9b9f-44b9-a89c-20a2cb80a9ad", ~/~/ Guid объекта 2600 + "vehicleNumber": "0105 КМ", ~/~/ Номер объекта 2601 + "receiveTime": "2025-06-27T12:37:46.7782735Z", ~/~/ Время и дата поступления данных 2602 + "recordTime": "2025-06-27T12:37:19Z", ~/~/ Время и дата формирование данных 2603 + "state": 4, ~/~/ Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2604 + "speed": 31, ~/~/ Скорость объекта 2605 + "course": 116, ~/~/ Курс движения [0;360] 2606 + "latitude": 45.722128, ~/~/ Широта [-90°;90°]. 2607 + "longitude": 39.800432, ~/~/ Долгота [-180°;180°]. 2608 + "address": "\" Краснодарский край Россия 45,722128°, 39,800432°\"", ~/~/ Адрес 2609 + "geozones": [ ~/~/ Сведения по геозонам. 2605 2605 { 2606 - "id": 0, 2607 - "name": "string" 2611 + "id": 10225647, ~/~/ ID Геозоны 2612 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2613 + }, 2614 + { 2615 + "id": 10282875, ~/~/ ID Геозоны 2616 + "name": "Ё2" ~/~/ Наименование геозоны 2617 + }, 2618 + { 2619 + "id": 10226240, ~/~/ ID Геозоны 2620 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2621 + }, 2622 + { 2623 + "id": 9747869, ~/~/ ID Геозоны 2624 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2625 + }, 2626 + { 2627 + "id": 10221123, ~/~/ ID Геозоны 2628 + "name": "53r" ~/~/ Наименование геозоны 2629 + }, 2630 + { 2631 + "id": 10197638, ~/~/ ID Геозоны 2632 + "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2608 2608 } 2634 + ] 2635 + } 2609 2609 2610 2610 2611 2611 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = ... ... @@ -2803,6 +2803,155 @@ 2803 2803 } 2804 2804 ] 2805 2805 2833 + 2834 +== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2835 + 2836 +(% class="box infomessage" %) 2837 +((( 2838 +**POST /api/v3/notifications** 2839 +))) 2840 + 2841 +Метод запроса **POST** 2842 + 2843 +(% style="text-align: left;" %) 2844 +(% style="color:#000000" %)Пример запроса 2845 + 2846 +((( 2847 +{ 2848 + "id": 0, ~/~/ ID правила 2849 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2850 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2851 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2852 + "name": "string", ~/~/ Имя правила 2853 + "active": true, ~/~/ Активность правила 2854 + "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2855 + "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2856 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2857 + ], 2858 + "vehicleIds": [ ~/~/ Список объектов для анализа. 2859 + 0 2860 + ], 2861 + "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2862 + 0 2863 + ], 2864 + "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2865 + 0 2866 + ], 2867 + "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2868 + "additionalProp1": "string", 2869 + "additionalProp2": "string", 2870 + "additionalProp3": "string" 2871 + }, 2872 + "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2873 + "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2874 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2875 + ], 2876 + "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2877 + "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2878 + "string" 2879 + ], 2880 + "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2881 + "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2882 + { 2883 + "id": 0, ~/~/ Идентификатор участника чата. 2884 + "info": "string" ~/~/ Дополнительные сведения. 2885 + } 2886 + ], 2887 + "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2888 + "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2889 + "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2890 + "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2891 + "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2892 + "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2893 + "timezone": 0, ~/~/ часовой пояс 2894 + "validity": 0, ~/~/ Срок действия в днях (1-90). 2895 + "autoProlongation": true, ~/~/ Автопродление срока действия. 2896 + "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2897 + { 2898 + "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 - Срок действия правила истек 2899 + "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2900 + "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2901 + "additionalProp1": "string", 2902 + "additionalProp2": "string", 2903 + "additionalProp3": "string" 2904 + } 2905 + } 2906 + ] 2907 +} 2908 +))) 2909 + 2910 +((( 2911 + 2912 +))) 2913 + 2914 +((( 2915 + 2916 +))) 2917 + 2918 +Ответ: 2919 + 2920 +{ 2921 + "id": 0, ~/~/ ID правила 2922 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2923 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2924 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2925 + "name": "string", ~/~/ Имя правила 2926 + "active": true, ~/~/ Активность правила 2927 + "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2928 + "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2929 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2930 + ], 2931 + "vehicleIds": [ ~/~/ Список объектов для анализа. 2932 + 0 2933 + ], 2934 + "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2935 + 0 2936 + ], 2937 + "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2938 + 0 2939 + ], 2940 + "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2941 + "additionalProp1": "string", 2942 + "additionalProp2": "string", 2943 + "additionalProp3": "string" 2944 + }, 2945 + "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2946 + "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2947 + "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2948 + ], 2949 + "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2950 + "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2951 + "string" 2952 + ], 2953 + "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2954 + "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2955 + { 2956 + "id": 0, ~/~/ Идентификатор участника чата. 2957 + "info": "string" ~/~/ Дополнительные сведения. 2958 + } 2959 + ], 2960 + "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2961 + "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2962 + "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2963 + "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2964 + "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2965 + "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2966 + "timezone": 0, ~/~/ часовой пояс 2967 + "validity": 0, ~/~/ Срок действия в днях (1-90). 2968 + "autoProlongation": true, ~/~/ Автопродление срока действия. 2969 + "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2970 + { 2971 + "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 - Срок действия правила истек 2972 + "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2973 + "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2974 + "additionalProp1": "string", 2975 + "additionalProp2": "string", 2976 + "additionalProp3": "string" 2977 + } 2978 + } 2979 + ] 2980 +} 2981 + 2806 2806 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2807 2807 2808 2808 (% class="box infomessage" %) ... ... @@ -4020,16 +4020,12 @@ 4020 4020 Тело запроса: 4021 4021 4022 4022 { 4023 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4024 - "Balance": 0 4199 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4200 + "Balance": 0 ~/~/ Значение баланса. 4025 4025 } 4026 4026 4027 4027 Ответ: Success 4028 4028 4029 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4030 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4031 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4032 - 4033 4033 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4034 4034 4035 4035 (% class="box warningmessage" %) ... ... @@ -4041,16 +4041,29 @@ 4041 4041 4042 4042 Тело запроса: 4043 4043 4216 +((( 4044 4044 { 4045 - " ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",4046 - " Balance": 04218 + "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4219 + "amount": 0 ~/~/ Сумма пополнения баланса 4047 4047 } 4221 +))) 4048 4048 4223 +((( 4224 + 4225 +))) 4226 + 4049 4049 Ответ: Success 4050 4050 4051 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4052 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4053 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4229 +((( 4230 +{ 4231 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4232 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4233 + "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4234 + "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4235 + "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4236 + "Description": "string" ~/~/ Описание корректировки. 4237 +} 4238 +))) 4054 4054 4055 4055 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4056 4056 ... ... @@ -4063,16 +4063,25 @@ 4063 4063 4064 4064 Тело запроса: 4065 4065 4251 +((( 4066 4066 { 4067 - " ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",4068 - " Balance": 04253 + "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4254 + "amount": 0 ~/~/ Сумма списания с баланса 4069 4069 } 4256 +))) 4070 4070 4071 4071 Ответ: Success 4072 4072 4073 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4074 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 4075 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 4260 +((( 4261 +{ 4262 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4263 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4264 + "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4265 + "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4266 + "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4267 + "Description": "string" ~/~/ Описание корректировки 4268 +} 4269 +))) 4076 4076 4077 4077 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4078 4078 ... ... @@ -4083,28 +4083,35 @@ 4083 4083 4084 4084 Тело запроса: 4085 4085 4280 +((( 4086 4086 { 4087 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4088 - "CalculationType": 0, 4089 - "PermissibleBalance": 0, 4090 - "DefermentDays": 0, 4091 - "SendUiNotifications": true, 4092 - "SendEmailNotifications": true, 4093 - "IsPrivate": true, 4282 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4283 + "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4284 + "PermissibleBalance": 0, ~/~/ Допустимый баланс 4285 + "DefermentDays": 0, ~/~/ Отсрочка (дни). 4286 + "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4287 + "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4094 4094 } 4289 +))) 4095 4095 4291 +((( 4292 + 4293 +))) 4294 + 4096 4096 Ответ: Success 4097 4097 4098 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4099 -|ClientId|Идентификатор клиента 4100 -|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни 4101 -|PermissibleBalance|Допустимый баланс 4102 -|DefermentDays|((( 4103 -Отсрочка, количество дней 4297 +((( 4298 +{ 4299 + "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4300 + "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4301 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4302 + "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4303 + "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4304 + "DefermentDays": 0, ~/~/ Отсрочка (дни) 4305 + "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4306 + "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4307 +} 4104 4104 ))) 4105 -|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено 4106 -|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено 4107 -|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4108 4108 4109 4109 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4110 4110 ... ... @@ -4116,35 +4116,68 @@ 4116 4116 Тело запроса: 4117 4117 4118 4118 { 4119 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4120 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4121 - "Features": [ 4320 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4321 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4322 + "Features": [ ~/~/ Набор услуг по тарифу клиента. 4122 4122 { 4123 - "Feature": "string", 4124 - "IsEnabled": true, 4125 - "IsFactual": true, 4126 - "Limit": 0, 4127 - "Price": 0, 4128 - "DebitDate": "2023-10-18T13:26:58.987Z", 4129 - "PeriodValue": 0, 4130 - "PeriodType": 0 4324 + "Feature": "string", ~/~/ Код услуги. 4325 + "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4326 + "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4327 + "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование 4328 + "Price": 0, ~/~/ Цена за единицу. 4329 + "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4330 + "PeriodValue": 0, ~/~/ Значение периода. 4331 + "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы) 4131 4131 } 4132 4132 ] 4133 4133 } 4134 4134 4336 + 4135 4135 Ответ: Success 4136 4136 4137 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4138 -|ClientId|Идентификатор клиента 4139 -|PlanId|Идентификатор тарифного плана 4140 -|Feature|Код услуги 4141 -|IsEnabled|Признак, определяющий активирована ли услуга 4142 -|IsFactual|Признак, определяющий расчёт по факту 4143 -|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4144 -|Price|Цена за единицу. 4145 -|DebitDate|Следующий момент времени списания с баланса за услугу. 4146 -|PeriodValue|Значение периода. 4147 -|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 4339 +((( 4340 +{ 4341 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4342 + "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4343 + "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4344 + "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4345 + "Name": "string", ~/~/ Наименование. 4346 + "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4347 + "Constraint": { ~/~/ Ограничения по тарифу 4348 + "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4349 + "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4350 + "DefermentDays": 0 ~/~/ Отсрочка (дни) 4351 + }, 4352 + "Features": [ ~/~/ Набор услуг по тарифному плану. 4353 + { 4354 + "Feature": "string", ~/~/Код услуги. 4355 + "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4356 + "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4357 + "Price": 0, ~/~/ Цена за единицу. 4358 + "PeriodValue": 0, ~/~/ Значение периода. 4359 + "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4360 + } 4361 + ], 4362 + "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4363 + "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4364 + "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4365 + }, 4366 + "Features": [ ~/~/ Набор услуг по тарифу клиента. 4367 + { 4368 + "Feature": "string", ~/~/ Код услуги. 4369 + "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4370 + "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4371 + "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4372 + "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4373 + "Price": 0, ~/~/ Цена за единицу. 4374 + "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4375 + "PeriodValue": 0, ~/~/ Значение периода. 4376 + "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4377 + "Quantity": 0 ~/~/ Количество использования услуги. 4378 + } 4379 + ] 4380 +} 4381 +))) 4148 4148 4149 4149 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4150 4150 ... ... @@ -5990,13 +5990,13 @@ 5990 5990 ((( 5991 5991 ((( 5992 5992 { 5993 - "vehiclesIds": [ ~/~/ Объекты6227 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 5994 5994 0 5995 5995 ], 5996 - "geoIds": [ ~/~/ Геозоны6230 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 5997 5997 0 5998 5998 ], 5999 - "fieldsIds": [ ~/~/ Поля6233 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6000 6000 0 6001 6001 ], 6002 6002 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. ... ... @@ -6015,7 +6015,7 @@ 6015 6015 "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6016 6016 "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6017 6017 "url": "string", ~/~/ Ссылка 6018 - "language": 0, ~/~/ Язык 6252 + "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6019 6019 "showVehicleName": true, ~/~/ Наименование объекта 6020 6020 "showVehicleDirection": true, ~/~/ Направление движения на треке 6021 6021 "allowTrackReport": true, ~/~/ Трек ... ... @@ -6029,47 +6029,64 @@ 6029 6029 ))) 6030 6030 6031 6031 6032 -== **Получение перечня моделей ** == 6266 +((( 6267 +((( 6268 + 6269 +))) 6270 +))) 6033 6033 6272 + 6273 +== **Создание локатора** == 6274 + 6034 6034 (% class="box successmessage" %) 6035 6035 ((( 6036 -**POST /api/v3/ models/find**6277 +**POST /api/v3/locators** 6037 6037 ))) 6038 6038 6039 6039 Пример запроса: 6040 6040 6041 6041 ((( 6042 -((( 6043 6043 { 6044 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6045 - "name": "string", ~/~/ Наименование локатора 6046 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6284 + "isEnabled": true, ~/~/ Активность 6285 + "name": "string", ~/~/ Наименование локатора 6286 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) 6287 + "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6288 + "validity": 0, ~/~/ Срок действия в днях (1-90) 6289 + "autoProlongation": true, ~/~/ Автопродление срока действия. 6290 + "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6291 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6292 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6293 + 0 6294 + ], 6295 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6296 + 0 6297 + ], 6298 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6299 + 0 6300 + ], 6301 + "showVehicleName": true, ~/~/ Наименование объекта 6302 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6303 + "allowTrackReport": true, ~/~/ Трек 6304 + "showTrackTracing": true, ~/~/ Трассировка трека 6305 + "showSensors": true, ~/~/ Датчик 6306 + "availableMapLayers": 1 [ ~/~/ Слои на карте ,по умолчанию 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ГИС) 6307 + ] 6308 +} 6047 6047 ))) 6048 6048 6049 6049 6312 +Пример ответа: 6050 6050 6051 - Пример ответа: 6052 - 6053 - 6054 6054 ((( 6055 -[ 6056 - { 6057 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6058 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6059 - "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6060 - "name": "string", ~/~/ Наименование локатора 6061 - "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 6062 - } 6063 -] 6315 +3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6064 6064 ))) 6065 -))) 6066 6066 6067 6067 6068 -== ** Созданиелокатора** ==6319 +== **Выводит список локаторов ** == 6069 6069 6070 6070 (% class="box successmessage" %) 6071 6071 ((( 6072 -**POST /api/v3/locators** 6323 +**POST /api/v3/locators/find** 6073 6073 ))) 6074 6074 6075 6075 Пример запроса: ... ... @@ -6076,7 +6076,16 @@ 6076 6076 6077 6077 ((( 6078 6078 { 6079 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6330 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6331 +} 6332 +))) 6333 + 6334 +((( 6335 + 6336 +))) 6337 + 6338 +((( 6339 +{ 6080 6080 "isEnabled": true, ~/~/ Активность 6081 6081 "name": "string", ~/~/ Наименование локатора 6082 6082 "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) ... ... @@ -6083,16 +6083,15 @@ 6083 6083 "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6084 6084 "validity": 0, ~/~/ Срок действия в днях (1-90) 6085 6085 "autoProlongation": true, ~/~/ Автопродление срока действия. 6086 - "url": "string", ~/~/ Ссылка 6087 - "language": 0 ~/~/ Язык 6346 + "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6088 6088 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6089 - "vehiclesIds": [ ~/~/ Oбъекты6348 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6090 6090 0 6091 6091 ], 6092 - "geoIds": [ ~/~/ Геозоны6351 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6093 6093 0 6094 6094 ], 6095 - "fieldsIds": [ ~/~/ Поля6354 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6096 6096 0 6097 6097 ], 6098 6098 "showVehicleName": true, ~/~/ Наименование объекта ... ... @@ -6100,9 +6100,8 @@ 6100 6100 "allowTrackReport": true, ~/~/ Трек 6101 6101 "showTrackTracing": true, ~/~/ Трассировка трека 6102 6102 "showSensors": true, ~/~/ Датчик 6103 - "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6104 - 0 6105 - ] 6362 + "availableMapLayers": 1 [ ~/~/ Слои на карте ,по умолчанию 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ГИС) 6363 + ] 6106 6106 } 6107 6107 ))) 6108 6108 ... ... @@ -6110,7 +6110,39 @@ 6110 6110 Пример ответа: 6111 6111 6112 6112 ((( 6113 -3fa85f64-5717-4562-b3fc-2c963f66afa6 ~/~/ Идентификатор локатора 6371 +[ 6372 + { 6373 + "vehiclesCount": 0, ~/~/ Количество объектов. 6374 + "geozonesCount": 0, ~/~/ Количество геозон. 6375 + "fieldsCount": 0, ~/~/ Количество полей. 6376 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6377 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6378 + "agentName": "string", ~/~/ Наименование агента. 6379 + "isEnabled": true, ~/~/ Активность локатора 6380 + "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6381 + "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6382 + "name": "string", ~/~/ Наименование локатора 6383 + "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6384 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6385 + "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6386 + "validity": 0, ~/~/ Срок действия в днях (1-90) 6387 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6388 + "autoProlongation": true, ~/~/ Автоматическая пролонгация 6389 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6390 + "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6391 + "url": "string", ~/~/ ссылка на локатор 6392 + "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6393 + "showVehicleName": true, ~/~/ Наименование объекта 6394 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6395 + "allowTrackReport": true, ~/~/ Трек 6396 + "showTrackTracing": true, ~/~/ Трассировка трека 6397 + "showSensors": true, ~/~/ Датчик 6398 + "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ГИС) 6399 + 6400 + 0 6401 + ] 6402 + } 6403 +] 6114 6114 ))) 6115 6115 6116 6116 ... ... @@ -6133,16 +6133,14 @@ 6133 6133 "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6134 6134 "validity": 0, ~/~/ Срок действия в днях (1-90) 6135 6135 "autoProlongation": true, ~/~/ Автопродление срока действия 6136 - "url": "string", ~/~/ Ссылка 6137 - "language": 0 ~/~/ Язык 6138 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6139 - "vehiclesIds": [ ~/~/ Oбъекты 6426 + "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6427 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6140 6140 0 6141 6141 ], 6142 - "geoIds": [ ~/~/ Геозоны6430 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6143 6143 0 6144 6144 ], 6145 - "fieldsIds": [ ~/~/ Поля6433 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6146 6146 0 6147 6147 ], 6148 6148 "showVehicleName": true, ~/~/ Наименование объекта ... ... @@ -6150,8 +6150,7 @@ 6150 6150 "allowTrackReport": true, ~/~/ Трек 6151 6151 "showTrackTracing": true, ~/~/ Трассировка трека 6152 6152 "showSensors": true, ~/~/ Датчик 6153 - "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6154 - 0 6441 + "availableMapLayers": 1 [ ~/~/ Слои на карте ,по умолчанию 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ГИС) 6155 6155 ] 6156 6156 } 6157 6157 ... ... @@ -6385,10 +6385,44 @@ 6385 6385 ))) 6386 6386 6387 6387 6675 +== **Получение перечня моделей ** == 6388 6388 6677 +(% class="box successmessage" %) 6678 +((( 6679 +**POST /api/v3/models/find** 6680 +))) 6389 6389 6682 +Пример запроса: 6390 6390 6684 +((( 6685 +((( 6686 +{ 6687 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6688 + "name": "string", ~/~/ Наименование локатора 6689 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6690 +))) 6391 6391 6692 + 6693 + 6694 + Пример ответа: 6695 + 6696 + 6697 +((( 6698 +[ 6699 + { 6700 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6701 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6702 + "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6703 + "name": "string", ~/~/ Наименование локатора 6704 + "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 6705 + } 6706 +] 6707 +))) 6708 +))) 6709 + 6710 + 6711 + 6712 + 6392 6392 (% class="box" lang="en-US" style="text-align: center;" %) 6393 6393 ((( 6394 6394 (% 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]] **