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

Last modified by Андрей Калиновский on 2025/01/28 12:59

From version < 154.2 >

edited by Андрей Калиновский
on 2024/07/19 13:24

To version < 177.1 >

edited by Михаил Жучков
on 2024/10/29 08:51

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Gadmin
++XWiki.SupportZhuchkov

Content

@@ -14,11 +14,20 @@
  Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de.
--(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!
++(% style="color:#000000" %)− (%%)При **редактировании** любой записи (пользователь, объект и т.д) необходимо передавать все параметры записи в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!
++
++(% style="color:#000000; font-size:16px" %)**Рекомендации**
++
++- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период).
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) ==
++(% class="box warningmessage" id="H41043244243E44043843743044643844F" %)
++(((
++(% style="color:#000000; font-size:16px" %)**Авторизация**(%%)
++(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие)
++)))
  (% class="box successmessage" %)
  (((
@@ -44,12 +44,8 @@
  (% lang="en-US" %)
  (% style="color:#000000" %){
--
--(% lang="en-US" %)
--(% style="color:#000000" %)    "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" ,  ~/~/ токен авторизации
--    "User": "testuser" ,  ~/~/ имя пользователя
--
--(% lang="en-US" %)
++    "AuthId": "(%%)93c6jg79-b88b-4a35-a2d0-70dg9jc2898b(% style="color:#000000" %)" ,  ~/~/ токен авторизации
++    "User": "testuser" ,  ~/~/ имя пользователя(%%)
  }
  **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется.
@@ -229,7 +229,6 @@
    "bankKS": "string" ~/~/ корр. счёт
  }
--
  Ответ:
  {
@@ -423,7 +423,6 @@
      ],
      "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
  }
--
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "lastName": "string",
@@ -437,12 +437,8 @@
  (% style="text-align:left" %)
  (% style="color:#000000; font-weight:normal" %)Ответ:
--
--(% style="text-align:left" %)
--(% style="color:#000000; font-weight:normal" %){
--
--(% style="text-align:left" %)
--(% style="color:#000000; font-weight:normal" %)    "id": "" ,  ~/~/ ID пользователя
++{
++    "id": "" ,  ~/~/ ID пользователя
      "lastName": "" ,  ~/~/ Фамилия ,
      "firstName": "" ,  ~/~/ Имя
      "position": "" ,  ~/~/ Должность
@@ -459,11 +459,9 @@
      "kind": "" ,  ~/~/ тип аутентификации
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
      "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %),  ~/~/ роли пользователя, перечислены названия групп пользователя
++}
--(% style="text-align:left" %)
--(% style="color:#000000; font-weight:normal" %)}
--
  == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) ==
  (% class="box infomessage" %)
@@ -483,19 +483,16 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON):
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
    "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303",  ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента
    "userId": "11111111-c384-43f8-8562-1c3d79a32303",  ~/~/ ID пользователя, по которому фильтруется, null - неважно
    "login": "qqqqqq",  ~/~/ Логин пользователя, по которому фильтруется, null - неважно
    "email": "eee",  ~/~/ Email пользователя, по которому фильтруется, null - неважно
--
  (% style="color:#000000" %)}
  (% style="color:#000000" %)Ответ:
  (% style="color:#000000" %){         (%%)
--
      "id": "" ,  ~/~/ идентификатор пользователя
      "lastName": "" ,  ~/~/ фамилия
      "firstName": "" ,  ~/~/ имя
@@ -509,7 +509,6 @@
      "sessionDuration":"", ~/~/ длительность сессии в минутах
      "status": "1",  ~/~/ статус пользователя
      "lastLogged": "", ~/~/ дата/время последней авторизации
--
  (% style="color:#000000" %)}
  == (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) ==
