Changes for page Методы API для работы с ГЛОНАССSoft

Last modified by Андрей Калиновский on 2025/09/03 15:30

From version < 259.1

edited by Андрей Калиновский
on 2025/09/03 15:30

To version < 219.1 >

edited by Андрей Калиновский
on 2025/04/21 14:04

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -287,6 +287,28 @@
    "bankKS": "string" ~/~/ корр. счёт
  }
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента
++|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя
++|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя
++|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента
++|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента
++|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)
++|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент
++|(% style="width:215px" %)district|(% style="width:861px" %)Округ
++|(% style="width:215px" %)region|(% style="width:861px" %)Регион
++|(% style="width:215px" %)city|(% style="width:861px" %)Город
++|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента
++|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента
++|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес
++|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес
++|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта
++|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя
++|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк
++|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК
++|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета
++|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет
++
  == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) ==
  (% class="box warningmessage" %)
@@ -432,7 +432,7 @@
      [
         "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей
      ],
--    "language": 1 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
++    "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
  }
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
@@ -744,11 +744,6 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
--(% class="wikigeneratedid" id="H" %)
--(((
--
--)))
--
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) =
  == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) ==
@@ -860,7 +860,7 @@
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
--  "deleted": false,
++  "deleted": true,
    "extId": "string",
    "name": "string",
    "picture": "string",
@@ -879,7 +879,7 @@
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
--  "deleted": false,
++  "deleted": true,
    "extId": "string",
    "name": "string",
    "picture": "string",
@@ -913,7 +913,7 @@
  (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models**
  )))
--(% style="color:#000000" %)Метод позволяет изменить статус модели, указанного в запросе.
++(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе.
  (% style="color:#000000" %)Метод запроса: **PUT**
@@ -980,7 +980,7 @@
  (% lang="en-US" %)**DELETE /api/v3/models/{Id}**
  )))
--(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалить модель, указанного в строке запроса.
++(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса.
  (% style="color:#000000" %)Метод запроса: **DELETE**
@@ -1611,6 +1611,77 @@
  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
++== **Импортировать историю ТС (Асинхронный запрос)** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
++)))
++
++Метод запроса: **POST**
++
++URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
++
++Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
++
++
++Ответ:
++
++{
++
++  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
++
++  "Status": 0, ~/~/ Перечисление состояний выполнения запроса
++
++~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
++
++  "Message": "string", ~/~/ Информация о выполнении запроса
++
++  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
++
++  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
++
++  "Data": "string" ~/~/ Данные
++
++}
++
++
++== **Возвращает статус асинхронного запроса импорта истории ТС** ==
++
++(% class="box infomessage" %)
++(((
++**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
++)))
++
++Метод запроса: **GET**
++
++URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
++
++Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
++
++
++Ответ:
++
++{
++
++  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
++
++  "Status": 0, ~/~/ Перечисление состояний выполения запроса
++~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
++
++  "Message": "string", ~/~/ Информация о выполнении запроса
++
++  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
++
++~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
++
++  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
++
++  "Data": "string" ~/~/ Данные
++
++}
++
++
  == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) ==
  (% class="box infomessage" %)
@@ -1756,6 +1756,7 @@
    "stage": "", ~/~/ Состояние
  (% style="color:#000000" %)  }
++==   ==
  == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==
