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

Last modified by Андрей Калиновский on 2025/02/25 16:35

From version < 33.1 >

edited by Андрей Калиновский
on 2022/11/01 10:34

To version < 59.1 >

edited by Илья Крайнов
on 2022/11/24 11:31

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.krainovim

Content

@@ -1,13 +1,12 @@
  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
  == Описание ГЛОНАССSoft Public API 3.0 ==
--==   ==
--(% class="box" style="text-align: center;" %)
--(((
--(% style="color:#000000; font-size:18.6667px" %)**Действующие ограничения**
--)))
++{{toc/}}
++
++=== (% style="color:#000000; font-size:18.6667px" %)**Действующие ограничения**(%%) ===
++
  (% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов).
  (% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять __**X-Auth**__ (токен авторизации, получаемый методом __**auth/login**__).
@@ -15,18 +15,13 @@
  Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de.
--(% class="box" style="text-align: center;" %)
--(((
--(% style="color:#000000; font-size:14pt" %)**Раздел Авторизация**
--)))
++==== (% style="color:#000000; font-size:14pt" %)**Раздел Авторизация**(%%) ====
--(% class="box successmessage" %)
--(((
-- (% style="color:#000000; line-height:100%" %)**Авторизация **(% style="color:#000000" %)**— **(% lang="en-US" %)**POST /api/v3/auth/login**
--)))
--(% style="color:#000000" %)          Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль.
++===== (% style="color:#000000; line-height:100%" %)**Авторизация **(% style="color:#000000" %)**— **(% lang="en-US" %)**POST /api/v3/auth/login**(%%) =====
++(% style="color:#000000" %)Метод позволяет получить токен авторизации, который необходимо добавлять в заголовок для работы со всеми методами API. В параметрах метода передается имя пользователя и пароль.
++
  (% style="color:#000000" %)Метод запроса: **POST**
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login>>https://hosting.glonasssoft.ru/api/v3/auth/login]]
@@ -111,6 +111,148 @@
  }