@@ -583,10 +583,8 @@
  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON):
  (% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %){
--
--(% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %)    "id": "" ,  ~/~/ ID пользователя
++(% lang="ru-RU" style="color:#000000; font-weight:normal" %){
++    "id": "" ,  ~/~/ ID пользователя
      "lastName": "" ,  ~/~/ фамилия
      "firstName": "" ,  ~/~/ имя
      "position": "" ,  ~/~/ должность
@@ -608,9 +608,7 @@
          "target": "string" ~/~/ Адрес электронной почты двухэтапной аутентификации
      },
      "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен
--    "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
--
--(% lang="en-US" style="text-align:left" %)
++    "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя(%%)
  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__
  (% lang="en-US" style="text-align:left" %)
@@ -617,10 +617,8 @@
  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~://
  (% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %){
--
--(% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %)    "id": "" ,  ~/~/ идентификатор пользователя
++(% lang="ru-RU" style="color:#000000; font-weight:normal" %){
++    "id": "" ,  ~/~/ идентификатор пользователя
      "lastName": "" ,  ~/~/ фамилия
      "firstName": "" ,  ~/~/ имя
      "position": "" ,  ~/~/ должность
@@ -641,10 +641,8 @@
      "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
      "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
++}
--(% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
--
  == (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) ==
  (% class="box warningmessage" %)
@@ -664,12 +664,10 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON):
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
      "status": "" ,  ~/~/ статус пользователя (0 - новый, 1 - подтверждён, 2 - активен, 3 - уточнить, 4 - блокирован)
      "description": "" ,  ~/~/ описание
      "data": "" ,  ~/~/ данные, связанные со сменой статуса
--
  (% style="color:#000000" %)}
  (% style="text-align:left" %)
@@ -691,7 +691,7 @@
  (% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON):
   [
--    "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc",
++   "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc",
      "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1"
    ]
@@ -997,7 +997,7 @@
  Ответ: В случае успеха **Success 200**
--= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) =
++= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) =
  == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) ==
@@ -1033,19 +1033,15 @@
      "deviceTypeName": "", ~/~/ Название типа устройства
      "sim1": "", ~/~/ Номер SIM1
      "sim2": "", ~/~/ Номер SIM2
--
      "parentId": "", ~/~/ ID клиента-родителя
      "parentName": "", ~/~/ Наименование клиента-родителя
      "modelId": "", ~/~/ ID модели объекта
      "modelName": "", ~/~/ Имя модели объекта
--
      "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID подразделения
      "unitName": "string", ~/~/ Наименование подразделения
      "status": 0, ~/~/ Статус объекта
--
      "createdAt": "", ~/~/ Дата создания объекта
      },
--
  "customFields": [ ~/~/ Произвольные поля
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID поля
@@ -1068,8 +1068,7 @@
       "consumptionPerHourSeasonalBegin": "" ,  ~/~/ День/месяц начала работы сезонной нормы расхода на моточас
       "consumptionPerHourSeasonalEnd": "" ,  ~/~/ День/месяц окончания работы сезонной нормы расхода на  моточас
       "consumptionIdleSeasonalBegin": "" ,  ~/~/ День/месяц начала работы сезонной нормы расхода на х/х
--     "consumptionIdleSeasonalEnd": "" ,  ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х
--
++     "consumptionIdleSeasonalEnd": "" ,  ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х
    "mileageCalcMethod": 0, ~/~/ Метод расчета пробега, 0 - gps, 1 - датчик зажигания
    "mileageCoeff": 0, ~/~/ коэффициент пробега
    "locationByCellId": true, ~/~/ определение местоположения по данным LBS, true - активна, false - не активна
@@ -1099,7 +1099,6 @@
        "retries": 0 ~/~/ Количество попыток
      }
    ],
--
     "sensors": [ ~/~/ Датчики
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
@@ -1140,31 +1140,19 @@
        },
  ~/~/ Характерные для произвольного:
--
  ~/~/                "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
--
  ~/~/                "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
--
  ~/~/                "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
--
  ~/~/                "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
--
  ~/~/               "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
--
  ~/~/                "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
--
  ~/~/               "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
--
  ~/~/                "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
--
  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
--
  ~/~/ "ValueOn": "Вкл.",
--
  ~/~/ "ValueOff": "Выкл."
        "summaryMaxValue": 0 ~/~/ Макс. значение
      }
--
      "drivers": [ ~/~/ Водители
            {
           "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
@@ -1173,7 +1173,6 @@
           "isDefault": true ~/~/ По умолчанию
            }
      ],
--
      "inspectionTasks": [ ~/~/ Задания на тех. обслуживание
          {
              "id": "", ~/~/ ID  задания
@@ -1190,8 +1190,7 @@
              "maxQuantity": ""   ~/~/ Сколько раз выполнить задание (null - однократно)
          }
      ],
