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

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

From version < 22.5 >

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

To version < 21.10 >

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -10,7 +10,7 @@
  (% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов).
--(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять **X-Auth** (токен авторизации, получаемый методом **auth/login**).
++(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять X-Auth (токен авторизации, получаемый методом auth/login).
  Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de.
@@ -31,7 +31,7 @@
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo>>url:https://hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo]]
--(% style="color:#000000" %)В случае успешного выполнения метода, поле «__**AuthId**__» содержит токен авторизации «__**X-Auth**__».
++(% style="color:#000000" %)В случае успешного выполнения метода, поле «AuthId» содержит токен авторизации «X-Auth».
  (% lang="en-US" %)
  (% style="color:#000000" %)**Ответ:**
@@ -44,7 +44,7 @@
      "User": "" ,  ~/~/ имя пользователя
  (% lang="en-US" %)
--}
++    }
  **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется.
@@ -82,13 +82,13 @@
  (% style="color:#000000" %)− возвращается информация о клиенте, которому принадлежит авторизованный пользователь, и его дочерних клиентах;
--(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__».
++(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «Доступ к партнёрским клиентам».
  (% style="color:#000000" %)Метод запроса: **GET**
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents?parentId=>>url:https://hosting.glonasssoft.ru/api/v3/agents?parentId=]](% style="color:#000000" %)<parentId>
--(% style="color:#000000" %)Параметр запроса: <__**parentId**__> - идентификатор клиента-родителя (опционально)
++(% style="color:#000000" %)Параметр запроса: <parentId> - идентификатор клиента-родителя (опционально)
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
@@ -99,11 +99,14 @@
      "parentId": "",  ~/~/ идентификатор клиента-родителя
      "name": "",  ~/~/ наименование клиента
      "fullName": "",  ~/~/ полное наименование клиента
--    "agentInfoType": "",  ~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)
++    "agentInfoType": "",  ~/~/ тип клиента1
      "status": "",  ~/~/ статус клиента
--}
++    }
++(% style="color:#000000" %)**Примечание:** возможные значение параметра agentInfoType: (% lang="en-US" %)[(% style="color:#000000; font-family:Liberation Serif,serif; font-size:12pt; font-style:normal; font-variant:normal; font-weight:normal" %)0 – Клиент, 1 – Партнер, 2 – Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - договор(% style="color:#000000" %)]
++
++
  (% class="box" style="text-align: center;" %)
  (((
  (% style="color:#000000; font-size:14pt" %)**Раздел Пользователи**
@@ -142,7 +142,7 @@
      "kind": "",  ~/~/ тип аутентификации (None - выключена, Email - по email)
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
      "groups": "" ,  ~/~/ группы пользователя, названия групп
--}
++    }
  (% style="text-align:left" %)
  (% style="color:#000000; font-weight:normal" %)Ответ:
@@ -170,7 +170,7 @@
      "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
  (% style="text-align:left" %)
--(% style="color:#000000; font-weight:normal" %)}
++(% style="color:#000000; font-weight:normal" %)    }
  (% class="box successmessage" %)
@@ -186,10 +186,8 @@
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]]
--(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса.
++(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON):
--(% style="color:#000000" %)Параметры в теле запроса (JSON):
--
  (% style="color:#000000" %){
    "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303",  ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента
@@ -197,7 +197,7 @@
    "login": "qqqqqq",  ~/~/ Логин пользователя, по которому фильтруется, null - неважно
    "email": "eee",  ~/~/ Email пользователя, по которому фильтруется, null - неважно
--(% style="color:#000000" %)}
++(% style="color:#000000" %)  }
  (% style="color:#000000" %)Ответ:
@@ -217,7 +217,7 @@
      "status": "1",  ~/~/ статус пользователя
      "astLogged": "", ~/~/ дата/время последней авторизации
--(% style="color:#000000" %)}
++(% style="color:#000000" %)    }
  (% class="box warningmessage" %)