@@ -2372,7 +2372,7 @@
  Тело запроса:
  {
--  "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
++  "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
    "vehicleIds": [0], ~/~/ Список ID объектов
    "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода
    "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода
@@ -2419,7 +2419,7 @@
  Тело запроса:
  {
--  "sampling": 86400, ~/~/ Частота дискретизации, секунд, минимум - 60 (если передано, то весь период бъётся на подпериоды с указанной частотой)
++  "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
    "vehicleIds": [0], ~/~/ Список ID объектов
    "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода
    "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода
@@ -2438,8 +2438,6 @@
          "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание
          "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода
          "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода
--        "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода
--        "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода
          "fuelConsumption": 0, ~/~/ Расход топлива
          "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении
           "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне
@@ -2569,241 +2569,194 @@
  В заголовках запроса: X-Auth: Токен авторизации
--В массиве указываем id объектов через запятую
++В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую.
  Ответ:
--
--[
    {
--    "vehicleId": 55728, ~/~/ Идентификатор объекта
--    "vehicleGuid": "fa9c0357-9b9f-44b9-a89c-20a2cb80a9ad", ~/~/ Guid объекта
--    "vehicleNumber": "0105 КМ", ~/~/ Номер объекта
--    "receiveTime": "2025-06-27T12:37:46.7782735Z", ~/~/ Время и дата поступления данных
--    "recordTime": "2025-06-27T12:37:19Z", ~/~/ Время и дата формирование данных
--    "state": 4, ~/~/ Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
--    "speed": 31, ~/~/ Скорость объекта
--    "course": 116, ~/~/ Курс движения [0;360]
--    "latitude": 45.722128, ~/~/ Широта [-90°;90°].
--    "longitude": 39.800432, ~/~/ Долгота [-180°;180°].
--    "address": "\"   Краснодарский край Россия 45,722128°, 39,800432°\"", ~/~/ Адрес
--    "geozones": [ ~/~/ Сведения по геозонам.
++    "vehicleId": 0, ~/~/Идентификатор объекта.
++    "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта.
++    "vehicleNumber": "string",~/~/Номер объекта.
++    "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер
++    "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве.
++    "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
++    "speed": 0,~/~/Скорость объекта.
++    "course": 0,~/~/Курс движения [0;360]
++    "latitude": 0,~/~/Широта [-90°;90°].
++    "longitude": 0,~/~/Долгота [-180°;180°].
++    "address": "string",~/~/Адрес.
++    "geozones": [ ~/~/Сведения по геозонам.
        {
--        "id": 10225647, ~/~/ ID Геозоны
--        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
--      },
--      {
--        "id": 10282875, ~/~/ ID Геозоны
--        "name": "Ё2" ~/~/ Наименование геозоны
--      },
--      {
--        "id": 10226240, ~/~/ ID Геозоны
--        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
--      },
--      {
--        "id": 9747869, ~/~/ ID Геозоны
--        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
--      },
--      {
--        "id": 10221123, ~/~/ ID Геозоны
--        "name": "53r" ~/~/ Наименование геозоны
--      },
--      {
--        "id": 10197638, ~/~/ ID Геозоны
--        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
++        "id": 0,
++        "name": "string"
        }
--    ]
--  }
--=   =
++= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =
--= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =
++== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) ==
--== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==
--
  (% class="box infomessage" %)
  (((
--**POST /api/v3/notifications/find**
++(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find**
  )))
--Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии.
++(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них.
--(% style="text-align: left;" %)
--Метод запроса **POST**
++(% style="color:#000000" %)Метод запроса: **POST**
--(% style="text-align: left;" %)
--(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find
++(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find
--(% style="text-align: left;" %)
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++(% style="text-align:left" %)
++Тело запроса:
++
++(% style="text-align:left" %)
  {
--  "parentId": "" ~/~/ id клиента
++  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
++(% style="text-align:left" %)
  Ответ:
  [
    {
--    "id": 0, ~/~/ ID уведомления
--    "name": "string", ~/~/ Название уведомления
--    "active": true, ~/~/ Состояние true - активен, false - деактивирован
--    "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя)
--    "userId": "", ~/~/ Пользователь, создавший уведомление
--    "parentId": "", ~/~/ Идентификатор клиента
--    "parentName": "string" ~/~/ Имя клиента
++    "id": 0, ~/~/ Идентификатор объекта геозоны
++    "name": "string", ~/~/ Название объекта геозоны
++    "type": 0, ~/~/ Тип объекта геозоны
++    "fname": "string", ~/~/ Имя файла
++    "parentId": "string", ~/~/ Идентификатор клиента
++    "radius": 0, ~/~/ Радиус геообъекта
++    "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета
++    "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета
++    "description": "string", ~/~/ Описание
++    "area": 0, ~/~/ Площадь, м^^2^^
++    "perimetr": 0, ~/~/ Периметр, м
++    "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания
    }
  ]
++== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) ==
--== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) ==
--
  (% class="box infomessage" %)
  (((
--**POST /api/v3/notifications**
++(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles**
  )))
--Метод запроса **POST**
++(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период.
--(% style="text-align: left;" %)
--(% style="color:#000000" %)Пример запроса
++(% style="color:#000000" %)Метод запроса: **POST**
--(((
++(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles
++
++(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++
++(% style="text-align:left" %)
++Тело запроса:
++
  {
--  "id": 0, ~/~/ ID правила
--  "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя
--  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "name": "string", ~/~/ Имя правила
--  "active": true, ~/~/ Активность правила
--  "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто
--  "vehicleGroups": [ ~/~/ Список групп объектов для анализа.
--    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/
--  ],
--  "vehicleIds": [ ~/~/ Список объектов для анализа.
--    0
--  ],
--  "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам.
--    0
--  ],
--  "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам.
--    0
--  ],
--  "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений.
--    "additionalProp1": "string",
--    "additionalProp2": "string",
--    "additionalProp3": "string"
--  },
--  "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы"
--  "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила
--    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
--  ],
--  "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям"
--  "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений
--    "string"
--  ],
--  "toTelegram": true, ~/~/ Флаг активности отправки в Telegram
--  "telegrams": [ ~/~/ Список получателя уведомлений в Telegram.
--    {
--      "id": 0, ~/~/ Идентификатор участника чата.
--      "info": "string" ~/~/ Дополнительные сведения.
--    }
--  ],
--  "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение
--  "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы
--  "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений.
--  "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение)
--  "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени)
--  "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC)
--  "timezone": 0, ~/~/ часовой пояс
--  "validity": 0, ~/~/ Срок действия в днях (1-90).
--  "autoProlongation": true, ~/~/ Автопродление срока действия.
--  "templates": [ ~/~/  Переопределения шаблонов уведомлений.
--    {
--      "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 - Срок действия правила истек
--      "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа.
--      "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка.
--        "additionalProp1": "string",
--        "additionalProp2": "string",
--        "additionalProp3": "string"
--      }
--    }
--  ]
++  "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса
++  "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания
++  "ids": [ ], ~/~/ Массив id объектов
++  "byTime": 0, ~/~/ Объединение событий по времени
++  "byDist": 0, ~/~/ Объединение событий по расстоянию
++  "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
++  "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра
  }
--)))
++Ответ:
++[
++  {
++    "geozoneId": 0, ~/~/ ID геообъекта
++    "geozoneName": "string", ~/~/ Название геообъекта
++    "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда
++    "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда
++    "duration": 0, ~/~/ Продолжительность нахождения в геообъекте
++    "vehicleId": 0, ~/~/ ID объекта
++    "vehicleName": "string" ~/~/ Имя объекта
++  }
++]
++
++== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) ==
++
++(% class="box infomessage" %)
  (((
--
++(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones**
  )))
++(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период.
++
++(% style="color:#000000" %)Метод запроса: **POST**
++
++(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones
++
++(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++
++(% style="text-align:left" %)
++Тело запроса:
++
++{
++  "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса
++  "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания
++  "ids": [ ], ~/~/ Массив id геообъектов
++  "byTime": 0, ~/~/ Объединение событий по времени
++  "byDist": 0, ~/~/ Объединение событий по расстоянию
++  "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
++  "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра
++}
++
++Ответ:
++
++[
++  {
++    "geozoneId": 0, ~/~/ ID геообъекта
++    "geozoneName": "string", ~/~/ Название геообъекта
++    "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда
++    "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда
++    "duration": 0, ~/~/ Продолжительность нахождения в геообъекте
++    "vehicleId": 0, ~/~/ ID объекта
++    "vehicleName": "string" ~/~/ Имя объекта
++  }
++]
++
++= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) =
++
++== (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==
++
++(% class="box infomessage" %)
  (((
--
++**POST /api/v3/notifications/find**
  )))
--Ответ:
++Метод возвращает информацию об уведомлениях переданного клиента и его клиентов ниже по иерархии.
++(% style="text-align: left;" %)
++Метод запроса **POST**
++
++(% style="text-align: left;" %)
++(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/notifications/find
++
++(% style="text-align: left;" %)
++(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++
  {
--  "id": 0, ~/~/ ID правила
--  "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя
--  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Пользователь, создавший правило
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "name": "string", ~/~/ Имя правила
--  "active": true, ~/~/ Активность правила
--  "vehicleSource": 0, ~/~/ Определяет вид источника объектов для анализа. Если значение равно 0, то объекты. Если значение равно 1, то группы объекто
--  "vehicleGroups": [ ~/~/ Список групп объектов для анализа.
--    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/
--  ],
--  "vehicleIds": [ ~/~/ Список объектов для анализа.
--    0
--  ],
--  "geoids": [ ~/~/ Список идентификаторов гео-объектов, в которых проводить анализ по объектам.
--    0
--  ],
--  "fieldids": [ ~/~/ Список идентификаторов полей, в которых проводить анализ по объектам.
--    0
--  ],
--  "settings": { ~/~/ Определяет класс расширенных параметров правила уведомлений.
--    "additionalProp1": "string",
--    "additionalProp2": "string",
--    "additionalProp3": "string"
--  },
--  "toEmail": true, ~/~/ Флаг, что активна настройка "Отправка уведомлений на эл. почту пользователям системы"
--  "recipientIds": [ ~/~/ Список Guid пользователей, которым надо отправить сообщение на почту при срабатывании правила
--    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
--  ],
--  "enableSideEmails": true, ~/~/ Флаг, что активна настройка "Отправка сообщений на эл. почту сторонним пользователям"
--  "sideEmails": [ ~/~/ Список электронных адресов для отсылки уведомлений
--    "string"
--  ],
--  "toTelegram": true, ~/~/ Флаг активности отправки в Telegram
--  "telegrams": [ ~/~/ Список получателя уведомлений в Telegram.
--    {
--      "id": 0, ~/~/ Идентификатор участника чата.
--      "info": "string" ~/~/ Дополнительные сведения.
--    }
--  ],
--  "toMobile": true, ~/~/ Флаг активности отправки в мобильное приложение
--  "toClient": true, ~/~/ Флаг активности отправки в интерфейсе системы
--  "stored": true, ~/~/ Определяет необходимость сохранять уведомления, производные от этого правила, в журнале истории уведомлений.
--  "kind": 0, ~/~/ Определяет вид уведомления (0 - Информация, 1 - Подтверждение)
--  "activationMode": 0, ~/~/ Вид активации правила (0 - сейчас, 1 - ко времени)
--  "activationTime": "2025-06-09T13:21:13.669Z", ~/~/ Дата/время активации правила (UTC)
--  "timezone": 0, ~/~/ часовой пояс
--  "validity": 0, ~/~/ Срок действия в днях (1-90).
--  "autoProlongation": true, ~/~/ Автопродление срока действия.
--  "templates": [ ~/~/  Переопределения шаблонов уведомлений.
--    {
--      "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 - Срок действия правила истек
--      "override": true, ~/~/ Определяет необходимость переопределения шаблона уведомления определенного типа.
--      "parameters": { ~/~/ Определяет параметры шаблона уведомлений. "subject" и "textcontent" определяют тему и тело сообщения по умолчанию, "subject_{langid}" и "textcontent_{langid}" определяет тему и тело сообщения для определенного языка, где langid - идентификатор языка.
--        "additionalProp1": "string",
--        "additionalProp2": "string",
--        "additionalProp3": "string"
--      }
--    }
--  ]
++  "parentId": "" ~/~/ id клиента
  }
++Ответ:
++
++[
++  {
++    "id": 0, ~/~/ ID уведомления
++    "name": "string", ~/~/ Название уведомления
++    "active": true, ~/~/ Состояние true - активен, false - деактивирован
++    "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО
++    "userId": "", ~/~/ Пользователь, создавший уведомление
++    "parentId": "", ~/~/ Идентификатор клиента
++    "parentName": "string" ~/~/ Имя клиента
++  }
++]
++
  == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) ==
  (% class="box infomessage" %)
@@ -4021,12 +4021,16 @@
  Тело запроса:
  {
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "Balance": 0 ~/~/ Значение баланса.
++  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++  "Balance": 0
  }
  Ответ: Success
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
++|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
++
  == (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) ==
  (% class="box warningmessage" %)
@@ -4038,29 +4038,16 @@
  Тело запроса:
--(((
  {
--  "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "amount": 0 ~/~/ Сумма пополнения баланса
++  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++  "Balance": 0
  }
--)))
--(((
--
--)))
--
  Ответ: Success
--(((
--{
--  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки.
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя.
--  "Moment": "2025-06-10T12:15:19.076Z", ~/~/ Время корректировки.
--  "Amount": 0, ~/~/ Значение, на которое корректируется баланс.
--  "Description": "string" ~/~/ Описание корректировки.
--}
--)))
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
++|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
  == (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) ==
@@ -4073,25 +4073,16 @@
  Тело запроса:
--(((
  {
--  "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "amount": 0 ~/~/ Сумма списания с баланса
++  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++  "Balance": 0
  }
--)))
  Ответ: Success
--(((
--{
--  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор корректировки.
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя.
--  "Moment": "2025-06-10T12:21:05.149Z", ~/~/ Время корректировки.
--  "Amount": 0, ~/~/ Значение, на которое корректируется баланс.
--  "Description": "string" ~/~/ Описание корректировки
--}
--)))
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента
++|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса
  == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) ==
@@ -4102,35 +4102,28 @@
  Тело запроса:
--(((
  {
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни
--  "PermissibleBalance": 0, ~/~/ Допустимый баланс
--  "DefermentDays": 0, ~/~/ Отсрочка (дни).
--  "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено
--  "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено
++  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++  "CalculationType": 0,
++  "PermissibleBalance": 0,
++  "DefermentDays": 0,
++  "SendUiNotifications": true,
++  "SendEmailNotifications": true,
++  "IsPrivate": true,
  }
--)))
--(((
--
--)))
--
  Ответ: Success
--(((
--{
--  "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом
--  "BlockingTime": "2025-06-10T12:23:28.754Z", ~/~/ Время, когда заблокируется клиент.
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни
--  "PermissibleBalance": 0, ~/~/ Допустимый баланс.
--  "DefermentDays": 0, ~/~/ Отсрочка (дни)
--  "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено
--  "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено
--}
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|ClientId|Идентификатор клиента
++|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни
++|PermissibleBalance|Допустимый баланс
++|DefermentDays|(((
++Отсрочка, количество дней
  )))
++|(% style="width:215px" %)SendUiNotifications|(% style="width:861px" %)Оповещение в web-интерфейсе, true - включено, false - выключено
++|(% style="width:215px" %)SendEmailNotifications|(% style="width:861px" %)Оповещение на почту, true - включено, false - выключено
++|(% style="width:215px" %)IsPrivate|(% style="width:861px" %)Признак, определяющий, являются ли параметры ограничений частными т.е. персональными для клиента, либо определяются тарифным планом
  == (% style="color:#000000; font-size:16px" %)**Изменить тариф клиента**(%%) ==
@@ -4142,68 +4142,35 @@
  Тело запроса:
  {
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор клиента.
--  "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.
--  "Features": [ ~/~/ Набор услуг по тарифу клиента.
++  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++  "PlanId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
++  "Features": [
      {
--      "Feature": "string", ~/~/ Код услуги.
--      "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.
--      "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.
--      "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование
--      "Price": 0, ~/~/ Цена за единицу.
--      "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.
--      "PeriodValue": 0, ~/~/ Значение периода.
--      "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)
++      "Feature": "string",
++      "IsEnabled": true,
++      "IsFactual": true,
++      "Limit": 0,
++      "Price": 0,
++      "DebitDate": "2023-10-18T13:26:58.987Z",
++      "PeriodValue": 0,
++      "PeriodType": 0
      }
    ]
  }
--
  Ответ: Success
--(((
--{
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "Plan": { ~/~/ Определяет тарифный план (шаблон услуг)
--    "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор тарифного плана.
--    "OwnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента-владельца.
--    "Name": "string", ~/~/ Наименование.
--    "IsArchived": true, ~/~/ Признак, определяющий архивный тарифный план.
--    "Constraint": { ~/~/ Ограничения по тарифу
--      "CalculationType": 0, ~/~/ Определяет тип расчёта (0 - деньги, 1 - дни)
--      "PermissibleBalance": 0, ~/~/ Допустимый баланс.
--      "DefermentDays": 0 ~/~/ Отсрочка (дни)
--    },
--    "Features": [ ~/~/ Набор услуг по тарифному плану.
--      {
--        "Feature": "string", ~/~/Код услуги.
--        "IsFactual": true, ~/~/ Признак, определяющий возможность расчёта по факту.
--        "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование.
--        "Price": 0, ~/~/ Цена за единицу.
--        "PeriodValue": 0, ~/~/ Значение периода.
--        "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане. (0 - деньги, 1 - дни)
--      }
--    ],
--    "UserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, создавшего тарифный план.
--    "Created": "2025-06-10T12:29:32.969Z", ~/~/ Дата создания тарифного плана.
--    "Deactivated": "2025-06-10T12:29:32.969Z" ~/~/ Дата деактивации тарифного плана.
--  },
--  "Features": [ ~/~/ Набор услуг по тарифу клиента.
--    {
--      "Feature": "string", ~/~/ Код услуги.
--      "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.
--      "IsPrivate": true, ~/~/ Признак, определяющий, являются ли параметры по услуге тарифа частными т.е. персональными для клиента, либо определяются тарифным планом.
--      "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.
--      "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование.
--      "Price": 0, ~/~/ Цена за единицу.
--      "DebitDate": "2025-06-10T12:29:32.969Z", ~/~/ Следующий момент времени списания с баланса за услугу.
--      "PeriodValue": 0, ~/~/ Значение периода.
--      "PeriodType": 0, ~/~/ Определяет тип периода действия услуги в тарифном плане.
--      "Quantity": 0 ~/~/ Количество использования услуги.
--    }
--  ]
--}
--)))
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|ClientId|Идентификатор клиента
++|PlanId|Идентификатор тарифного плана
++|Feature|Код услуги
++|IsEnabled|Признак, определяющий активирована ли услуга
++|IsFactual|Признак, определяющий расчёт по факту
++|Limit|Лимит использования услуги. Значение -1 подразумевает безлимитное использование.
++|Price|Цена за единицу.
++|DebitDate|Следующий момент времени списания с баланса за услугу.
++|PeriodValue|Значение периода.
++|PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) =
@@ -4308,43 +4308,6 @@
  |producedCount|Кол-во успешно отправленных в шину данных сообщений
  |msgCount|Кол-во обработанных сообщений всего
--== **Импортировать историю ТС (Асинхронный запрос)** ==
--
--(% class="box successmessage" %)
--(((
--**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
--)))
--
--При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
--
--Метод запроса: **POST**
--
--URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
--
--Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
--
--
--Ответ:
--
--{
--
--  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
--
--  "Status": 0, ~/~/ Перечисление состояний выполнения запроса
--
--~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
--
--  "Message": "string", ~/~/ Информация о выполнении запроса
--
--  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
--
--  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
--
--  "Data": "string" ~/~/ Данные
--
--}
--
--
  == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) ==
  (% class="box infomessage" %)
@@ -4362,59 +4362,10 @@
    "message": "string"
  }
--|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)(((
--**Параметр**
--)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)(((
--**Описание**
--)))
--|(((
--activity
--)))|(((
--Активен ли экспорт/импорт истории сейчас, true - да, false - нет
--)))
--|(((
--progress
--)))|(((
--Guid ТС
--)))
++|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
++|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет
++|progress|Guid ТС
--== **Возвращает статус асинхронного запроса импорта истории ТС** ==
--
--(% class="box infomessage" %)
--(((
--**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
--)))
--
--При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос.
--
--Метод запроса: **GET**
--
--URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
--
--Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
--
--
--Ответ:
--
--{
--
--  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
--
--  "Status": 0, ~/~/ Перечисление состояний выполения запроса
--~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
--
--  "Message": "string", ~/~/ Информация о выполнении запроса
--
--  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
--
--~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
--
--  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
--
--  "Data": "string" ~/~/ Данные
--
--}
--
  == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) ==
  (% class="box infomessage" %)
@@ -4945,7 +4945,7 @@
    "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента)
    "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента)
    "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
--  "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный )
++  "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение; 2-фиксированный;)
  }
  )))
@@ -5276,9 +5276,33 @@
  )))