--
-- "statusHistory": [ ~/~/ История статусов
++"statusHistory": [ ~/~/ История статусов
      {
        "status": 0,
        "date": "2023-05-22T09:57:39.562Z",
@@ -1199,7 +1199,6 @@
        "additionalInfo": "string"
      }
    ]
--
  }
  )))
@@ -1209,6 +1209,73 @@
  (% style="text-align:left" %)
 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
++
++== **Отправить команду на терминал** ==
++
++(% class="box successmessage" %)
++(((
++(% lang="en-US" %)**POST **(%%)**/api/v3/Vehicles/cmd/create**
++)))
++
++Команда для отправки на тс.
++
++{
++"id": "",  ~/~/идентификатор произвольного поля
++"command": "", ~/~/  Текст команды
++"retries": "",  ~/~/ Количество попыток
++"idTemplate": "" ~/~/ ID шаблона команды
++}
++
++
++== **Получить ответ на отправленную на ТС команду** ==
++
++(% class="box infomessage" %)
++(((
++(% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer**
++)))
++
++Идентификатор команды: cmdid
++
++Запрос от терминала на ответ команды
++
++Пример ответ от терминала:
++
++ID= "" ~/~/ идентификатор произвольного поля
++Soft="" ~/~/ версия софта
++GPS=4 ~/~/ тип трекера
++Time=11:05:43 28.06.24 ~/~/ время запроса
++Lat=45.056221 ~/~/ широта
++Lon=39.035938 ~/~/ долгота
++Speed=0.0 ~/~/ скорость
++Course=181.4 ~/~/направление
++
++(((
++== **Список отправленных объекту команд с ответами** ==
++
++(% class="box infomessage" %)
++(((
++(% lang="en-US" %)**GET**(%%)**/api/v3/Vehicles/cmd/{vehicleId}/history**
++)))
++
++Идентификатор ТС: vehicleId
++
++В ответе приходит список команд с их ID, временем отправки, количестве попыток отправки и ответами терминала.
++
++Пример ответа терминала
++
++[
++{
++"id": "",  ~/~/ идентификатор пользователя
++"commandText": "",   ~/~/Текст команды.
++"templateId": "",    ~/~/Идентификатор шаблона
++"updated": "",  ~/~/ Время отправки
++"tryCount": 0,  ~/~/ Количество попыток отправки команды
++"answer": "",    ~/~/ Ответ терминала.
++"status": "" ~/~/ Статус отправки
++}
++]
++)))
++
  == (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) ==
  (% class="box successmessage" %)
@@ -1226,8 +1226,7 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON): //Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
      "parentId": "" ,  ~/~/ ID клиента
      "name": "" ,  ~/~/ имя ТС
      "imei": "" ,  ~/~/ IMEI
@@ -1248,7 +1248,6 @@
       "consumptionPerHourSeasonalEnd": "" ,  ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас
       "consumptionIdleSeasonalBegin": "" ,  ~/~/ День/месяц начала работы сезонной нормы расхода на х/х
       "consumptionIdleSeasonalEnd": "" ,  ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х
--
       "mileageCalcMethod": 0,
       "mileageCoeff": 0,
       "locationByCellId": true,
@@ -1281,7 +1281,6 @@
        "lastInspectionDate": "" ,  ~/~/ Дата последнего ТО (null - не указано)
        "maxQuantity": ""   ~/~/ Сколько раз выполнить задание (null - однократно)
        }
--
  "drivers": [ ~/~/ Водители
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
@@ -1296,8 +1296,7 @@
        "retries": 0
      }
    ],
--
-- "sensors": [ ~/~/ Датчики
++"sensors": [ ~/~/ Датчики
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
        "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный
@@ -1335,29 +1335,17 @@
          "additionalProp2": "string",
          "additionalProp3": "string"
        },
--
  ~/~/ Характерные для произвольного:
--
  ~/~/                "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
--
  ~/~/                "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
--
  ~/~/                "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
--
  ~/~/                "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
--
  ~/~/               "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
--
  ~/~/                "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
--
  ~/~/               "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
--
  ~/~/                "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
--
  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
--
  ~/~/ "ValueOn": "Вкл.",
--
  ~/~/ "ValueOff": "Выкл."
        "summaryMaxValue": 0 ~/~/ Макс. значение
      }