@@ -260,16 +260,16 @@
      "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
  (% 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" %)//    //__}__
  (% 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" %){
++(% 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": "" ,  ~/~/ должность
@@ -285,10 +285,10 @@
      "doubleAuth": "" ,  ~/~/ параметры двухфакторной аутентификации
      "kind": "" ,  ~/~/ тип аутентификации
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
--    "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
++    "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя//
  (% 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" %)//    //}
  (% class="box warningmessage" %)
@@ -302,7 +302,7 @@
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/status/>>url:https://hosting.glonasssoft.ru/api/v3/users/status/]](% style="color:#000000" %){id}
--(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid пользователя
++(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
@@ -314,7 +314,7 @@
      "description": "" ,  ~/~/ описание
      "data": "" ,  ~/~/ данные, связанные со сменой статуса
--(% style="color:#000000" %)}
++    (% style="color:#000000" %)}
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**
@@ -331,7 +331,7 @@
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/>>url:https://hosting.glonasssoft.ru/api/v3/users/]](% style="color:#000000" %){id}
--(% style="color:#000000" %)Параметр запроса: {**__id__**} - Guid пользователя
++(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
@@ -355,13 +355,13 @@
  (% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов;
--(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«__Просмотр заданий на техобслуживание__»**.
++(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«Просмотр заданий на техобслуживание»**.
  (% style="color:#000000" %)Метод запроса: **GET**
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %)<(% lang="en-US" %)v(%%)ehicleID>
--(% style="color:#000000" %)Параметр запроса: <__**vehicleid**__> - идентификатор объекта (опционально)
++(% style="color:#000000" %)Параметр запроса: <vehicleid> - идентификатор объекта (опционально)
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
@@ -382,7 +382,7 @@
      "unitName": "" ,  ~/~/ наименование подразделения
      "status": "" ,  ~/~/ статус объекта
--}
++    }
  (% style="text-align:left" %)
  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
@@ -424,7 +424,7 @@
        "mileageEnabled": true,  ~/~/ флаг активности счётчика "пробег"
        "motohours": "" ,  ~/~/ моточасы
        "motohoursEnabled": true  ~/~/ флаг активности счётчика "моточасы"
--      },
++    },
      "cmsv6Parameters": { ~/~/ параметры CMSv6
        "enabled": true,  ~/~/ флаг включения
        "id": "" ,  ~/~/ идентификатор
@@ -431,7 +431,7 @@
        "host": "" ,  ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
        "login": "" ,  ~/~/ имя учетной записи
        "password": ""   ~/~/ пароль учетной записи
--      },
++     },
      "inspectionTasks":  ~/~/ задания на ТО
        {
        "enabled": "" ,  ~/~/ Признак включения
@@ -469,7 +469,7 @@
      "motohoursEnabled": true,
      "mileage": "",
      "motohours": 345.0
--    },
++  },
   "cmsv6Parameters": { ~/~/Параметры CmsV6
      "id": null,
      "enabled": true, ~/~/флаг включения
@@ -476,7 +476,7 @@
      "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
      "login": "", ~/~/ имя учетной записи
      "password": "" ~/~/ пароль учетной записи
--    },
++  },
    "inspectionTasks": { ~/~/ задания на ТО
      "id": "", ~/~/ ID задачи
      "enabled": false, ~/~/ Признак включения
@@ -489,7 +489,7 @@
      "periodicCondition": "", ~/~/ Условие периодичности по времени
      "kind": "", ~/~/ Вид периодичности по времени
      "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
--    }
++     }
  (% style="text-align:left" %)
  (% style="color:#000000" %)}
@@ -593,7 +593,7 @@
    "overwrite": false, ~/~/ Флаг перезаписи
    "stage": "", ~/~/ Состояние, может быть null
--(% style="color:#000000" %)}
++  (% style="color:#000000" %)}
  (% style="color:#000000" %)Ответ:
@@ -607,7 +607,7 @@
    "stage": "", ~/~/ Состояние
  (% style="text-align:left" %)
--(% style="color:#000000" %)  }
++(% style="color:#000000" %)}
  (% class="box warningmessage" %)
@@ -625,7 +625,7 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON):
--(% style="color:#000000" %){
++(% style="color:#000000" %) {
  (% style="color:#000000" %)    "vehicleId": "", ~/~/ ID ТС
      "parentId": "", ~/~/ ID клиента
@@ -666,7 +666,7 @@
              "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает)
              "kind": "", ~/~/ Вид периодичности по времени
              "maxQuantity": "", ~/~/ Сколько раз выполнить задание
--            }
++        }
  (% style="color:#000000" %)}
@@ -673,54 +673,9 @@
  (% 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}**
@@ -758,15 +758,16 @@
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
--(% style="color:#000000" %)Ответ:
++(% style="color:#000000" %)Ответ: [
--(% style="color:#000000" %){
++(% class="western" %)
++{{{ {
++      "deviceTypeId" : "", // ID типа устройства
++        "deviceTypeName" : "" // Название типа устройства
++    },}}}
--    "deviceTypeId" : "", ~/~/ ID типа устройства
--    "deviceTypeName" : "" ~/~/ Название типа устройства
--
  (% style="text-align:left" %)
--(% style="color:#000000" %)}
++(% style="color:#000000" %)…** **]
  (% class="box" style="text-align: center;" %)
@@ -787,16 +787,19 @@
  (% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации
--(% style="color:#000000" %)Ответ:
++(% style="color:#000000" %)Ответ: [
--(% style="color:#000000" %){
++(% class="western" style="margin-bottom:19px" %)
++{{{   {}}}
--    "id": "", ~/~/ ID типа датчика
--    "name": "", ~/~/ Название
--    "description": "", ~/~/ Описание
++(% style="color:#000000" %)«id»: «», //ID типа датчика «name»: «», //Название
++(% class="western" %)
++{{{        "description": "" // Описание
++    },}}}
++
  (% style="text-align:left" %)
--(% style="color:#000000" %)}
++(% style="color:#000000" %)… ]
  (% class="box" lang="en-US" style="text-align: center;" %)

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

Summary

Details

Меню