++== **Удаление существующего поля** ==
++
++(% class="box errormessage" %)
  (((
++**DELETE /api/v3/agroLands/{id}**
++)))
++
++Пример запроса:
++id  ~/~/ Идентификатор поля
++
++Пример ответа:
++
  (((
++200 ~/~/ Успех
++)))
++
  (((
++
++)))
++
++(((
++(((
++(((
++
++)))
++
++(((
  == **Изменение поля** ==
  (% class="box infomessage" %)
@@ -5524,102 +5524,9 @@
    "perimetr": 0, ~/~/ ериметр, м
    "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
  }
--
--
--== **Какие поля посещал объект** ==
--
--(% class="box successmessage" %)
--(((
--**POST /api/v3/agroLands/visitingByVehicle**
  )))
--Пример запроса:
--{
--  "vehicleId": 0, ~/~/ id объекта
--  "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
--  "byTime": 0, ~/~/ Объединение событий по времени
--  "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
--  "byDist": 0, ~/~/ Объединение событий по расстоянию
--  "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента)
--  "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента)
--  "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK
--}
--
--Пример ответа:
--
--[
--  {
--    "fieldId": 0, ~/~/ id объекта
--    "vehicleName": "string", ~/~/ Наименование объекта
--    "fieldName": "string", ~/~/ Наименование поля
--    "fuelUsage": 0, ~/~/ Расход топлива, л/га
--    "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата)
--    "vehicleId": 0, ~/~/ Идентификатор ТС
--    "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения
--    "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения
--    "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля
--    "mileage": 0 ~/~/ Пробег
--  }
--]
--)))
--
--
--== **Посещение поля объектами ** ==
--
--(% class="box successmessage" %)
--(((
--**POST /api/v3/agroLands/visitingByField**
--)))
--
--Пример запроса:
--{
--  "fieldId": 0, ~/~/ ID поля
--  "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
--  "byTime": 0, ~/~/ Объединение событий по времени
--  "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
--  "byDist": 0, ~/~/ Объединение событий по расстоянию
--  "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента)
--  "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента)
--  "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK
--}
--
--Пример ответа:
--
--[
--  {
--    "fieldId": 0, ~/~/ ID поля
--    "vehicleName": "string", ~/~/ Наименование объекта
--    "fieldName": "string", ~/~/ Имя поля
--    "fuelUsage": 0, ~/~/ Расход топлива, л/га
--    "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата)
--    "vehicleId": 0, ~/~/ Идентификатор ТС
--    "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения
--    "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения
--    "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля
--    "mileage": 0 ~/~/ Пробег
--  }
--]
--
--
--== **Удаление существующего поля** ==
--
--(% class="box errormessage" %)
--(((
--**DELETE /api/v3/agroLands/{id}**
--)))
--
--Пример запроса:
--id  ~/~/ Идентификатор поля
--
--Пример ответа:
--
--(((
--200 ~/~/ Успех
--
--
--)))
--
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
  )))
  )))