@@ -1376,8 +1376,7 @@
  (% style="color:#000000" %)Ответ:
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
      "vehicleId": "", ~/~/ID ТС
      "parentId": "", ~/~/Guid владельца ТС
      "name": "", ~/~/Имя объекта
@@ -1415,8 +1415,6 @@
      "kind": "", ~/~/ Вид периодичности по времени
      "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
      }
--
--(% style="text-align:left" %)
  (% style="color:#000000" %)}
  **Валидация:**
@@ -1424,7 +1424,7 @@
  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
--== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) ==
++== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) ==
  (% class="box infomessage" %)
  (((
@@ -1475,8 +1475,7 @@
  (% style="color:#000000" %)Ответ:
  (% style="color:#000000" %){
--
--(% style="color:#000000" %)    "vehicleId": "" ~/~/ идентификатор объекта
++    "vehicleId": "" ~/~/ идентификатор объекта
      "name": "" ~/~/ наименование объекта
      "imei": "" ~/~/ IMEI объекта
      "deviceTypeId": "" ~/~/ идентификатор типа устройства
@@ -1535,13 +1535,11 @@
    "data": "", ~/~/ Данные
    "overwrite": false, ~/~/ Флаг перезаписи
    "stage": "", ~/~/ Состояние, может быть null
--
  (% style="color:#000000" %)}
  (% style="color:#000000" %)Ответ:
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
    "status": "", ~/~/ значение статуса
    "date": "", ~/~/ Дата смены статуса
    "description": "", ~/~/ Описание
@@ -1548,10 +1548,10 @@
    "data": "", ~/~/ Данные
    "overwrite": false, ~/~/ Флаг перезаписи
    "stage": "", ~/~/ Состояние
--
--(% style="text-align:left" %)
  (% style="color:#000000" %)  }
++==   ==
++
  == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==
  (% class="box warningmessage" %)
@@ -1639,8 +1639,7 @@
        "retries": 0
      }
    ],
--
-- "sensors": [ ~/~/ Датчики
++"sensors": [ ~/~/ Датчики
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID датчика
        "kind": 0, ~/~/ Тип, Simple - простой, Composite - виртуальный
@@ -1678,29 +1678,17 @@
          "additionalProp2": "string",
          "additionalProp3": "string"
        },
--
  ~/~/ Характерные для произвольного:
--
  ~/~/                "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off
--
  ~/~/                "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы
--
  ~/~/                "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off
--
  ~/~/                "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний
--
  ~/~/               "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off
--
  ~/~/                "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off
--
  ~/~/               "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off
--
  ~/~/                "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область)
--
  ~/~/ Характерные для таблицы тарировки Вкл./Выкл.:
--
  ~/~/ "ValueOn": "Вкл.",
--
  ~/~/ "ValueOff": "Выкл."
        "summaryMaxValue": 0 ~/~/ Макс. значение
      }
@@ -1720,9 +1720,7 @@
  (% style="color:#000000" %)Ответ:
  (% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %){
--
--(% lang="en-US" style="text-align:left" %)
++(% lang="ru-RU" style="color:#000000; font-weight:normal" %){     (%%)
      "vehicleId": "", ~/~/ ID ТС
      "parentId": "", ~/~/ ID клиента
      "name": "", ~/~/ имя ТС
@@ -1763,8 +1763,6 @@
          "kind": "", ~/~/ Вид периодичности по времени
          "maxQuantity": "", ~/~/ Сколько раз выполнить задание
          }
--
--(% lang="en-US" style="text-align:left" %)
  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
  **Валидация:**
@@ -1811,12 +1811,9 @@
  (% style="color:#000000" %)Ответ:
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
      "deviceTypeId" : "", ~/~/ ID типа устройства
      "deviceTypeName" : "" ~/~/ Название типа устройства
--
--(% style="text-align:left" %)
  (% style="color:#000000" %)}
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) =
@@ -1838,13 +1838,10 @@
  (% style="color:#000000" %)Ответ:
