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

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

From version < 21.8 >

edited by Артем Шемяков
on 2022/09/02 09:34

To version < 21.2 >

edited by Артем Шемяков
on 2022/09/02 09:18

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -454,43 +454,46 @@
  (% style="color:#000000" %){
--    "vehicleId": "", ~/~/ID ТС
--    "parentId": "", ~/~/Guid владельца ТС
--    "name": "", ~/~/Имя объекта
--    "imei": "", ~/~/IMEI
--    "deviceTypeId": "", ~/~/ID типа устройства
--    "modelId": "", ~/~/ID модели
--    "unitId": "", ~/~/ID подразделения
--    "sim1": "", ~/~/SIM1
--    "sim2": "", ~/~/SIM2
--    "consumptionPer100Km": "", ~/~/Расход топлива на 100 км
--    "consumptionIdle": "", ~/~/Расход топлива на холостом ходу
-- "counters": { ~/~/Счётчики
--    "mileageEnabled": true,
--    "motohoursEnabled": true,
--    "mileage": "",
--    "motohours": 345.0
++(% class="western" %)
++{{{  "vehicleId": "", //ID ТС
++  "parentId": "", //Guid владельца ТС
++  "name": "", //Имя объекта
++  "imei": "", //IMEI
++  "deviceTypeId": "", //ID типа устройства
++  "modelId": "", //ID модели
++  "unitId": "", //ID подразделения
++  "sim1": "", //SIM1
++  "sim2": "", //SIM2
++  "consumptionPer100Km": "", //Расход топлива на 100 км
++  "consumptionIdle": "", //Расход топлива на холостом ходу
++  "counters": { //Счётчики
++      "mileageEnabled": true,
++      "motohoursEnabled": true,
++      "mileage": "",
++      "motohours": 345.0
    },
-- "cmsv6Parameters": { ~/~/Параметры CmsV6
--    "id": null,
--    "enabled": true, ~/~/флаг включения
--    "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
--    "login": "", ~/~/ имя учетной записи
--    "password": "" ~/~/ пароль учетной записи
++  "cmsv6Parameters": { //Параметры CmsV6
++      "id": null,
++      "enabled": true, //флаг включения
++      "host": "", // IP-адрес или доменное имя из URL веб-сайта CMSV6
++      "login": "", // имя учетной записи
++      "password": "" // пароль учетной записи
    },
--  "inspectionTasks": { ~/~/ задания на ТО
--    "id": "", ~/~/ ID задачи
--    "enabled": false, ~/~/ Признак включения
--    "name": "", ~/~/ Имя задания
--    "description": "", ~/~/ Описание задания
--    "mileageCondition": "", ~/~/ Условие по пробегу
--    "lastMileage": "", ~/~/ Пробег (в метрах)
--    "motohoursCondition": "", ~/~/ Условие по моточасам
--    "lastMotohours": "", ~/~/ Моточасы
--    "periodicCondition": "", ~/~/ Условие периодичности по времени
--    "kind": "", ~/~/ Вид периодичности по времени
--    "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
--     }
++  "inspectionTasks": [ // задания на ТО
++      {
++          "id": "", // ID задачи
++          "enabled": false, // Признак включения
++          "name": "", // Имя задания
++          "description": "", // Описание задания
++          "mileageCondition": "", // Условие по пробегу
++          "lastMileage": "", // Пробег (в метрах)
++          "motohoursCondition": "", // Условие по моточасам
++          "lastMotohours": "", // Моточасы
++          "periodicCondition": "", // Условие периодичности по времени
++          "kind": "", // Вид периодичности по времени
++          "maxQuantity": "" // Сколько раз выполнить задание (null - однократно)
++      }
++  ]}}}
  (% style="text-align:left" %)
  (% style="color:#000000" %)}
@@ -509,11 +509,11 @@
  (% style="color:#000000" %)− возвращает информацию об объектах с учетом заданных настроек видимости объектов;
--(% style="color:#000000" %)− информация предоставляется с учетом наличия прав на просмотр объектов заблокированных договоров (объекты, принадлежащие заблокированному договору возвращаются при наличии любого из прав **«__Видимость объектов заблокированных договоров в панели управления__»** или **«__Видимость объектов заблокированных договоров в мониторинге__»**;
++(% style="color:#000000" %)− информация предоставляется с учетом наличия прав на просмотр объектов заблокированных договоров (объекты, принадлежащие заблокированному договору возвращаются при наличии любого из прав «Видимость объектов заблокированных договоров в панели управления» или «Видимость объектов заблокированных договоров в мониторинге»;
--(% style="color:#000000" %)− информация о телефонах SIM1/SIM2 предоставляется при наличии права **«__Просмотр номеров телефонов объектов__»**;
++(% style="color:#000000" %)− информация о телефонах SIM1/SIM2 предоставляется при наличии права «Просмотр номеров телефонов объектов»;
--(% style="color:#000000" %)− информация о статусе объекта предоставляется при наличии права **«__Просмотр статуса объекта__»**.
++(% style="color:#000000" %)− информация о статусе объекта предоставляется при наличии права «Просмотр статуса объекта».
  (% style="color:#000000" %)Метод запроса: **POST**
@@ -527,41 +527,19 @@
  (% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON):
--(% class="western" style="color:#000000" %)##{##
++(% class="western" style="color:#000000" %)##{"vehicleId": null,~/~/84350, ~/~/ ID ТС (int, опционально) "name": null, ~/~/ Имя ТС (string, опционально) "imei": null,~/~/"710179307",##
--(% class="western" style="color:#000000" %)##    "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально)
--    "name": null, ~/~/ Имя ТС (string, опционально)
--    "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально)
--    "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально)
--    "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально)
--    "parentId": null, ~/~/ ID клиента (Guid, опционально)
--    "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)##(%%)
--(% style="color:#000000" %)}
++(% class="western" style="color:#000000" %)##~/~/ IMEI (string, опционально) "sim": null, ~/~/"938112", ~/~/ Номер телефона (string, опционально) "deviceTypeId": null,~/~/5##
--(% style="color:#000000" %)          Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
++(% class="western" style="color:#000000" %)##~/~/ ID типа устройства (short, опционально) "parentId": null, ~/~/ ID клиента (Guid, опционально) "unitId": null##
--(% style="color:#000000" %)Ответ:
++(% class="western" style="color:#000000" %)##~/~/"b33548c3-73c3-40e4-8b78-81470ae744ed" ~/~/ ID подразделения (Guid, опционально)##(% style="color:#000000" %)}
--(% style="color:#000000" %){
++(% style="color:#000000" %)          Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права «Просмотр номеров телефонов объектов».
--(% style="color:#000000" %)    "vehicleId": "" ~/~/ идентификатор объекта
--    "name": "" ~/~/ наименование объекта
--    "imei": "" ~/~/ IMEI объекта
--    "deviceTypeId": "" ~/~/ идентификатор типа устройства
--    "deviceTypeName": "" ~/~/ наименование типа устройства
--    "sim1": "" ~/~/ первый номер телефона
--    "sim2": "" ~/~/ второй номер телефона
--    "parentId": "" ~/~/ идентификатор клиента-родителя
--    "parentName": "" ~/~/ наименование клиента-родителя
--    "modelId": "" ~/~/ идентификатор модели объекта
--    "modelName": "" ~/~/ наименование модели объекта
--    "unitId": "" ~/~/ идентификатор подразделения
--    "unitName": "" ~/~/ наименование подразделения
--    "status": "" ~/~/ статус объекта
--    "createdAt": "" ~/~/ дата создания объектов  (%%)
--(% style="color:#000000" %)}
++(% style="color:#000000" %)Ответ: [     {         «vehicleId»: «», //идентификатор объекта         «name»: «», // наименование объекта         «imei»: «», // IMEI объекта         «deviceTypeId»: «», // идентификатор типа устройства         «deviceTypeName»: «», // наименование типа устройства         «sim1»: «», // первый номер телефона         «sim2»: «», //второй номер телефона         «parentId»: «», //идентификатор клиента-родителя         «parentName»: «», //наименование клиента-родителя         «modelId»: «», //идентификатор модели объекта         «modelName»: «», //наименование модели объекта         «unitId»: «», //идентификатор подразделения         «unitName»: «», //наименование подразделения         «status»: «», // статус объекта         //«//createdAt//»: «» дата создания объектов         //},     … ]
--(% style="color:#000000" %)          Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
++(% style="color:#000000" %)          Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«Просмотр номеров телефонов объектов»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«Просмотр статуса объекта»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
@@ -581,32 +581,30 @@
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
--(% style="color:#000000" %)Параметры в теле запроса (JSON):
++(% style="color:#000000" %)Параметры в теле запроса (JSON): {
--(% style="color:#000000" %){
++(% class="western" %)
++{{{  "status": "", // значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика,
++                                   // 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан,
++                                   // 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется)
++  "date": "", // Дата смены статуса (null если сменить немедленно)
++  "description": "", // Описание
++  "data": "", // Данные
++  "overwrite": false, // Флаг перезаписи
++  "stage": "", // Состояние, может быть null}}}
--  "status": "", ~/~/ значение статуса (-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика,
--                                   ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан,
--                                   ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется)
--  "date": "", ~/~/ Дата смены статуса (null если сменить немедленно)
--  "description": "", ~/~/ Описание
--  "data": "", ~/~/ Данные
--  "overwrite": false, ~/~/ Флаг перезаписи
--  "stage": "", ~/~/ Состояние, может быть null
++(% style="color:#000000" %)}
--  (% style="color:#000000" %)}
++(% style="color:#000000" %)Ответ: {
--(% style="color:#000000" %)Ответ:
++(% class="western" %)
++{{{  "status": "", // значение статуса
++  "date": "", // Дата смены статуса
++  "description": "", // Описание
++  "data": "", // Данные
++  "overwrite": false, // Флаг перезаписи
++  "stage": "", // Состояние}}}
--(% style="color:#000000" %){
--
--  "status": "", ~/~/ значение статуса
--  "date": "", ~/~/ Дата смены статуса
--  "description": "", ~/~/ Описание
--  "data": "", ~/~/ Данные
--  "overwrite": false, ~/~/ Флаг перезаписи
--  "stage": "", ~/~/ Состояние
--
  (% style="text-align:left" %)
  (% style="color:#000000" %)}

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

Summary

Details

Меню