@@ -6044,129 +6044,49 @@
  )))
--= **Раздел: Роли** =
--
--== **Получение списка клиентских и системных ролей пользователя ** ==
--
--(% class="box successmessage" %)
--(((
--**POST /api/v3/groups/find**
--)))
--
--Пример запроса:
--
--(((
--{
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли
--  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей
--}
--)))
--
--(((
--
--)))
--
--(((
--Пример ответа:
--)))
--
--(((
--(((
--{
--  "groups": [  ~/~/ Системные роли пользователя
--    {
--      "code": "string", ~/~/ Код роли.
--      "name": "string", ~/~/ Имя
--      "shortName": "string" ~/~/ Короткое имя
--    }
--  ],
--  "customGroups": [ ~/~/ Системные роли пользователя
--    {
--      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли.
--      "name": "string", ~/~/ Наименование
--      "shortName": "string", ~/~/ Короткое наименование
--      "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца
--    }
--  ]
--}
--)))
--)))
--
--(((
--
--)))
--
--(((
--
--)))
--
  = **Раздел: Локатор ** =
--== **Получение данных по локатору** ==
++== **Получение списка локаторов, доступных пользователю ** ==
  (% class="box infomessage" %)
  (((
--**GET /api/v3/locators/{locatorId}**
++**GET /api/v3/locators**
  )))