--(% style="color:#000000" %){
--
++(% style="color:#000000" %){(%%)
      "id": "", ~/~/ ID типа датчика
      "name": "", ~/~/ Название
      "description": "", ~/~/ Описание
--
--(% style="text-align:left" %)
  (% style="color:#000000" %)}
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Сообщения**(%%) =
@@ -2046,10 +2046,12 @@
        {
          "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало
          "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание
--        "mileageBegin": 0, ~/~/ Пробег на начало периода
--        "mileageEnd": 0, ~/~/ Пробег на окончание периода
--        "motohoursBegin": 0, ~/~/ Моточасы на начало периода
--        "motohoursEnd": 0 ~/~/ Моточасы на окончание периода
++        "mileage": 0, ~/~/ Пробег за период, километры
++        "mileageBegin": 0, ~/~/ Пробег на начало периода, километры
++        "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры
++        "motohours": 0, ~/~/ Моточасы за период, секунды
++        "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды
++        "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды
        }
      ]
    }
@@ -2098,6 +2098,12 @@
    }
  ]
++(% class="box warningmessage" %)
++(((
++Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"".
++\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling".
++)))
++
  == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) ==
  (% class="box infomessage" %)
@@ -2161,74 +2161,42 @@
  Тело запроса:
  {
--
    "vehicleIds": [ ], ~/~/ Список ID объектов
--
    "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса
--
    "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса
--
    "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
--
  }
  Ответ:
--[
--
++[
    {
--
      "vehicleId": 0, ~/~/ ID объекта
--
      "vehicleName": "string", ~/~/ Имя объекта
--
      "moves": [      ~/~/ Событие движения
--
        {
--
          "mileage": 0, ~/~/ Пробег, км
--
          "eventId": 0, ~/~/ Идентификатор события
--
          "eventName": "string", ~/~/ Название события
--
          "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события
--
          "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события
--
          "duration": 0 ~/~/ Продолжительность события, секунд
--
        }
--
      ],
--
      "stops": [       ~/~/ События стоянок
--
        {
--
          "address": "string", ~/~/ Адрес события
--
          "eventId": 0, ~/~/ Идентификатор события
--
          "eventName": "string", ~/~/ Название события
--
          "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события
--
          "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события
--
          "duration": 0 ~/~/ Продолжительность события, секунд
--
--
        }
--
      ]
--
    }
--
  ]
--
  == (% style="color:#000000; font-size:16px" %)**Получение последних данных объекта**(%%) ==
  (% class="box infomessage" %)
@@ -2265,7 +2265,6 @@
        }
--
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =
  == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) ==
@@ -2573,6 +2573,32 @@
  Success
++
++== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) ==
++
++(% class="box warningmessage" %)
++(((
++**PUT** /api/v3/notifications/prolongation
++)))
++
++Метод позволяет продлить уведомления.
++
++Метод запроса **PUT**
++
++URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation
++
++В заголовках запроса: X-Auth: Токен авторизации.
++
++Тело запроса:
++
++[
++
++0
++
++]
++
++где 0 идентификатор ids.
++
  == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) ==
  (% class="box errormessage" %)
@@ -3763,7 +3763,7 @@
  **POST /api/v3/vehicles/import/{agentId}**
  )))
--Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.**
++Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).**
  В пути указывается **agentId** - id клиента.
@@ -3775,7 +3775,7 @@
  |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание**
  |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать.
--|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление
++|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление
  В теле использовать тип **form-data,** тип значения** file**
@@ -4037,7 +4037,7 @@
  |dangerousDrivingViolations|Резкое вождение
  |sensorViolations|Нарушение по датчику
  |moveTime|Время в движении
--|mileage|Пробег
++|mileage|Пробег (км)
  |tripsCount|Количество рейсов
  |motohours|Моточасы
  |maxSpeed|Максимальная скорость
