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 < 22.7 >

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

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,14 +99,11 @@
      "parentId": "",  ~/~/ идентификатор клиента-родителя
      "name": "",  ~/~/ наименование клиента
      "fullName": "",  ~/~/ полное наименование клиента
--    "agentInfoType": "",  ~/~/ тип клиента1
++    "agentInfoType": "",  ~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)
      "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" %)**Раздел Пользователи**
@@ -145,7 +145,7 @@
      "kind": "",  ~/~/ тип аутентификации (None - выключена, Email - по email)
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
      "groups": "" ,  ~/~/ группы пользователя, названия групп
--    }
++}
  (% style="text-align:left" %)
  (% style="color:#000000; font-weight:normal" %)Ответ:
@@ -173,7 +173,7 @@
      "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
  (% style="text-align:left" %)
--(% style="color:#000000; font-weight:normal" %)    }
++(% style="color:#000000; font-weight:normal" %)}
  (% class="box successmessage" %)
@@ -189,8 +189,10 @@
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]]
--(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON):
++(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса.
++(% style="color:#000000" %)Параметры в теле запроса (JSON):
++
  (% style="color:#000000" %){
    "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303",  ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента
@@ -198,7 +198,7 @@
    "login": "qqqqqq",  ~/~/ Логин пользователя, по которому фильтруется, null - неважно
    "email": "eee",  ~/~/ Email пользователя, по которому фильтруется, null - неважно
--(% style="color:#000000" %)  }
++(% style="color:#000000" %)}
  (% style="color:#000000" %)Ответ:
@@ -218,7 +218,7 @@
      "status": "1",  ~/~/ статус пользователя
      "astLogged": "", ~/~/ дата/время последней авторизации
--(% style="color:#000000" %)    }
++(% style="color:#000000" %)}
  (% class="box warningmessage" %)
@@ -261,16 +261,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": "" ,  ~/~/ должность
@@ -286,10 +286,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" %)
@@ -303,7 +303,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: Токен авторизации
@@ -315,7 +315,7 @@
      "description": "" ,  ~/~/ описание
      "data": "" ,  ~/~/ данные, связанные со сменой статуса
--    (% style="color:#000000" %)}
++(% style="color:#000000" %)}
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**
@@ -332,7 +332,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: Токен авторизации
@@ -356,13 +356,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: Токен авторизации
@@ -383,7 +383,7 @@
      "unitName": "" ,  ~/~/ наименование подразделения
      "status": "" ,  ~/~/ статус объекта
--    }
++}
  (% style="text-align:left" %)
  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
@@ -425,7 +425,7 @@
        "mileageEnabled": true,  ~/~/ флаг активности счётчика "пробег"
        "motohours": "" ,  ~/~/ моточасы
        "motohoursEnabled": true  ~/~/ флаг активности счётчика "моточасы"
--    },
++      },
      "cmsv6Parameters": { ~/~/ параметры CMSv6
        "enabled": true,  ~/~/ флаг включения
        "id": "" ,  ~/~/ идентификатор
@@ -432,7 +432,7 @@
        "host": "" ,  ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
        "login": "" ,  ~/~/ имя учетной записи
        "password": ""   ~/~/ пароль учетной записи
--     },
++      },
      "inspectionTasks":  ~/~/ задания на ТО
        {
        "enabled": "" ,  ~/~/ Признак включения
@@ -470,7 +470,7 @@
      "motohoursEnabled": true,
      "mileage": "",
      "motohours": 345.0
--  },
++    },
   "cmsv6Parameters": { ~/~/Параметры CmsV6
      "id": null,
      "enabled": true, ~/~/флаг включения
@@ -477,7 +477,7 @@
      "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6
      "login": "", ~/~/ имя учетной записи
      "password": "" ~/~/ пароль учетной записи
--  },
++    },
    "inspectionTasks": { ~/~/ задания на ТО
      "id": "", ~/~/ ID задачи
      "enabled": false, ~/~/ Признак включения
@@ -490,7 +490,7 @@
      "periodicCondition": "", ~/~/ Условие периодичности по времени
      "kind": "", ~/~/ Вид периодичности по времени
      "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
--     }
++    }
  (% style="text-align:left" %)
  (% style="color:#000000" %)}
@@ -521,12 +521,14 @@
  (% style="color:#000000" %)В заголовках запроса:
--(% style="color:#000000" %)− Content-Type: application/json
++(% style="color:#000000" %)− Content-Type: __**application/json**__
  (% style="color:#000000" %)− X-Auth: Токен авторизации
--(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON):
++(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса.
++(% style="color:#000000" %)Параметры в теле запроса (JSON):
++
  (% class="western" style="color:#000000" %)##{##
  (% class="western" style="color:#000000" %)##    "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально)
@@ -538,7 +538,7 @@
      "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)##(%%)
  (% style="color:#000000" %)}
--(% style="color:#000000" %)          Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
++(% style="color:#000000" %)          Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
  (% style="color:#000000" %)Ответ:
@@ -561,8 +561,10 @@
      "createdAt": "" ~/~/ дата создания объектов  (%%)
  (% style="color:#000000" %)}
--(% style="color:#000000" %)          Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
++(% style="color:#000000" %)          Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.
++(% style="color:#000000" %)Параметр «__**status**__» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
++
 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
@@ -594,7 +594,7 @@
    "overwrite": false, ~/~/ Флаг перезаписи
    "stage": "", ~/~/ Состояние, может быть null
--  (% style="color:#000000" %)}
++(% style="color:#000000" %)}
  (% style="color:#000000" %)Ответ:
@@ -608,7 +608,7 @@
    "stage": "", ~/~/ Состояние
  (% style="text-align:left" %)
--(% style="color:#000000" %)}
++(% style="color:#000000" %)  }
  (% class="box warningmessage" %)
@@ -626,7 +626,7 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON):
--(% style="color:#000000" %) {
++(% style="color:#000000" %){
  (% style="color:#000000" %)    "vehicleId": "", ~/~/ ID ТС
      "parentId": "", ~/~/ ID клиента
@@ -667,7 +667,7 @@
              "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает)
              "kind": "", ~/~/ Вид периодичности по времени
              "maxQuantity": "", ~/~/ Сколько раз выполнить задание
--        }
++            }
  (% style="color:#000000" %)}
@@ -674,7 +674,7 @@
  (% 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" %){
  (% lang="en-US" style="text-align:left" %)
      "vehicleId": "", ~/~/ ID ТС
@@ -759,16 +759,15 @@
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
--(% style="color:#000000" %)Ответ: [
++(% style="color:#000000" %)Ответ:
--(% class="western" %)
--{{{ {
--      "deviceTypeId" : "", // ID типа устройства
--        "deviceTypeName" : "" // Название типа устройства
--    },}}}
++(% style="color:#000000" %){
++    "deviceTypeId" : "", ~/~/ ID типа устройства
++    "deviceTypeName" : "" ~/~/ Название типа устройства
++
  (% style="text-align:left" %)
--(% style="color:#000000" %)…** **]
++(% style="color:#000000" %)}
  (% class="box" style="text-align: center;" %)
@@ -789,19 +789,16 @@
  (% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации
--(% style="color:#000000" %)Ответ: [
++(% style="color:#000000" %)Ответ:
--(% class="western" style="margin-bottom:19px" %)
--{{{   {}}}
++(% style="color:#000000" %){
--(% style="color:#000000" %)«id»: «», //ID типа датчика «name»: «», //Название
++    "id": "", ~/~/ ID типа датчика
++    "name": "", ~/~/ Название
++    "description": "", ~/~/ Описание
--(% 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

Меню