--В запросе указывается locatorid - идентификатор локатора
++В заголовках запроса: X-Auth: Токен авторизации
  Пример ответа:
  (((
--(((
--{
--  "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора.
--  "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
--  "agentName": "string", ~/~/ Наименование агента.
--  "isEnabled": true, ~/~/ Активность
--  "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания
--  "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления
--  "name": "string", ~/~/ Наименование.
--  "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный)
--  "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время)
--  "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации
--  "validity": 0, ~/~/ Значение срока действия
--  "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2)
--  "autoProlongation": true, ~/~/ Автопродление срока действия.
--  "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
--  "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
--  "url": "string", ~/~/ Ссылка
--  "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
--
-- "showVehicleName": true, ~/~/ Наименование объекта
--    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
--    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
--    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
--    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
--    "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ГИС)
--
--  1
--
--  ]
--}
++[
++  {
++    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор локатора.
++    "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
++    "agentName": "string", ~/~/ Наименование агента.
++    "isEnabled": true, ~/~/ Активен
++    "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания
++    "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления
++    "name": "string", ~/~/ Наименование
++    "status": 0, ~/~/
++    "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный)
++    "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации)
++    "validity": 0, ~/~/ Срок действия в днях (1-90).
++    "autoProlongation": true, ~/~/ Автопродление срока действия.
++    "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
++    "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
++    "url": "string", ~/~/ Ссылка
++    "language": 0, ~/~/ Язык.
++    "vehiclesCount": 0, ~/~/ Количество объектов.
++    "geozonesCount": 0, ~/~/ Количество геозон.
++    "fieldsCount": 0 ~/~/ Количество полей.
++  }
++]
  )))
--)))
--(((
--(((
--
--)))
--)))
--
  == **Создание локатора** ==
  (% class="box successmessage" %)
