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

Last modified by Андрей Калиновский on 2025/06/27 16:12

From version < 238.1 >

edited by Андрей Калиновский
on 2025/05/26 15:47

To version < 241.1 >

edited by Андрей Калиновский
on 2025/06/10 15:42

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -2796,7 +2796,7 @@
      "id": 0, ~/~/ ID уведомления
      "name": "string", ~/~/ Название уведомления
      "active": true, ~/~/ Состояние true - активен, false - деактивирован
--    "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО
++    "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя)
      "userId": "", ~/~/ Пользователь, создавший уведомление
      "parentId": "", ~/~/ Идентификатор клиента
      "parentName": "string" ~/~/ Имя клиента
@@ -2803,6 +2803,155 @@
    }
  ]
++
++== (% style="color:#000000; font-size:16px" %)**Создание уведомления**(%%) ==
++
++(% class="box infomessage" %)
++(((
++**POST /api/v3/notifications**
++)))
++
++Метод запроса **POST**
++
++(% style="text-align: left;" %)
++(% style="color:#000000" %)Пример запроса
++
++(((
++{
++  "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"
++      }
++    }
++  ]
++}
++)))
++
++(((
++
++)))
++
++(((
++
++)))
++
++Ответ:
++
++{
++  "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"
++      }
++    }
++  ]
++}
++
  == (% style="color:#000000; font-size:16px" %)**Запрос настроек уведомления**(%%) ==
  (% class="box infomessage" %)
@@ -4020,16 +4020,12 @@
  Тело запроса:
  {
--  "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" %)
@@ -4041,16 +4041,29 @@
  Тело запроса:
++(((
  {
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
--  "Balance": 0
++  "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
++  "amount": 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" %)Значение баланса
++(((
++{
++  "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="color:#000000; font-size:16px" %)**Списать с баланса**(%%) ==
@@ -4063,16 +4063,25 @@
  Тело запроса:
++(((
  {
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
--  "Balance": 0
++  "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
++  "amount": 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" %)Значение баланса
++(((
++{
++  "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="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) ==
@@ -4083,28 +4083,35 @@
  Тело запроса:
++(((
  {
--  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
--  "CalculationType": 0,
--  "PermissibleBalance": 0,
--  "DefermentDays": 0,
--  "SendUiNotifications": true,
--  "SendEmailNotifications": true,
--  "IsPrivate": true,
++  "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
++  "CalculationType": 0, ~/~/ Определяет тип расчёта, 0 - Деньги, 1 - Дни
++  "PermissibleBalance": 0, ~/~/ Допустимый баланс
++  "DefermentDays": 0, ~/~/ Отсрочка (дни).
++  "SendUiNotifications": true, ~/~/ Оповещение в web-интерфейсе, true - включено, false - выключено
++  "SendEmailNotifications": true ~/~/ Оповещение на почту, true - включено, false - выключено
  }
++)))
++(((
++
++)))
++
  Ответ: Success
--|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
--|ClientId|Идентификатор клиента
--|CalculationType|Определяет тип расчёта, 0 - Деньги, 1 - Дни
--|PermissibleBalance|Допустимый баланс
--|DefermentDays|(((
--Отсрочка, количество дней
++(((
++{
++  "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" %)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" %)**Изменить тариф клиента**(%%) ==
@@ -4116,35 +4116,68 @@
  Тело запроса:
  {
--  "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,
--      "Price": 0,
--      "DebitDate": "2023-10-18T13:26:58.987Z",
--      "PeriodValue": 0,
--      "PeriodType": 0
++      "Feature": "string", ~/~/ Код услуги.
++      "IsEnabled": true, ~/~/ Признак, определяющий активирована ли услуга.
++      "IsFactual": true, ~/~/ Признак, определяющий расчёт по факту.
++      "Limit": 0, ~/~/ Лимит использования услуги. Значение -1 подразумевает безлимитное использование
++      "Price": 0, ~/~/ Цена за единицу.
++      "DebitDate": "2023-10-18T13:26:58.987Z", ~/~/ Следующий момент времени списания с баланса за услугу.
++      "PeriodValue": 0, ~/~/ Значение периода.
++      "PeriodType": 0 ~/~/ Определяет тип периода действия услуги в тарифном плане ( 0 - Дни, 1 - Месяцы)
      }
    ]
  }
++
  Ответ: Success
--|=(% 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 - Месяцы
++(((
++{
++  "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="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) =

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

Summary

Details

Меню