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

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

From version < 21.11 >

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

To version < 21.4 >

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -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" %)}
@@ -626,102 +626,14 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON):
--(% style="color:#000000" %) {
++(% style="color:#000000" %)//Обязательные параметры наименование и модель объекта //В теле запроса - объект JSON {     «vehicleId»: «», //ID ТС     «parentId»: «», //ID клиента     «name»: «», //имя ТС     «imei»: «», //IMEI     «deviceTypeId»: «», //ID типа устройства     «modelId»: «»,     «unitId»: «», //ID подразделения     «sim1»: «», //SIM 1     «sim2»: «», //SIM2     «consumptionPer100Km»: «», //Расход топлива на 100 км     «consumptionIdle»: «», //Расход топлива на холостом ходу     «counters»: {         «mileageEnabled»: true, //флаг активности счётчика «пробег»         «motohoursEnabled»: true, //флаг активности счётчика «моточасы»         «mileage»: «», //пробег         «motohours»: «» //моточасы     },     «cmsv6Parameters»: { //параметры CMSv6         «id»: «», //идентификатор         «enabled»: true, //флаг включения         «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6         «login»: «», //имя учетной записи         «password»: «» //пароль учетной записи     },     «inspectionTasks»: [ //задания на ТО         {             «id»: «», //ID задания             «enabled»: false, //Признак включения             «name»: «», //Имя задания             «description»: «», //Описание задания             «mileageCondition»: «», //Условие по пробегу (в метрах, null - условие не работает)             «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО (null - неважно)             «motohoursCondition»: «», //Условие по моточасам (в секундах, null - условие не работает)             «lastMotohours»: «», //Моточасы (в секундах) на момент последнего ТО (null - неважно)             «periodicCondition»: «», //Условие периодичности по времени (null - условие не работает)             «kind»: «», //Вид периодичности по времени             «maxQuantity»: «» //Сколько раз выполнить задание         }     ] }
--(% style="color:#000000" %)    "vehicleId": "", ~/~/ ID ТС
--    "parentId": "", ~/~/ ID клиента
--    "name": "", ~/~/ имя ТС
--    "imei": "", ~/~/ IMEI
--    "deviceTypeId": "", ~/~/ ID типа устройства
--    "modelId": "", ~/~/ , ID модели
--    "unitId": "", ~/~/ подразделения
--    "sim1": "", ~/~/ SIM 1
--    "sim2": "", ~/~/ SIM2
--    "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км
--    "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу
--         "counters":
--        {
--         "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег»
--         "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы»
--         "mileage": «», пробег
--         "motohours": «» моточасы
--        }
--        "cmsv6Parameters": ~/~/  параметры CMSv6
--        {
--        "id": "", ~/~/ идентификатор
--        "enabled": true, ~/~/ флаг включения
--        "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
--        "login": "", ~/~/ имя учетной записи
--        "password": "", ~/~/ пароль учетной записи
--        }
--            "inspectionTasks": ~/~/ задания на ТО
--        {
--            "id": "", ~/~/ ID задания
--            "enabled": false, ~/~/ Признак включения
--            "name": "", ~/~/ Имя задания
--            "description": "", ~/~/ Описание задания
--            "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает)
--            "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно)
--            "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает)
--            "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно)
--            "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает)
--            "kind": "", ~/~/ Вид периодичности по времени
--            "maxQuantity": "", ~/~/ Сколько раз выполнить задание
--        }
--
--(% style="color:#000000" %)}
--
  (% style="color:#000000" %)Ответ:
  (% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %){
++(% lang="ru-RU" style="color:#000000; font-weight:normal" %){     «vehicleId»: «», //ID ТС     «parentId»: «», //ID клиента     «name»: «», //имя ТС     «imei»: «», //IMEI     «deviceTypeId»: «», //ID типа устройства     «modelId»: «»,     «unitId»: «», //ID подразделения     «sim1»: «», //SIM 1     «sim2»: «», //SIM2     «consumptionPer100Km»: «», //Расход топлива на 100 км     «consumptionIdle»: «», //Расход топлива на холостом ходу     «counters»: {         «mileageEnabled»: true, //флаг активности счётчика «пробег»         «motohoursEnabled»: true, //флаг активности счётчика «моточасы»         «mileage»: «», //пробег         «motohours»: «» //моточасы     },     «cmsv6Parameters»: { //параметры CMSv6         «id»: «», //идентификатор         «enabled»: true, //флаг включения         «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6         «login»: «», //имя учетной записи         «password»: «» //пароль учетной записи     },     «inspectionTasks»: [ //задания на ТО         {             «id»: «», //ID задания             «enabled»: false, //Признак включения             «name»: «», //Имя задания             «description»: «», //Описание задания             «mileageCondition»: «», //Условие по пробегу             «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО             «motohoursCondition»: «», //Условие по моточасам             «lastMotohours»: «», //Моточасы             «periodicCondition»: «», //Условие периодичности по времени             «kind»: «», //Вид периодичности по времени             «maxQuantity»: «» //Сколько раз выполнить задание         }     ] }
--(% lang="en-US" style="text-align:left" %)
--    "vehicleId": "", ~/~/ ID ТС
--    "parentId": "", ~/~/ ID клиента
--    "name": "", ~/~/ имя ТС
--    "imei": "", ~/~/ IMEI
--    "deviceTypeId": "", ~/~/  типа устройства
--    "modelId": "", ~/~/ ID модели
--    "unitId": "", ~/~/ ID подразделения
--    "sim1": "", ~/~/ SIM 1
--    "sim2": "", ~/~/ SIM2
--    "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км
--    "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу
--        "counters":
--        {
--        "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег»
--        "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы»
--        "mileage": "", ~/~/ пробег
--        "motohours": "", ~/~/ моточасы
--        }
--        "cmsv6Parameters": ~/~/  параметры CMSv6
--        {
--        "id": ~/~/  идентификатор
--        "enabled": true, ~/~/ флаг включения
--        "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
--        "login": "", ~/~/ имя учетной записи
--        "password": "", ~/~/ пароль учетной записи
--        }
--        "inspectionTasks": ~/~/ задания на ТО
--        {
--        "id": "", ~/~/ ID задания
--        "enabled": false, ~/~/ Признак включения
--        "name": "", ~/~/ Имя задания
--        "description": "", ~/~/ Описание задания
--        "mileageCondition": "", ~/~/ Условие по пробегу
--        "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО
--        "motohoursCondition": "", ~/~/ Условие по моточасам
--        "lastMotohours": "", ~/~/ Моточасы
--        "periodicCondition": "", ~/~/ Условие периодичности по времени
--        "kind": "", ~/~/ Вид периодичности по времени
--        "maxQuantity": "", ~/~/ Сколько раз выполнить задание
--        }
--(% lang="en-US" style="text-align:left" %)
--(% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
--
--
  (% class="box errormessage" %)
  (((
  (% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}**

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

Summary

Details

Меню