++(% class="box successmessage" %)
++(((
++**Добавление клиента —  POST /api/v3/agents **
++)))
++
++Метод позволяет добавить клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
++
++Метод запроса: **POST**
++
++URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]
++
++В заголовках запроса: X-Auth: Токен авторизации
++
++Параметры в теле запроса (JSON):
++
++{
++   "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя
++  "name": "string", ~/~/ имя
++  "fullName": "string", ~/~/ полное наименование
++  "isForeign": true, ~/~/ иностранный контрагент
++  "district": "string", ~/~/ округ
++  "region": "string", ~/~/ регион
++  "city": "string", ~/~/ город
++  "inn": "string", ~/~/ ИНН
++  "kpp": "string", ~/~/ КПП
++  "address": "string", ~/~/ юридический адрес
++  "addressFact": "string", ~/~/ фактический адрес
++  "email": "string", ~/~/ email
++  "director": "string", ~/~/ ФИО руководителя
++  "bankName": "string", ~/~/ банк
++  "bankBIK": "string", ~/~/ БИК
++  "bankRS": "string", ~/~/ номер счёта
++  "bankKS": "string" ~/~/ корр. счёт
++}
++
++
++Ответ:
++
++{
++  "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
++  "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя
++  "name": "string", ~/~/ имя
++  "fullName": "string", ~/~/ полное наименование
++  "isForeign": true, ~/~/ иностранный контрагент
++  "district": "string", ~/~/ округ
++  "region": "string", ~/~/ регион
++  "city": "string", ~/~/ город
++  "inn": "string", ~/~/ ИНН
++  "kpp": "string", ~/~/ КПП
++  "address": "string", ~/~/ юридический адрес
++  "addressFact": "string", ~/~/ фактический адрес
++  "email": "string", ~/~/ email
++  "director": "string", ~/~/ ФИО руководителя
++  "bankName": "string", ~/~/ банк
++  "bankBIK": "string", ~/~/ БИК
++  "bankRS": "string", ~/~/ номер счёта
++  "bankKS": "string" ~/~/ корр. счёт
++}
++
++
++(% class="box warningmessage" %)
++(((
++**Редактирование клиента — PUT /api/v3/agents**
++)))
++
++Метод позволяет отредактировать клиента, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
++
++Метод запроса: **PUT**
++
++URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents>>https://hosting.glonasssoft.ru/api/v3/agents]]
++
++В заголовках запроса: X-Auth: Токен авторизации
++
++
++Параметры в теле запроса (JSON):
++
++{
++  "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
++  "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя
++  "name": "string", ~/~/ имя
++  "fullName": "string", ~/~/ полное наименование
++  "isForeign": true, ~/~/ иностранный контрагент
++  "district": "string", ~/~/ округ
++  "region": "string", ~/~/ регион
++  "city": "string", ~/~/ город
++  "inn": "string", ~/~/ ИНН
++  "kpp": "string", ~/~/ КПП
++  "address": "string", ~/~/ юридический адрес
++  "addressFact": "string", ~/~/ фактический адрес
++  "email": "string", ~/~/ email
++  "director": "string", ~/~/ ФИО руководителя
++  "bankName": "string", ~/~/ банк
++  "bankBIK": "string", ~/~/ БИК
++  "bankRS": "string", ~/~/ номер счёта
++  "bankKS": "string" ~/~/ корр. счёт
++}
++
++
++Ответ:
++
++{
++  "agentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента
++  "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя
++  "name": "string", ~/~/ имя
++  "fullName": "string", ~/~/ полное наименование
++  "isForeign": true, ~/~/ иностранный контрагент
++  "district": "string", ~/~/ округ
++  "region": "string", ~/~/ регион
++  "city": "string", ~/~/ город
++  "inn": "string", ~/~/ ИНН
++  "kpp": "string", ~/~/ КПП
++  "address": "string", ~/~/ юридический адрес
++  "addressFact": "string", ~/~/ фактический адрес
++  "email": "string", ~/~/ email
++  "director": "string", ~/~/ ФИО руководителя
++  "bankName": "string", ~/~/ банк
++  "bankBIK": "string", ~/~/ БИК
++  "bankRS": "string", ~/~/ номер счёта
++  "bankKS": "string" ~/~/ корр. счёт
++}
++
++
++(% class="box errormessage" %)
++(((
++**Удаление клиента — DELETE /api/v3/agents/{clientId}**
++)))
++
++
++Метод позволяет удалить клиента, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации «**X-Auth**»).
++
++Метод запроса: **DELETE**
++
++URL запроса: [[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents/>>https://hosting.glonasssoft.ru/api/v3/agents/]]**{clientId}**
++
++Параметр запроса: **{clientId}** - Guid пользователя
++
++В заголовках запроса: X-Auth: Токен авторизации
++
++Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
++
++
++
  (% class="box" style="text-align: center;" %)
  (((
  (% style="color:#000000; font-size:14pt" %)**Раздел Пользователи**
@@ -137,9 +137,9 @@
      "position": "",  ~/~/ должность
      "phone": "",  ~/~/ телефон
      "organization": "",  ~/~/ организация
--    "login": "",  ~/~/ логин
--    "password": "",  ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо)
--    "email": "",  ~/~/ email
++    "login": "",  ~/~/ логин (обязателен)
++    "password": "",  ~/~/ пароль (обязателен)
++    "email": "",  ~/~/ email (обязателен)
      "description": "",  ~/~/ описание
      "isEnabled": "",  ~/~/ признак включения
      "parentId": "",  ~/~/ Guid родительского агента
@@ -148,7 +148,7 @@
      "doubleAuth": "" ,  ~/~/ параметры двухфакторной аутентификации
      "kind": "",  ~/~/ тип аутентификации (None - выключена, Email - по email)
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
--    "groups": "" ,  ~/~/ группы пользователя, названия групп
++    "groups": ["", ""] ,  ~/~/ группы пользователя, перечисление названия групп (data-row)
  }
  (% style="text-align:left" %)
@@ -174,7 +174,7 @@
      "doubleAuth": "" ,  ~/~/ параметры двухфакторной аутентификации
      "kind": "" ,  ~/~/ тип аутентификации
      "target": "" ,  ~/~/ в случае аутентификации по email - email-адрес
--    "groups": "" ,  ~/~/ группы пользователя, «user» названия группы пользователя
++    "groups": (% style="color:#000000" %)["", ""] (% style="color:#000000; font-weight:normal" %),  ~/~/ роли пользователя, перечислены названия групп пользователя
  (% style="text-align:left" %)
  (% style="color:#000000; font-weight:normal" %)}
@@ -227,6 +227,54 @@
  (% style="color:#000000" %)}
++(% class="box successmessage" %)
++(((
++(% style="color:#000000; line-height:100%" %)**Получение информации о пользователе — **(% lang="en-US" %)**GET /api/v3/users/{GUID}**
++)))
++
++(% style="color:#000000" %)           Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользователе предоставляется при наличии права **«__Просмотр пользователей__»**.
++
++(% style="color:#000000" %)Метод запроса: **GET**
++
++(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/(% lang="en-US" %)users/{GUID}>>https://hosting.glonasssoft.ru/api/v3/users/{GUID}]]
++
++(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++
++(% style="color:#000000" %)Ответ:
++
++(((
++(((
++{
++    "id": "", ~/~/ GUID пользователя
++    "lastName": "", ~/~/ Фамилия
++    "firstName": "", ~/~/ Имя
++    "position": "", ~/~/ Должность
++    "phone": "", ~/~/ Номер телефона
++    "parentId": "", ~/~/ GUID клиента, которому принадлежит пользователь
++    "parentName": "", Наименование клиента, которому принадлежит пользователь
++    "organization": "", ~/~/ Организация
++    "login": "", ~/~/ Логин пользователя
++    "email": "", ~/~/ Адрес электронной почты
++    "language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
++    "isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено
++    "description": "", ~/~/ Описание
++    "isEnabled": , ~/~/ Включен, true - включен, false - отключен
++    "doubleAuth": , ~/~/ Состояние двухэтапной аутентификации, true - включен, false - отключен
++    "doubleAuthEmail": "", ~/~/ Адрес электронной почты двухэтапной аутентификации
++    "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен
++    "sessionDuration": 30, ~/~/ Длительность сессии в минутах
++    "status": 0, ~/~/ Статус пользователя, 0 - новый, 1 - подтвержден, 2 - активен, 3 - уточнить, 4 - блокирован
++    "lastLogged": "2022-08-22T06:57:51.002129Z", ~/~/ Дата и время последнего входа пользователя
++    "groups": [], ~/~/ Список ролей пользователя
++    "customGroups": [], ~/~/ Список клиентских ролей пользователя
++    "authDevices": [ ], ~/~/ Список авторизованных устройств
++    "mobileDoubleAuthDevices": [], ~/~/ Список авторизованных мобильных устройств
++    "pushNotificationsDevices": [] ~/~/ Список мобильных устройств которые были подписаны на мобильные уведомления
++}
++)))
++)))
++
++
  (% class="box warningmessage" %)
  (((
  (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users**
@@ -240,6 +240,8 @@
  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++**При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!**
++
  (% lang="en-US" style="text-align:left" %)
  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON):
@@ -253,10 +253,10 @@
      "position": "" ,  ~/~/ должность
      "phone": "" ,  ~/~/ телефон
      "organization": "" ,  ~/~/ организация
--    "login": "" ,  ~/~/ логин
--    "password": "" ,  ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо)
--    "email": "" ,  ~/~/ email
--    "description": "" ,  ~/~/ описание
++    "login": "" ,  ~/~/ логин   (% style="color:#000000" %)(Если null - менять не надо)(%%)
++(% lang="ru-RU" style="color:#000000; font-weight:normal" %)    "password": "" ,  ~/~/ пароль (Если null - менять не надо)
++    "email": "" ,  ~/~/ email   (% style="color:#000000" %)(Если null - менять не надо)(%%)
++(% lang="ru-RU" style="color:#000000; font-weight:normal" %)    "description": "" ,  ~/~/ описание
      "isEnabled": "" ,  ~/~/ признак включения
      "parentId": "" ,  ~/~/ Guid родительского агента
      "leaderId": "" ,  ~/~/ Guid руководителя (null - не задан)
@@ -369,6 +369,7 @@
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**(%%)
  \\(% style="color:#000000" %)__Для двух, описанных выше, методов если не получилось выполнить включение или отключение некоторых пользователей из переданного списка возвращается ответ - 206 Partial Content__
++(((
  В теле ответа:
  {
      "errorMessages": [
@@ -381,6 +381,7 @@
  \\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями.
  "users" - массив id пользователей, которых не удалось включить или отключить.
++)))
  (% class="box errormessage" %)
  (((
@@ -429,22 +429,44 @@
  (% style="color:#000000" %)Ответ:
--(% style="color:#000000" %){
--
--    "vehicleId": "" ,  ~/~/ идентификатор объекта
--    "name": "" ,  ~/~/ имя объекта
--    "imei": "" ,  ~/~/ IMEI объекта
--    "deviceTypeId": "" ,  ~/~/ идентификатор устройства объекта
--    "deviceTypeName": "" ,  ~/~/ наименование устройства объекта
--    "parentId": "" ,  ~/~/ идентификатор клиента-родителя
--    "parentName": "" ,  ~/~/ наименование клиента-родителя,
--    "modelId": "" ,  ~/~/ идентификатор модели объекта
--    "modelName": "" ,  ~/~/ наименование модели объекта,
--    "unitId": "" ,  ~/~/ идентификатор подразделения
--    "unitName": "" ,  ~/~/ наименование подразделения
--    "status": "" ,  ~/~/ статус объекта
--
++(((
++{
++    "vehicleId": "", ~/~/ ID объекта
++    "name": "", ~/~/ Имя объекта
++    "imei": "", ~/~/ IMEI объекта
++    "deviceTypeId": , ~/~/ ID типа устройства
++    "deviceTypeName": "", ~/~/ Название типа устройства
++    "sim1": "", ~/~/ Номер SIM1
++    "parentId": "", Номер SIM2
++    "parentName": "", Наименование клиента-родителя
++    "modelId": "", ID модели объекта
++    "modelName": "", Имя модели объекта
++    "createdAt": "", Дата создания объекта
++    "mileageCalcMethod": "", Выбранный метод расчета пробега
++    "counters": { ~/~/ Нормы
++        "mileageEnabled": "", ~/~/ Флаг активности счётчика "Пробег" (true - включен, false - отключен)
++        "motohoursEnabled": "", ~/~/ флаг активности счётчика "Моточасы" (true - включен, false - отключен)
++        "mileage": "", ~/~/ Пробег по нормам в метрах
++        "motohours": "" ~/~/ Моточасы по нормам, в секундах
++    },
++    "inspectionTasks": [ ~/~/ Задания на тех. обслуживание
++        {
++            "id": "", ~/~/ ID  задания
++            "enabled": "", ~/~/ Флаг активности задания (true - включен, false - отключен)
++            "name": "", ~/~/ Наименование задания
++            "description": "", ~/~/ Описание задания
++            "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает)
++            "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно)
++            "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает)
++            "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно)
++            "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает)
++            "kind": "", ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает)
++            "lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано)
++            "maxQuantity": ""   ~/~/ Сколько раз выполнить задание (null - однократно)
++        }
++    ]
  }
++)))
  (% style="text-align:left" %)
  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
@@ -605,17 +605,17 @@
  (% style="color:#000000" %)Параметры в теле запроса (JSON):
--(% 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, опционально)
++    "customFields": null ~/~/ значение любого из произвольных полей ТС
++}
--(% 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" %)}
--
  (% style="color:#000000" %)          Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
  (% style="color:#000000" %)Ответ:
@@ -638,7 +638,16 @@
      "status": "" ~/~/ статус объекта         (%%)(-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика,
                                                             ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан,
                                                            ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется)
--(% style="color:#000000" %)    "createdAt": "" ~/~/ дата создания объектов  (%%)
++(% style="color:#000000" %)    "createdAt": "" ~/~/ дата создания объектов
++    "customFields": [
++            {
++                "id": "", ~/~/ идентификатор произвольного поля
++                "name": "", ~/~/ имя произвольного поля
++                "value": "", ~/~/ значение произвольного поля
++                "forClient": true, ~/~/ право на отображение у клиента
++                "forTooltip": false, ~/~/ право на отображение в подсказке
++                "forReport": false ~/~/ право на отображение в отчетах
++            }(%%)
  (% style="color:#000000" %)}
  (% style="color:#000000" %)          Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.
@@ -732,8 +732,8 @@
          {
           "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег»
           "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы»
--         "mileage": «», пробег
--         "motohours": «» моточасы
++         "mileage": "", ~/~/ пробег, в метрах
++         "motohours": "" ~/~/ моточасы, в секундах
          }
          "cmsv6Parameters": ~/~/  параметры CMSv6
          {

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

Summary

Details

Меню