@@ -6178,6 +6178,7 @@
  (((
  {
++  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
    "isEnabled": true, ~/~/ Активность
    "name": "string", ~/~/ Наименование локатора
    "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени)
@@ -6184,28 +6184,8 @@
    "activationTime": "2025-03-12T07:00:08.272Z", ~/~/  Время активации
    "validity": 0, ~/~/ Срок действия в днях (1-90)
    "autoProlongation": true, ~/~/ Автопродление срока действия.
--  "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую
--    0
--  ],
--
-- "showVehicleName": true, ~/~/ Наименование объекта
--    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
--    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
--    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
--    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
--    "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ГИС)
--
--    1
--
--      ]
++  "url": "string", ~/~/ Ссылка
++  "language": 0 ~/~/ Язык
  }
  )))
@@ -6217,69 +6217,7 @@
  )))
--== **Выводит список локаторов ** ==
--(% class="box successmessage" %)
--(((
--**POST /api/v3/locators/find**
--)))
--
--Пример запроса:
--
--(((
--{
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента
--}
--)))
--
--(((
--
--)))
--
--(((
--
--)))
--
--
--Пример ответа:
--
--(((
--[
--  {
--    "vehiclesCount": 0, ~/~/ Количество объектов.
--    "geozonesCount": 0, ~/~/ Количество геозон.
--    "fieldsCount": 0, ~/~/ Количество полей.
--    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора.
--    "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
--    "agentName": "string", ~/~/ Наименование агента.
--    "isEnabled": true, ~/~/ Активность локатора
--    "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания
--    "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления
--    "name": "string", ~/~/ Наименование локатора
--    "status": 0,   ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный)
--    "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени )
--    "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC)
--    "validity": 0, ~/~/ Срок действия в днях (1-90)
--    "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2)
--    "autoProlongation": true, ~/~/ Автоматическая пролонгация
--    "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
--    "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора
--    "url": "string", ~/~/ ссылка на локатор
--    "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
--    "showVehicleName": true, ~/~/ Наименование объекта
--    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
--    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
--    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
--    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
--    "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ГИС)
--
--    0
--    ]
--  }
--]
--)))
--
--
  == **Изменение локатора** ==
  (% class="box infomessage" %)