@@ -4067,55 +4067,284 @@
  Параметры в теле запроса (JSON):
  {
--
    "startDate": "2024-04-11T10:32:02.395Z", ~/~/Начало периода
--
    "endDate": "2024-04-11T10:32:02.395Z", ~/~/Конец периода
++  "ids": [
++    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт
++  ],
++  "timezone": 0 ~/~/Таймзона
++}
--  "ids": [
--    "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/гуиды топливных карт
++Ответ:
++  {
++    "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции
++    "driver": "string", ~/~/Водители, привязанные к ТК
++    "object": "string", ~/~/Наименование ТС
++    "amount": 0, ~/~/Количество топлива
++    "amountDut": 0, ~/~/Количество по ДУТ
++    "amountDiff": 0, ~/~/Разница, л
++    "amountDiffPerc": 0, ~/~/Разница, %
++    "summa": 0, ~/~/Стоимость, руб
++    "serviceName": "string", ~/~/Тип топлива
++    "price": 0, ~/~/Цена за литр, руб
++    "cardName": "string", ~/~/Наименование ТК
++    "cardNum": "string", ~/~/Номер ТК
++    "operator": "string", ~/~/Оператор ТК
++    "address": "string" ~/~/Адрес АЗС
++  }
--  ],
--  "timezone": 0 ~/~/Таймзона
++= (% style="color:#000000; font-size:18.6667px" %)Раздел: (%%)**Методы публичного API для ретрансляторов** =
++
++== **Получение полных данных о ретрансляторе** ==
++
++(% class="box infomessage" %)
++(((
++**GET ** **/api/v3/retranslations/{id}**
++)))
++
++Идентификатор запроса: ID
++
++
++Пример ответа:
++
++{
++"description": "",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ Подписчик
++"protocolType": 0,  ~/~/ Тип протокола
++"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",  ~/~/ Адрес события
++"objects": [    ~/~/Объекты для ретрансляции
++{
++"id": "",  ~/~/ Идентификатор объекта ретрансляции
++"name": "",   ~/~/ Наименование объекта ретрансляции
++"imei": "",     ~/~/ IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
  }
++  ],
++"id": "",  ~/~/ идентификатор пользователя
++"parentId": "",  ~/~/Guid родителя
++"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен
++}
++
++== **Удаление данных ретранслятора** ==
++
++(% class="box infomessage" %)
++(((
++**DELETE** **/api/v3/retranslations/{id}**
++)))
++
++Параметр запроса: ID
++
++
++== **Создание ретранслятора** ==
++
++(% class="box infomessage" %)
++(((
++**POST ** **/api/v3/retranslations/{id}**
++)))
++
++Запрос:
++
++{
++"description": "",  ~/~/ Описание
++"subscriberId": "",  ~/~/ Подписчик
++"protocolType": 0,  ~/~/ Тип протокола
++"address": "",  ~/~/ Адрес ретрансляции
++"isEnabled": "",  ~/~/ признак включения, Включен, true - включен, false - отключен
++"objects": [    ~/~/Объекты для ретрансляции
++{
++"id": "",  ~/~/ идентификатор пользователя
++"imei": "",     ~/~/IMEI объекта
++"isEnabled":  ""  ~/~/ признак включения, Включен, true - включен, false - отключен
++}
++  ]
++}
++
++
  Ответ:
