Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/09/11 10:51
<
>
edited by Андрей Калиновский
on 2025/09/09 14:38
on 2025/09/09 14:38
edited by Андрей Калиновский
on 2025/06/09 16:20
on 2025/06/09 16:20
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -287,6 +287,28 @@ 287 287 "bankKS": "string" ~/~/ корр. счёт 288 288 } 289 289 290 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 291 +|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 292 +|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 293 +|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 294 +|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 295 +|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 296 +|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 297 +|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 298 +|(% style="width:215px" %)district|(% style="width:861px" %)Округ 299 +|(% style="width:215px" %)region|(% style="width:861px" %)Регион 300 +|(% style="width:215px" %)city|(% style="width:861px" %)Город 301 +|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 302 +|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 303 +|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 304 +|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 305 +|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 306 +|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 307 +|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 308 +|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 309 +|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 310 +|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 311 + 290 290 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 291 291 292 292 (% class="box warningmessage" %) ... ... @@ -432,7 +432,7 @@ 432 432 [ 433 433 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 434 434 ], 435 - "language": 1~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский457 + "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 436 436 } 437 437 { 438 438 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -744,11 +744,6 @@ 744 744 (% style="text-align:left" %) 745 745 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 746 746 747 -(% class="wikigeneratedid" id="H" %) 748 -((( 749 - 750 -))) 751 - 752 752 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 753 753 754 754 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -2372,7 +2372,7 @@ 2372 2372 Тело запроса: 2373 2373 2374 2374 { 2375 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2392 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2376 2376 "vehicleIds": [0], ~/~/ Список ID объектов 2377 2377 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2378 2378 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2419,7 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2422 - "sampling": 86400, ~/~/ Частота дискретизации,секунд, минимум-60(если передано,то весь период бъётсяна подпериоды с указанной частотой)2439 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2423 2423 "vehicleIds": [0], ~/~/ Список ID объектов 2424 2424 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2425 2425 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2569,241 +2569,223 @@ 2569 2569 В заголовках запроса: X-Auth: Токен авторизации 2570 2570 2571 2571 2572 -В массивеуказываемid объектов через запятую2589 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2573 2573 2574 2574 Ответ: 2575 - 2576 -[ 2577 2577 { 2578 - "vehicleId": 55728, ~/~/2579 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",Guidобъекта2580 - "vehicleNumber": " 0105 КМ",2581 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",датапоступления данных2582 - "recordTime": "202 5-06-27T12:37:19Z",датаформированиеданных2583 - "state": 4,2584 - "speed": 31,2585 - "course": 116,2586 - "latitude": 45.722128,2587 - "longitude": 39.800432,2588 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/2589 - "geozones": [ ~/~/ 2593 + "vehicleId": 0, ~/~/Идентификатор объекта. 2594 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2595 + "vehicleNumber": "string",~/~/Номер объекта. 2596 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2597 + "recordTime": "2024-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": [ ~/~/Сведения по геозонам. 2590 2590 { 2591 - "id": 10225647, ~/~/ ID Геозоны 2592 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2593 - }, 2594 - { 2595 - "id": 10282875, ~/~/ ID Геозоны 2596 - "name": "Ё2" ~/~/ Наименование геозоны 2597 - }, 2598 - { 2599 - "id": 10226240, ~/~/ ID Геозоны 2600 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2601 - }, 2602 - { 2603 - "id": 9747869, ~/~/ ID Геозоны 2604 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2605 - }, 2606 - { 2607 - "id": 10221123, ~/~/ ID Геозоны 2608 - "name": "53r" ~/~/ Наименование геозоны 2609 - }, 2610 - { 2611 - "id": 10197638, ~/~/ ID Геозоны 2612 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2606 + "id": 0, 2607 + "name": "string" 2613 2613 } 2614 - ] 2615 - } 2616 2616 2617 2617 2618 -= = 2611 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2619 2619 2620 -= (% style="color:#000000; font-size:1 8.6667px" %)Раздел:**Уведомления**(%%) =2613 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2621 2621 2622 -== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2623 - 2624 2624 (% class="box infomessage" %) 2625 2625 ((( 2626 -**POST /api/v3/ notifications/find**2617 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2627 2627 ))) 2628 2628 2629 -Метод возвращаетинформациюобуведомлениях переданногоклиента иегоклиентов нижепо иерархии.2620 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2630 2630 2631 -(% style="text-align: left;" %) 2632 -Метод запроса **POST** 2622 +(% style="color:#000000" %)Метод запроса: **POST** 2633 2633 2634 -(% style="text-align: left;" %) 2635 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2624 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2636 2636 2637 -(% style="text-align: left;" %) 2638 2638 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2639 2639 2628 +(% style="text-align:left" %) 2629 +Тело запроса: 2630 + 2631 +(% style="text-align:left" %) 2640 2640 { 2641 - "parentId": "" ~/~/ id клиента2633 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2642 2642 } 2643 2643 2636 +(% style="text-align:left" %) 2644 2644 Ответ: 2645 2645 2646 2646 [ 2647 2647 { 2648 - "id": 0, ~/~/ ID уведомления 2649 - "name": "string", ~/~/ Название уведомления 2650 - "active": true, ~/~/ Состояние true - активен, false - деактивирован 2651 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2652 - "userId": "", ~/~/ Пользователь, создавший уведомление 2653 - "parentId": "", ~/~/ Идентификатор клиента 2654 - "parentName": "string" ~/~/ Имя клиента 2641 + "id": 0, ~/~/ Идентификатор объекта геозоны 2642 + "name": "string", ~/~/ Название объекта геозоны 2643 + "type": 0, ~/~/ Тип объекта геозоны 2644 + "fname": "string", ~/~/ Имя файла 2645 + "parentId": "string", ~/~/ Идентификатор клиента 2646 + "radius": 0, ~/~/ Радиус геообъекта 2647 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2648 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2649 + "description": "string", ~/~/ Описание 2650 + "area": 0, ~/~/ Площадь, м^^2^^ 2651 + "perimetr": 0, ~/~/ Периметр, м 2652 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2655 2655 } 2656 2656 ] 2657 2657 2656 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2658 2658 2659 -== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) == 2660 - 2661 2661 (% class="box infomessage" %) 2662 2662 ((( 2663 -**POST /api/v3/ notifications**2660 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2664 2664 ))) 2665 2665 2666 -Метод з апроса**POST**2663 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2667 2667 2668 -(% style="text-align: left;" %) 2669 -(% style="color:#000000" %)Пример запроса 2665 +(% style="color:#000000" %)Метод запроса: **POST** 2670 2670 2667 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2668 + 2669 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2670 + 2671 +(% style="text-align:left" %) 2672 +Тело запроса: 2673 + 2674 +{ 2675 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2676 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2677 + "ids": [ ], ~/~/ Массив id объектов 2678 + "byTime": 0, ~/~/ Объединение событий по времени 2679 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2680 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2681 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2682 +} 2683 + 2684 +Ответ: 2685 +[ 2686 + { 2687 + "geozoneId": 0, ~/~/ ID геообъекта 2688 + "geozoneName": "string", ~/~/ Название геообъекта 2689 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2690 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2691 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2692 + "vehicleId": 0, ~/~/ ID объекта 2693 + "vehicleName": "string" ~/~/ Имя объекта 2694 + } 2695 +] 2696 + 2697 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2698 + 2699 +(% class="box infomessage" %) 2671 2671 ((( 2701 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2702 +))) 2703 + 2704 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2705 + 2706 +(% style="color:#000000" %)Метод запроса: **POST** 2707 + 2708 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2709 + 2710 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2711 + 2712 +(% style="text-align:left" %) 2713 +Тело запроса: 2714 + 2672 2672 { 2673 - "id": 0, ~/~/ ID правила 2674 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2675 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2676 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2677 - "name": "string", ~/~/ Имя правила 2678 - "active": true, ~/~/ Активность правила 2679 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2680 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2681 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2682 - ], 2683 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2684 - 0 2685 - ], 2686 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2687 - 0 2688 - ], 2689 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2690 - 0 2691 - ], 2692 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2693 - "additionalProp1": "string", 2694 - "additionalProp2": "string", 2695 - "additionalProp3": "string" 2696 - }, 2697 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2698 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2699 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2700 - ], 2701 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2702 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2703 - "string" 2704 - ], 2705 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2706 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2707 - { 2708 - "id": 0, ~/~/ Идентификатор участника чата. 2709 - "info": "string" ~/~/ Дополнительные сведения. 2710 - } 2711 - ], 2712 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2713 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2714 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2715 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2716 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2717 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2718 - "timezone": 0, ~/~/ часовой пояс 2719 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2720 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2721 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2722 - { 2723 - "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 - Срок действия правила истек 2724 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2725 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2726 - "additionalProp1": "string", 2727 - "additionalProp2": "string", 2728 - "additionalProp3": "string" 2729 - } 2730 - } 2731 - ] 2716 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2717 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2718 + "ids": [ ], ~/~/ Массив id геообъектов 2719 + "byTime": 0, ~/~/ Объединение событий по времени 2720 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2721 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2722 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2732 2732 } 2724 + 2725 +Ответ: 2726 + 2727 +[ 2728 + { 2729 + "geozoneId": 0, ~/~/ ID геообъекта 2730 + "geozoneName": "string", ~/~/ Название геообъекта 2731 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2732 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2733 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2734 + "vehicleId": 0, ~/~/ ID объекта 2735 + "vehicleName": "string" ~/~/ Имя объекта 2736 + } 2737 +] 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** 2733 2733 ))) 2734 2734 2747 +(% style="color:#000000" %)Метод запроса: **PUT** 2748 + 2749 +Пример запроса: 2750 + 2735 2735 ((( 2736 - 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 +} 2737 2737 ))) 2738 2738 2763 + 2764 +Пример ответа: 2765 + 2766 +200 ~/~/ Success 2767 + 2768 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2769 + 2770 +== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == 2771 + 2772 +(% class="box infomessage" %) 2739 2739 ((( 2740 - 2774 +**POST /api/v3/notifications/find** 2741 2741 ))) 2742 2742 2743 - Ответ:2777 +Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии. 2744 2744 2779 +(% style="text-align: left;" %) 2780 +Метод запроса **POST** 2781 + 2782 +(% style="text-align: left;" %) 2783 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find 2784 + 2785 +(% style="text-align: left;" %) 2786 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2787 + 2745 2745 { 2746 - "id": 0, ~/~/ ID правила 2747 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя 2748 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило 2749 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 2750 - "name": "string", ~/~/ Имя правила 2751 - "active": true, ~/~/ Активность правила 2752 - "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто 2753 - "vehicleGroups": [ ~/~/ Список групп объектов для анализа. 2754 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ 2755 - ], 2756 - "vehicleIds": [ ~/~/ Список объектов для анализа. 2757 - 0 2758 - ], 2759 - "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам. 2760 - 0 2761 - ], 2762 - "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам. 2763 - 0 2764 - ], 2765 - "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений. 2766 - "additionalProp1": "string", 2767 - "additionalProp2": "string", 2768 - "additionalProp3": "string" 2769 - }, 2770 - "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы" 2771 - "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила 2772 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2773 - ], 2774 - "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям" 2775 - "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений 2776 - "string" 2777 - ], 2778 - "toTelegram": true, ~/~/ Флаг активности отправки в Telegram 2779 - "telegrams": [ ~/~/ Список получателя уведомлений в Telegram. 2780 - { 2781 - "id": 0, ~/~/ Идентификатор участника чата. 2782 - "info": "string" ~/~/ Дополнительные сведения. 2783 - } 2784 - ], 2785 - "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение 2786 - "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы 2787 - "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений. 2788 - "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение) 2789 - "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени) 2790 - "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC) 2791 - "timezone": 0, ~/~/ часовой пояс 2792 - "validity": 0, ~/~/ Срок действия в днях (1-90). 2793 - "autoProlongation": true, ~/~/ Автопродление срока действия. 2794 - "templates": [ ~/~/ Переопределения шаблонов уведомлений. 2795 - { 2796 - "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 - Срок действия правила истек 2797 - "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа. 2798 - "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка. 2799 - "additionalProp1": "string", 2800 - "additionalProp2": "string", 2801 - "additionalProp3": "string" 2802 - } 2803 - } 2804 - ] 2789 + "parentId": "" ~/~/ id клиента 2805 2805 } 2806 2806 2792 +Ответ: 2793 + 2794 +[ 2795 + { 2796 + "id": 0, ~/~/ ID уведомления 2797 + "name": "string", ~/~/ Название уведомления 2798 + "active": true, ~/~/ Состояние true - активен, false - деактивирован 2799 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2800 + "userId": "", ~/~/ Пользователь, создавший уведомление 2801 + "parentId": "", ~/~/ Идентификатор клиента 2802 + "parentName": "string" ~/~/ Имя клиента 2803 + } 2804 +] 2805 + 2807 2807 == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) == 2808 2808 2809 2809 (% class="box infomessage" %) ... ... @@ -4021,12 +4021,16 @@ 4021 4021 Тело запроса: 4022 4022 4023 4023 { 4024 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4025 - "Balance": 0 ~/~/ Значение баланса.4023 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4024 + "Balance": 0 4026 4026 } 4027 4027 4028 4028 Ответ: Success 4029 4029 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 + 4030 4030 == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 4031 4031 4032 4032 (% class="box warningmessage" %) ... ... @@ -4038,29 +4038,16 @@ 4038 4038 4039 4039 Тело запроса: 4040 4040 4041 -((( 4042 4042 { 4043 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4044 - "a mount": 0~/~/ Сумма пополнения баланса4045 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4046 + "Balance": 0 4045 4045 } 4046 -))) 4047 4047 4048 -((( 4049 - 4050 -))) 4051 - 4052 4052 Ответ: Success 4053 4053 4054 -((( 4055 -{ 4056 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4057 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4058 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4059 - "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки. 4060 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4061 - "Description": "string" ~/~/ Описание корректировки. 4062 -} 4063 -))) 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" %)Значение баланса 4064 4064 4065 4065 == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 4066 4066 ... ... @@ -4073,25 +4073,16 @@ 4073 4073 4074 4074 Тело запроса: 4075 4075 4076 -((( 4077 4077 { 4078 - " clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/ Идентификатор клиента.4079 - "a mount": 0~/~/ Сумма списания с баланса4067 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4068 + "Balance": 0 4080 4080 } 4081 -))) 4082 4082 4083 4083 Ответ: Success 4084 4084 4085 -((( 4086 -{ 4087 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки. 4088 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4089 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя. 4090 - "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки. 4091 - "Amount": 0, ~/~/ Значение, на которое корректируется баланс. 4092 - "Description": "string" ~/~/ Описание корректировки 4093 -} 4094 -))) 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" %)Значение баланса 4095 4095 4096 4096 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 4097 4097 ... ... @@ -4102,35 +4102,28 @@ 4102 4102 4103 4103 Тело запроса: 4104 4104 4105 -((( 4106 4106 { 4107 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4108 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4109 - "PermissibleBalance": 0, ~/~/ Допустимый баланс 4110 - "DefermentDays": 0, ~/~/ Отсрочка (дни). 4111 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4112 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 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, 4113 4113 } 4114 -))) 4115 4115 4116 -((( 4117 - 4118 -))) 4119 - 4120 4120 Ответ: Success 4121 4121 4122 -((( 4123 -{ 4124 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4125 - "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент. 4126 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4127 - "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни 4128 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4129 - "DefermentDays": 0, ~/~/ Отсрочка (дни) 4130 - "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено 4131 - "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено 4132 -} 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 +Отсрочка, количество дней 4133 4133 ))) 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" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом 4134 4134 4135 4135 == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) == 4136 4136 ... ... @@ -4142,68 +4142,35 @@ 4142 4142 Тело запроса: 4143 4143 4144 4144 { 4145 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.4146 - "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.4147 - "Features": [ ~/~/ Набор услуг по тарифу клиента.4119 + "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4120 + "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4121 + "Features": [ 4148 4148 { 4149 - "Feature": "string", ~/~/ Код услуги.4150 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.4151 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.4152 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование4153 - "Price": 0, ~/~/ Цена за единицу.4154 - "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.4155 - "PeriodValue": 0, ~/~/ Значение периода.4156 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)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 4157 4157 } 4158 4158 ] 4159 4159 } 4160 4160 4161 - 4162 4162 Ответ: Success 4163 4163 4164 -((( 4165 -{ 4166 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 4167 - "Plan": { ~/~/ Определяет тарифный план (шаблон услуг) 4168 - "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана. 4169 - "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца. 4170 - "Name": "string", ~/~/ Наименование. 4171 - "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план. 4172 - "Constraint": { ~/~/ Ограничения по тарифу 4173 - "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни) 4174 - "PermissibleBalance": 0, ~/~/ Допустимый баланс. 4175 - "DefermentDays": 0 ~/~/ Отсрочка (дни) 4176 - }, 4177 - "Features": [ ~/~/ Набор услуг по тарифному плану. 4178 - { 4179 - "Feature": "string", ~/~/Код услуги. 4180 - "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту. 4181 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4182 - "Price": 0, ~/~/ Цена за единицу. 4183 - "PeriodValue": 0, ~/~/ Значение периода. 4184 - "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни) 4185 - } 4186 - ], 4187 - "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план. 4188 - "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана. 4189 - "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана. 4190 - }, 4191 - "Features": [ ~/~/ Набор услуг по тарифу клиента. 4192 - { 4193 - "Feature": "string", ~/~/ Код услуги. 4194 - "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга. 4195 - "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом. 4196 - "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту. 4197 - "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование. 4198 - "Price": 0, ~/~/ Цена за единицу. 4199 - "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу. 4200 - "PeriodValue": 0, ~/~/ Значение периода. 4201 - "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане. 4202 - "Quantity": 0 ~/~/ Количество использования услуги. 4203 - } 4204 - ] 4205 -} 4206 -))) 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 - Месяцы 4207 4207 4208 4208 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 4209 4209 ... ... @@ -5276,9 +5276,33 @@ 5276 5276 ))) 5277 5277 5278 5278 5220 +== **Удаление существующего поля** == 5221 + 5222 +(% class="box errormessage" %) 5279 5279 ((( 5224 +**DELETE /api/v3/agroLands/{id}** 5225 +))) 5226 + 5227 +Пример запроса: 5228 +id ~/~/ Идентификатор поля 5229 + 5230 +Пример ответа: 5231 + 5280 5280 ((( 5233 +200 ~/~/ Успех 5234 +))) 5235 + 5281 5281 ((( 5237 + 5238 +))) 5239 + 5240 +((( 5241 +((( 5242 +((( 5243 + 5244 +))) 5245 + 5246 +((( 5282 5282 == **Изменение поля** == 5283 5283 5284 5284 (% class="box infomessage" %) ... ... @@ -5524,102 +5524,9 @@ 5524 5524 "perimetr": 0, ~/~/ ериметр, м 5525 5525 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5526 5526 } 5527 - 5528 - 5529 -== **Какие поля посещал объект** == 5530 - 5531 -(% class="box successmessage" %) 5532 -((( 5533 -**POST /api/v3/agroLands/visitingByVehicle** 5534 5534 ))) 5535 5535 5536 -Пример запроса: 5537 5537 5538 -{ 5539 - "vehicleId": 0, ~/~/ id объекта 5540 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5541 - "byTime": 0, ~/~/ Объединение событий по времени 5542 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5543 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5544 - "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5545 - "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5546 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5547 -} 5548 - 5549 -Пример ответа: 5550 - 5551 -[ 5552 - { 5553 - "fieldId": 0, ~/~/ id объекта 5554 - "vehicleName": "string", ~/~/ Наименование объекта 5555 - "fieldName": "string", ~/~/ Наименование поля 5556 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5557 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5558 - "vehicleId": 0, ~/~/ Идентификатор ТС 5559 - "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5560 - "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5561 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5562 - "mileage": 0 ~/~/ Пробег 5563 - } 5564 -] 5565 -))) 5566 - 5567 - 5568 -== **Посещение поля объектами ** == 5569 - 5570 -(% class="box successmessage" %) 5571 -((( 5572 -**POST /api/v3/agroLands/visitingByField** 5573 -))) 5574 - 5575 -Пример запроса: 5576 -{ 5577 - "fieldId": 0, ~/~/ ID поля 5578 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5579 - "byTime": 0, ~/~/ Объединение событий по времени 5580 - "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5581 - "byDist": 0, ~/~/ Объединение событий по расстоянию 5582 - "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5583 - "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5584 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5585 -} 5586 - 5587 -Пример ответа: 5588 - 5589 -[ 5590 - { 5591 - "fieldId": 0, ~/~/ ID поля 5592 - "vehicleName": "string", ~/~/ Наименование объекта 5593 - "fieldName": "string", ~/~/ Имя поля 5594 - "fuelUsage": 0, ~/~/ Расход топлива, л/га 5595 - "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5596 - "vehicleId": 0, ~/~/ Идентификатор ТС 5597 - "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5598 - "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5599 - "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5600 - "mileage": 0 ~/~/ Пробег 5601 - } 5602 -] 5603 - 5604 - 5605 -== **Удаление существующего поля** == 5606 - 5607 -(% class="box errormessage" %) 5608 -((( 5609 -**DELETE /api/v3/agroLands/{id}** 5610 -))) 5611 - 5612 -Пример запроса: 5613 -id ~/~/ Идентификатор поля 5614 - 5615 -Пример ответа: 5616 - 5617 -((( 5618 -200 ~/~/ Успех 5619 - 5620 - 5621 -))) 5622 - 5623 5623 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5624 5624 ))) 5625 5625 ))) ... ... @@ -6103,14 +6103,14 @@ 6103 6103 = **Раздел: Локатор ** = 6104 6104 6105 6105 6106 -== **Получение данных покатору** ==5978 +== **Получение списка локаторов, доступных пользователю ** == 6107 6107 6108 6108 (% class="box infomessage" %) 6109 6109 ((( 6110 -**GET /api/v3/locators /{locatorId}**5982 +**GET /api/v3/locators ** 6111 6111 ))) 6112 6112 6113 -В за просе указываетсяlocatorid- идентификаторлокатора5985 +В заголовках запроса: X-Auth: Токен авторизации 6114 6114 6115 6115 6116 6116 Пример ответа: ... ... @@ -6118,13 +6118,13 @@ 6118 6118 ((( 6119 6119 ((( 6120 6120 { 6121 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую5993 + "vehiclesIds": [ ~/~/ Объекты 6122 6122 0 6123 6123 ], 6124 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую5996 + "geoIds": [ ~/~/ Геозоны 6125 6125 0 6126 6126 ], 6127 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую5999 + "fieldsIds": [ ~/~/ Поля 6128 6128 0 6129 6129 ], 6130 6130 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. ... ... @@ -6143,17 +6143,14 @@ 6143 6143 "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6144 6144 "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6145 6145 "url": "string", ~/~/ Ссылка 6146 - "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6147 - 6148 - "showVehicleName": true, ~/~/ Наименование объекта 6149 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6150 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6151 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6152 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6153 - "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ГИС) 6154 - 6155 - 1 6156 - 6018 + "language": 0, ~/~/ Язык 6019 + "showVehicleName": true, ~/~/ Наименование объекта 6020 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6021 + "allowTrackReport": true, ~/~/ Трек 6022 + "showTrackTracing": true, ~/~/ Трассировка трека 6023 + "showSensors": true, ~/~/ Датчик 6024 + "availableMapLayers": [ ~/~/ Слои на карте 6025 + 0 6157 6157 ] 6158 6158 } 6159 6159 ))) ... ... @@ -6160,9 +6160,38 @@ 6160 6160 ))) 6161 6161 6162 6162 6032 +== **Получение перечня моделей ** == 6033 + 6034 +(% class="box successmessage" %) 6163 6163 ((( 6036 +**POST /api/v3/models/find** 6037 +))) 6038 + 6039 +Пример запроса: 6040 + 6164 6164 ((( 6042 +((( 6043 +{ 6044 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6045 + "name": "string", ~/~/ Наименование локатора 6046 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6047 +))) 6048 + 6049 + 6050 + 6051 + Пример ответа: 6165 6165 6053 + 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 +] 6166 6166 ))) 6167 6167 ))) 6168 6168 ... ... @@ -6178,6 +6178,7 @@ 6178 6178 6179 6179 ((( 6180 6180 { 6079 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6181 6181 "isEnabled": true, ~/~/ Активность 6182 6182 "name": "string", ~/~/ Наименование локатора 6183 6183 "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) ... ... @@ -6184,28 +6184,26 @@ 6184 6184 "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6185 6185 "validity": 0, ~/~/ Срок действия в днях (1-90) 6186 6186 "autoProlongation": true, ~/~/ Автопродление срока действия. 6187 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6086 + "url": "string", ~/~/ Ссылка 6087 + "language": 0 ~/~/ Язык 6188 6188 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6189 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую6089 + "vehiclesIds": [ ~/~/ Oбъекты 6190 6190 0 6191 6191 ], 6192 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6092 + "geoIds": [ ~/~/ Геозоны 6193 6193 0 6194 6194 ], 6195 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6095 + "fieldsIds": [ ~/~/ Поля 6196 6196 0 6197 6197 ], 6198 - 6199 - "showVehicleName": true, ~/~/ Наименование объекта 6200 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6201 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6202 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6203 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6204 - "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ГИС) 6205 - 6206 - 1 6207 - 6208 - ] 6098 + "showVehicleName": true, ~/~/ Наименование объекта 6099 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6100 + "allowTrackReport": true, ~/~/ Трек 6101 + "showTrackTracing": true, ~/~/ Трассировка трека 6102 + "showSensors": true, ~/~/ Датчик 6103 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6104 + 0 6105 + ] 6209 6209 } 6210 6210 ))) 6211 6211 ... ... @@ -6217,69 +6217,7 @@ 6217 6217 ))) 6218 6218 6219 6219 6220 -== **Выводит список локаторов ** == 6221 6221 6222 -(% class="box successmessage" %) 6223 -((( 6224 -**POST /api/v3/locators/find** 6225 -))) 6226 - 6227 -Пример запроса: 6228 - 6229 -((( 6230 -{ 6231 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6232 -} 6233 -))) 6234 - 6235 -((( 6236 - 6237 -))) 6238 - 6239 -((( 6240 - 6241 -))) 6242 - 6243 - 6244 -Пример ответа: 6245 - 6246 -((( 6247 -[ 6248 - { 6249 - "vehiclesCount": 0, ~/~/ Количество объектов. 6250 - "geozonesCount": 0, ~/~/ Количество геозон. 6251 - "fieldsCount": 0, ~/~/ Количество полей. 6252 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6253 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6254 - "agentName": "string", ~/~/ Наименование агента. 6255 - "isEnabled": true, ~/~/ Активность локатора 6256 - "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6257 - "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6258 - "name": "string", ~/~/ Наименование локатора 6259 - "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6260 - "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6261 - "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6262 - "validity": 0, ~/~/ Срок действия в днях (1-90) 6263 - "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6264 - "autoProlongation": true, ~/~/ Автоматическая пролонгация 6265 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6266 - "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6267 - "url": "string", ~/~/ ссылка на локатор 6268 - "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6269 - "showVehicleName": true, ~/~/ Наименование объекта 6270 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6271 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6272 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6273 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6274 - "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ГИС) 6275 - 6276 - 0 6277 - ] 6278 - } 6279 -] 6280 -))) 6281 - 6282 - 6283 6283 == **Изменение локатора** == 6284 6284 6285 6285 (% class="box infomessage" %) ... ... @@ -6298,25 +6298,25 @@ 6298 6298 "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6299 6299 "validity": 0, ~/~/ Срок действия в днях (1-90) 6300 6300 "autoProlongation": true, ~/~/ Автопродление срока действия 6301 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6302 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6136 + "url": "string", ~/~/ Ссылка 6137 + "language": 0 ~/~/ Язык 6138 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6139 + "vehiclesIds": [ ~/~/ Oбъекты 6303 6303 0 6304 6304 ], 6305 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6142 + "geoIds": [ ~/~/ Геозоны 6306 6306 0 6307 6307 ], 6308 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6145 + "fieldsIds": [ ~/~/ Поля 6309 6309 0 6310 6310 ], 6311 6311 "showVehicleName": true, ~/~/ Наименование объекта 6312 - "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6313 - "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6314 - "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6315 - "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6316 - "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ГИС) 6317 - 6149 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6150 + "allowTrackReport": true, ~/~/ Трек 6151 + "showTrackTracing": true, ~/~/ Трассировка трека 6152 + "showSensors": true, ~/~/ Датчик 6153 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6318 6318 0 6319 - 6320 6320 ] 6321 6321 } 6322 6322 ... ... @@ -6344,6 +6344,7 @@ 6344 6344 ))) 6345 6345 6346 6346 6182 + 6347 6347 = **Раздел: Яндекс Маршруты** = 6348 6348 6349 6349 ... ... @@ -6357,6 +6357,7 @@ 6357 6357 Пример запроса: 6358 6358 Id ~/~/ Идентификатор поля 6359 6359 6196 + 6360 6360 Пример ответа: 6361 6361 6362 6362 ((( ... ... @@ -6374,6 +6374,7 @@ 6374 6374 ))) 6375 6375 6376 6376 6214 + 6377 6377 == **Добавить маршрут** == 6378 6378 6379 6379 (% class="box infomessage" %) ... ... @@ -6428,6 +6428,7 @@ 6428 6428 } 6429 6429 ))) 6430 6430 6269 + 6431 6431 Пример ответа: 6432 6432 6433 6433 ((( ... ... @@ -6458,6 +6458,7 @@ 6458 6458 ] 6459 6459 ))) 6460 6460 6300 + 6461 6461 Пример ответа: 6462 6462 6463 6463 ((( ... ... @@ -6481,6 +6481,7 @@ 6481 6481 Id ~/~/ Идентификатор поля 6482 6482 6483 6483 6324 + 6484 6484 = **Раздел: Управление доступа к машинам** = 6485 6485 6486 6486 ... ... @@ -6502,6 +6502,7 @@ 6502 6502 ))) 6503 6503 6504 6504 6346 + 6505 6505 == Задает видимость транспортных средств пользователю == 6506 6506 6507 6507 (% class="box infomessage" %) ... ... @@ -6526,6 +6526,10 @@ 6526 6526 ))) 6527 6527 6528 6528 ((( 6371 + 6372 +))) 6373 + 6374 +((( 6529 6529 Пример ответа : 6530 6530 ))) 6531 6531 ... ... @@ -6539,6 +6539,10 @@ 6539 6539 ))) 6540 6540 6541 6541 6388 + 6389 + 6390 + 6391 + 6542 6542 (% class="box" lang="en-US" style="text-align: center;" %) 6543 6543 ((( 6544 6544 (% 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]] **