@@ -6298,31 +6298,12 @@
    "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации
    "validity": 0, ~/~/ Срок действия в днях (1-90)
    "autoProlongation": true, ~/~/ Автопродление срока действия
--  "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
-- "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую
--    0
--  ],
--  "showVehicleName": true, ~/~/ Наименование объекта
--    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
--    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
--    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
--    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
--    "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ГИС)
--
--    0
--
--  ]
++  "url": "string", ~/~/ Ссылка
++  "language": 0 ~/~/ Язык
  }
--
--
  )))
++
  Пример ответа:
 ~/~/ Success
@@ -6344,6 +6344,7 @@
  )))
++
  = **Раздел: Яндекс Маршруты** =
@@ -6357,6 +6357,7 @@
  Пример запроса:
  Id  ~/~/ Идентификатор поля
++
  Пример ответа:
  (((
@@ -6374,6 +6374,7 @@
  )))
++
  == **Добавить маршрут** ==
  (% class="box infomessage" %)
@@ -6428,6 +6428,7 @@
  }
  )))
++
  Пример ответа:
  (((
@@ -6458,6 +6458,7 @@
  ]
  )))
++
  Пример ответа:
  (((
@@ -6481,64 +6481,27 @@
  Id  ~/~/ Идентификатор поля
--= **Раздел: Управление доступа к машинам** =
++====   ====
++==== **Раздел: Управление доступа к машинам** ====
--== Получение списка транспортных средств видимых пользователю ==
++== Получение списка ID ==
++
  (% class="box infomessage" %)
  (((
  **GET /api/v3/UserVisibleVehicles/{userId}**
  )))
--Пример ответа:
--(((
--{
--  "vehicleIds": [  ~/~/ Идентификаторы ТС
--    0
--  ]
--}
--)))
--== Задает видимость транспортных средств пользователю ==
--(% class="box infomessage" %)
--(((
--**POST /api/v3/UserVisibleVehicles**
--)))
--Пример запроса:
--(((
--(((
--{
--  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор пользователя
--  "vehicleIds": [ ~/~/ Идентификаторы ТС
--    0
--  ]
--}
--)))
--(((
--
--)))
--(((
--Пример ответа :
--)))
--(((
--
--)))
--
--(((
--200 ~/~/ Success
--)))
--)))
--
--
  (% class="box" lang="en-US" style="text-align: center;" %)
  (((
  (% 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]] **

Changes for page Методы API для работы с ГЛОНАССSoft

Summary

Details

Меню