--  {
++{
++"description": "string",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ идентификатор запроса
++"protocolType": 0,   ~/~/ Тип протокола
++"isEnabled":  "",  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "",  ~/~/ Адрес события
++"objects": [    ~/~/Объекты для ретрансляции
++{
++"id": "",     ~/~/ идентификатор пользователя
++"name": "string",     ~/~/ Название уведомления
++"imei": "string",    ~/~/IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++}
++  ],
++"id": "",  ~/~/ идентификатор пользователя
++"parentId": "",  ~/~/ Guid идентификатор родителя
++"deleted": true ~/~/ Признак удаления
++}
--    "date": "2024-04-11T10:41:02.265Z", ~/~/Дата и время транзакции
--    "driver": "string", ~/~/Водители, привязанные к ТК
++== **Редактирование ретранслятора** ==
--    "object": "string", ~/~/Наименование ТС
++(% class="box infomessage" %)
++(((
++**PUT** **/api/v3/retranslations**
++)))
--    "amount": 0, ~/~/Количество топлива
++Пример запроса:
--    "amountDut": 0, ~/~/Количество по ДУТ
++{
++"id": "",  ~/~/ идентификатор пользователя
++"description": "string",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ идентификатор запроса
++"protocolType": 0,  ~/~/ Тип протокола
++"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",   ~/~/ Адрес события
++"objects":  ~/~/Объекты для ретрансляции
++[
++{
++"id": "",  ~/~/ идентификатор пользователя
++"imei": "",       ~/~/IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++}
++  ]
++}
--    "amountDiff": 0, ~/~/Разница, л
--    "amountDiffPerc": 0, ~/~/Разница, %
++Пример ответа:
--    "summa": 0, ~/~/Стоимость, руб
++{
++"description": "",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ идентификатор запроса
++"protocolType": 0,  ~/~/ Тип протокола
++"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",  ~/~/ Адрес события
++"objects": [     ~/~/Объекты для ретрансляции
++{
++"id": "",    ~/~/ идентификатор пользователя
++"name": "string",  ~/~/ Название уведомления
++"imei": "",      ~/~/IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
++}
++  ],
++"id": "",  ~/~/ идентификатор пользователя
++"parentId": "",  ~/~/ Guid идентификатор родителя
++"deleted": true ~/~/ Признак удаления
++}
--    "serviceName": "string", ~/~/Тип топлива
--    "price": 0, ~/~/Цена за литр, руб
++== **Получение списка ретранслятора клиента** ==
--    "cardName": "string", ~/~/Наименование ТК
++(% class="box infomessage" %)
++(((
++**POST /api/v3/retranslations/find**
++)))
--    "cardNum": "string", ~/~/Номер ТК
++Пример запроса:
--    "operator": "string", ~/~/Оператор ТК
++{
++"id": "",  ~/~/ идентификатор пользователя
++"search": "string",  ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
++"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные.
++}
--    "address": "string" ~/~/Адрес АЗС
++Ответ:
++[
++{
++"description": "",    ~/~/ Определяет описание
++"subscriberId": "",    ~/~/ идентификатор запроса
++"protocolType": 0,     ~/~/ Тип протокола
++"isEnabled": true,    ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",    ~/~/ Адрес события
++"id": "",    ~/~/ идентификатор пользователя
++"parentId": "",    ~/~/ Guid идентификатор родителя
++"deleted": true   ~/~/ Признак удаления
++}
++]
++
++
++= (% style="color:#000000; font-size:18.6667px" %)**Раздел: Отчеты**(%%) =
++
++== **API для отчета по выгрузке комбайнов** ==
++
++(% class="box infomessage" %)
++(((
++POST **/api/v3/Reports/harvesterUnloading**
++)))
++
++Пример запроса:
++
++{
++  "byTime": 0, ~/~/ Объединение событий по времени
++  "byDist": 0,  ~/~/ Объединение событий по расстоянию
++  "filterByTime": 0,   ~/~/ Фильтрация событий по времени нахождения
++  "filterByHalfPerimeter": true,  ~/~/ Фильтрация событий по пробегу половины периметра
++  "showNearestObjects": true,  ~/~/Показывать объекты рядом?
++  "vehicleIds": [   ~/~/ Список id объектов для анализа
++    0
++  ],
++  "from": "", ~/~/ Дата и время начало запроса
++  "to": "",  ~/~/ Дата и время окончания запроса
++  "timezone": 0  ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3
++}
++
++Пример ответа:
++
++[
++  {
++    "harvesterName": "",  ~/~/Комбайн, номер
++    "harvesterId": 0, ~/~/Комбайн, id
++"harvesterModel": "", ~/~/ Модель комбайна
++"hopperCapacity": 0, ~/~/ Объем бункера м3
++    "hopperDischargeSpeed": 0,  ~/~/ Скорость выгрузки из бункера, л/сек
++    "events": [  ~/~/Список событий в разрезе комбайна
++      {
++        "driverId": "",  ~/~/Идентификатор водителя
++        "driverName": "", ~/~/Водитель комбайна, ФИО
++        "RFID": "", ~/~/ идентификатор карты-метки
++        "rfidName": "", ~/~/Водитель комбайна, имя метки
++        "vehicleId": 0, ~/~/идентификатор объекта
++        "vehicleName": "string", ~/~/ Имя объекта
++        "modelName": "string", ~/~/  Имя модели объекта
++        "nearestVehicles": [  ~/~/Объекты рядом
++          {
++            "vehicleId": 0, ~/~/идентификатор объекта
++            "vehicleName": "string" ~/~/ Имя объекта
++          }
++        ],
++        "fields": [  ~/~/Поля, где происходила выгрузка
++          {
++            "id": 0, ~/~/ идентификатор пользователя
++            "name": "string" ~/~/ имя пользователя
++          }
++        ],
++        "event": "string", ~/~/Событие
++        "start": "2024-07-19T06:41:57.821Z", ~/~/ Начало периода
++        "end": "2024-07-19T06:41:57.821Z", ~/~/ Окончание периода
++        "durationSeconds": 0,  ~/~/Продолжительность события, в секундах
++        "cultureName": "string",  ~/~/ название культуры
++        "bunkerLowLevelStart": 0,  ~/~/Бункер, нижний уровень (на начало события)
++        "bunkerLowLevelEnd": 0, ~/~/ Бункер, нижний уровень (на конец события)
++        "bunkerHighLevelStart": 0, ~/~/Бункер, верхний уровень (на начало события)
++        "bunkerHighLevelEnd": 0, ~/~/Бункер, верхний уровень (на конец события)
++        "reapingAggregateValueStart": 0, ~/~/Жатка (на начало события)
++        "reapingAggregateValueEnd": 0, ~/~/Жатка (на конец события)
++        "issued": 0, ~/~/Выдано, бункеров
++        "issuedByBunkerSensors": 0, ~/~/Отдано бункеров (расчет по датчикам бункера)
++        "latitude": 0,  ~/~/Широта
++        "longitude": 0, ~/~/ Долгота
++        "litresAway": 0, ~/~/Отдано, л
++        "m3Away": 0 ~/~/Отдано, м3
++      }
++    ]
    }
++]
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
  == (% style="color:#000000; font-size:16px" %)**Запрос на получение списка всех объектов в корзине**(%%) ==
@@ -4134,48 +4134,27 @@
  Ответ:
--[
--
++[
    {
--
      "recordTime": "",  ~/~/Время записи
--
      "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
--
      "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
--
      "objectId": 0, ~/~/ID объекта, помещённого в корзину
--
      "objectGuid": "", ~/~/Guid объекта, помещённого в корзину
--
      "objectType": 1, ~/~/Тип объекта, помещённого в корзину
--
      "details": { ~/~/Список деталей объекта, помещённого в корзину
--
--      "items": [ ~/~/ [
--
++      "items": [ ~/~/
  nullable: true  ~/~/Детали
--
          {
--
            "name": "string", ~/~/наименование столбца
--
            "value": "string" ~/~/содержание столбца
--
          }
--
        ]
--
      },
--
--    "errors": [  ~/~/Список ошибок удаления/восстановления объекта
--
++   "errors": [  ~/~/Список ошибок удаления/восстановления объекта
        "string"
--
      ]
--
    }
--
  ]
@@ -4190,56 +4190,33 @@
  Пример запроса:
--
  [
--
--  0
--
++0
  ]
++
--
  Пример ответа:
--[
--
--  {
--
++[
++{
      "recordTime": "", ~/~/Время записи
--
      "userId": "", ~/~/Guid пользователя, добавившего объект в корзину
--
      "parentId": "", ~/~/Guid агента объекта, помещённого в корзину
--
      "objectId": 0, ~/~/ID объекта, помещённого в корзин
--
      "objectGuid": "",  ~/~/Guid объекта, помещённого в корзину
--
      "objectType": 1, ~/~/Тип объекта, помещённого в корзину
--
      "details": { ~/~/Список деталей объекта, помещённого в корзину
--
        "items": [ ~/~/Детали
--
          {
--
            "name": "", ~/~/Имя свойства
--
            "value": "" ~/~/Значение свойства
--
          }
--
        ]
--
      },
--
      "errors": [  ~/~/Список ошибок удаления/восстановления объекта
--
        ""
--
      ]
--
    }
--
  ]
  Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
@@ -4262,55 +4262,41 @@
  Пример запроса:
++(((
  [
++)))
++(((
++)))
++(((
  ]
++)))
  Пример ответа:
  [
--
--  {
--
++{
      "recordTime": "2024-07-19T07:58:19.305Z", ~/~/Время записи
--
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/Guid пользователя, добавившего объект в корзину
--
      "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid агента объекта, помещённого в корзину
--
      "objectId": 0, ~/~/ID объекта, помещённого в корзину
--
      "objectGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/Guid объекта, помещённого в корзину
--
      "objectType": 1, ~/~/Тип объекта, помещённого в корзину
--
      "details": { ~/~/Список деталей объекта, помещённого в корзину
--
        "items": [ ~/~/Детали
--
          {
--
            "name": "string",  ~/~/Имя свойства
--
            "value": "string" ~/~/Значение свойства
--
          }
--
        ]
--
      },
--
      "errors": [ ~/~/Список ошибок удаления/восстановления объекта
--
        "string"
--
      ]
--
    }
--
  ]

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

Summary

Details

Меню