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

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

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" %)
@@ -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»**
@@ -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" %)}
@@ -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

Меню