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

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

From version < 76.2 >

edited by Илья Крайнов
on 2023/03/14 14:15

To version < 66.7 >

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -1,14 +1,13 @@
  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
--(((
--**Содержание страницы:**
--)))
++= Описание ГЛОНАССSoft Public API 3.0 =
++
  {{toc/}}
  = (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) =
--(% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов).
++(% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов).
  (% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять __**X-Auth**__ (токен авторизации, получаемый методом __**auth/login**__).
@@ -16,8 +16,10 @@
  (% style="color:#000000" %)− (%%)При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) =
++
  == (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) ==
  (% class="box infomessage" %)
@@ -38,9 +38,9 @@
  (% style="color:#000000" %){
      "login": "testuser",
      "password": "testuser"
--}
++}(%%)
++
--
  (% style="color:#000000" %)**Ответ:**
  (% lang="en-US" %)
@@ -55,6 +55,7 @@
  **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется.
++
  == (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) ==
  (% class="box infomessage" %)
@@ -73,58 +73,18 @@
  (% lang="en-US" %)
  (% style="color:#000000" %)**Ответ: В случае если сессия активна HTTP ответ «200». В случае если сессия разорвана HTTP ответ «401».**
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Клиенты**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Получение информации о клиенте**(%%) ==
--(% class="box infomessage" %)
--(((
--**GET api/v3/agents/{id}**
--)))
++== (% style="color:#000000; font-size:16px" %)**Получение основных параметров клиента**(%%) ==
--Метод позволяет получить параметры выбранного клиента(% style="color:#000000" %): наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
--
--(% style="color:#000000" %)− информация о клиенте предоставляется при наличии права «Просмотр клиентов»;
--
--(% style="color:#000000" %)Метод запроса: **GET**
--
--(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/agents/{id}
--
--Запрос должен содержать данные параметра "**agentId**"
--
--(% style="color:#000000" %)Ответ:
--
--{
--    "agentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента    (%%)
--    "parentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента-родителя(%%)
--    "parentName": "string", ~/~/ наименование (% style="color:#000000" %)клиента-родителя(%%)
--    "name": "string", (% style="color:#000000" %)~/~/ наименование клиента  (%%)
--    "fullName": "string", (% style="color:#000000" %)~/~/ полное наименование клиента(%%)
--    "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%)
--    "isForeign": true/false, ~/~/ Иностранный контрагент
--    "district": "string", ~/~/ округ
--    "region": "string", ~/~/ регион
--    "city": "string", ~/~/ город
--    "inn": "string", ~/~/ ИНН клиента
--    "kpp": "string", ~/~/ КПП клиента
--    "address": "string", ~/~/ юридический адрес
--    "addressFact": "string", ~/~/ фактический адрес
--    "email": "string", ~/~/ почта
--    "director": "string", ~/~/ ФИО руководителя
--    "bankName": "string", ~/~/ Банк
--    "bankBIK": "string", ~/~/ БИК
--    "bankRS": "string", ~/~/ Номер счета
--    "bankKS": "string" ~/~/ Корр. счет
--  }
--
--== (% style="color:#000000; font-size:16px" %)**Получение параметров дочерних клиентов**(%%) ==
--
  (% class="box infomessage" %)
  (((
--(% lang="en-US" %)**POST **(%%)**/(% lang="en-US" %)api/v3/agents/find(%%)**
++(% lang="en-US" %)**GET **(%%)**/(% lang="en-US" %)api/v3/agents(%%)**
  )))
--(% style="color:#000000" %)Метод позволяет получить параметры всех дочерних клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя и т.д. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
++(% style="color:#000000" %)Метод позволяет получить основные параметры клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**):
  (% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»;
@@ -132,30 +132,28 @@
  (% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__».
--(% style="color:#000000" %)Метод запроса: **POST**
++(% style="color:#000000" %)Метод запроса: **GET**
--(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/agents/find
++(% 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" %)Параметр запроса:
++(% style="color:#000000" %)Параметр запроса: <__**parentId**__> - идентификатор клиента-родителя (опционально)
--(% style="color:#000000" %){
--  "parentId": "string"
--}
++(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
  (% style="color:#000000" %)Ответ:
--{
--    "agentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента    (%%)
--    "parentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента-родителя(%%)
--    "parentName": "string", ~/~/ наименование (% style="color:#000000" %)клиента-родителя(%%)
--    "name": "string", (% style="color:#000000" %)~/~/ наименование клиента  (%%)
--    "fullName": "string", (% style="color:#000000" %)~/~/ полное наименование клиента(%%)
--    "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)
--    "status": "",~/~/ статус клиента (0- Новый, 1 - Потенциальный, 2 - В разработке, 3 - Тест, 4 - На оформлении, 5 - Внедрение, 6 - Работает, 7 - Работал, 8 - Потерян, 9 - Отказ)
++(% style="color:#000000" %){
++    "agentId": "",  ~/~/ идентификатор клиента
++    "parentId": "",  ~/~/ идентификатор клиента-родителя
++    "name": "",  ~/~/ наименование клиента
++    "fullName": "",  ~/~/ полное наименование клиента
++    "agentInfoType": "",  ~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)
++    "status": "",  ~/~/ статус клиента (0- Новый, 1 - Потенциальный, 2 - В разработке, 3 - Тест, 4 - На оформлении, 5 - Внедрение, 6 - Работает, 7 - Работал, 8 - Потерян, 9 - Отказ)
  }
--== (% style="color:#000000; font-size:16px" %)**Добавление клиента**(%%) ==
++== (% style="color:#000000, font-size:14px" %)**Добавление клиента**(%%) ==
++
  (% class="box successmessage" %)
  (((
  **POST /api/v3/agents **
@@ -175,7 +175,6 @@
     "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя
    "name": "string", ~/~/ имя
    "fullName": "string", ~/~/ полное наименование
--  "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%)
    "isForeign": true, ~/~/ иностранный контрагент
    "district": "string", ~/~/ округ
    "region": "string", ~/~/ регион
@@ -200,7 +200,6 @@
    "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя
    "name": "string", ~/~/ имя
    "fullName": "string", ~/~/ полное наименование
--  "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%)
    "isForeign": true, ~/~/ иностранный контрагент
    "district": "string", ~/~/ округ
    "region": "string", ~/~/ регион
@@ -217,8 +217,9 @@
    "bankKS": "string" ~/~/ корр. счёт
  }
--== (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) ==
++== (% style="color:#000000, font-size:14px" %)**Редактирование клиента**(%%) ==
++
  (% class="box warningmessage" %)
  (((
  **PUT /api/v3/agents**
@@ -280,8 +280,9 @@
    "bankKS": "string" ~/~/ корр. счёт
  }
--== (% style="color:#000000; font-size:16px" %)**Удаление клиента**(%%) ==
++== (% style="color:#000000, font-size:14px" %)**Удаление клиента**(%%) ==
++
  (% class="box errormessage" %)
  (((
  **DELETE /api/v3/agents/{clientId}**
@@ -299,10 +299,12 @@
  Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Пользователи**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Добавление пользователя**(%%) ==
++== (% style="color:#000000; line-height:14px" %)**Добавление пользователя**(%%) ==
++
  (% class="box successmessage" %)
  (((
  (% lang="en-US" %)**POST /api/v3/users**
@@ -366,9 +366,10 @@
  (% style="text-align:left" %)
  (% style="color:#000000; font-weight:normal" %)}
--== (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) ==
--(% class="box infomessage" %)
++== (% style="color:#000000; font-size:14px" %)**Получение списка пользователей**(%%) ==
++
++(% class="box successmessage" %)
  (((
  (% lang="en-US" %)**POST /api/v3/users/find**
  )))
@@ -414,9 +414,10 @@
  (% style="color:#000000" %)}
--== (% style="color:#000000; font-size:16px" %)**Получение информации о пользователе**(%%) ==
--(% class="box infomessage" %)
++== (% style="color:#000000; font-size:14px" %)**Получение информации о пользователе**(%%) ==
++
++(% class="box successmessage" %)
  (((
  (% lang="en-US" %)**GET /api/v3/users/{GUID}**
  )))
@@ -463,8 +463,9 @@
  )))
  )))
--== (% style="color:#000000; font-size:16px" %)**Редактирование пользователя**(%%) ==
++== (% style="color:#000000; font-size:14px" %)**Редактирование пользователя**(%%) ==
++
  (% class="box warningmessage" %)
  (((
  (% lang="en-US" %)**PUT /api/v3/users**
@@ -535,8 +535,9 @@
  (% lang="en-US" style="text-align:left" %)
  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)}
--== (% style="color:#000000; font-size:16px" %)**Изменение статуса пользователя**(%%) ==
++== (% style="color:#000000, font-size:14px" %)**Изменение статуса пользователя**(%%) ==
++
  (% class="box warningmessage" %)
  (((
  (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/users/status/{id}**
@@ -565,8 +565,9 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**
--== (% style="color:#000000; font-size:16px" %)**Блокировка пользователей**(%%) ==
++== (% style="color:#000000, font-size:14px" %)**Блокировка пользователей**(%%) ==
++
  (% class="box warningmessage" %)
  (((
  **POST /api/v3/users/disable**
@@ -587,8 +587,9 @@
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**
--== (% style="color:#000000; font-size:16px" %)**Разблокировка пользователей**(%%) ==
++== (% style="color:#000000, font-size:14px" %)**Разблокировка пользователей**(%%) ==
++
  (% class="box warningmessage" %)
  (((
  **POST /api/v3/users/enable**
@@ -622,10 +622,11 @@
  }
  \\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями.
  "users" - массив id пользователей, которых не удалось включить или отключить.
++
++
++== (% style="color:#000000; line-height:14px" %)**Удаление пользователя**(%%) ==
  )))
--== (% style="color:#000000; font-size:16px" %)**Удаление пользователя**(%%) ==
--
  (% class="box errormessage" %)
  (((
  (% lang="en-US" %)**DELETE /api/v3/users/{id}**
@@ -644,10 +644,12 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) ==
++== (% style="color:#000000; font-size:14px" %)**Получение информации об объекте**(%%) ==
++
  (% class="box infomessage" %)
  (((
  (% lang="en-US" %)**GET /api/v3/vehicles/{vehicleId}**
@@ -716,8 +716,9 @@
  (% style="text-align:left" %)
 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
--== (% style="color:#000000; font-size:16px" %)**Добавление объекта**(%%) ==
++== (% style="color:#000000; font-size:14px" %)**Добавление объекта**(%%) ==
++
  (% class="box successmessage" %)
  (((
  (% lang="en-US" %)**POST /api/v3/vehicles**
@@ -836,9 +836,10 @@
  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
--== (% style="color:#000000; font-size:16px" %)**Получение параметров объектов**(%%) ==
--(% class="box infomessage" %)
++== (% style="color:#000000; font-size:14px" %)**Получение параметров объектов**(%%) ==
++
++(% class="box successmessage" %)
  (((
  (% lang="en-US" %)**POST /api/v3/vehicles/find**
  )))
@@ -918,8 +918,9 @@
  (% style="color:#000000" %)          Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.
--== (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) ==
++== (% style="color:#000000; font-size:14px" %)**Изменение статуса объекта**(%%) ==
++
  (% class="box successmessage" %)
  (((
  (% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}**
@@ -964,8 +964,9 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)  }
--== (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) ==
++== (% style="color:#000000; font-size:14px" %)**Редактирование объекта**(%%) ==
++
  (% class="box warningmessage" %)
  (((
  (% lang="en-US" %)**PUT /api/v3/vehicles**
@@ -1093,8 +1093,9 @@
  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
--== (% style="color:#000000; font-size:16px" %)**Удаление объекта**(%%) ==
++== (% style="color:#000000; font-size:14px" %)**Удаление объекта**(%%) ==
++
  (% class="box errormessage" %)
  (((
  (% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}**
@@ -1113,10 +1113,12 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
--= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Устройства**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Получение списка типов устройств**(%%) ==
++(% style="color:#000000; font-size:14pt" %)Раздел: **Устройства**
++
++== (% style="color:#000000; font-size:14px" %)**Получение списка типов устройств**(%%) ==
++
  (% class="box infomessage" %)
  (((
  (% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/devices/types**
@@ -1140,10 +1140,12 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)}
--= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Получение списка типов датчиков**(%%) ==
++= (% style="color:#000000; font-size:18.6667pt" %)Раздел: **Датчики**(%%) =
++
++== (% style="color:#000000; font-size:14px" %)**Получение списка типов датчиков**(%%) ==
++
  (% class="box infomessage" %)
  (((
  (% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**GET /api/v3/sensors/types**
@@ -1155,7 +1155,7 @@
  (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/sensors/types>>url:https://hosting.glonasssoft.ru/api/v3/sensors/types]]
--(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
++(% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации
  (% style="color:#000000" %)Ответ:
@@ -1168,48 +1168,7 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)}
--= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Статистика**(%%) =
--== (% style="color:#000000; font-size:16px" %)**Данные об активности объекта**(%%) ==
--
--(% class="box infomessage" style="text-align: left;" %)
--(((
--**POST /api/v3/terminalMessages/count**
--)))
--
--(% style="text-align: left;" %)
--Метод возвращает количество сообщений отправленных терминалом на сервер за указанный период (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).
--
--(% style="text-align: left;" %)
--Метод запроса **POST**
--
--(% style="text-align: left;" %)
--(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/count
--
--(% style="text-align: left;" %)
--(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
--
--(% style="text-align: left;" %)
--{
--  "vehicleIds": [
--    id ~/~/ здесь передается список идентификаторов объектов
--  ],
--  "from": "2023-03-12T07:09:02.364Z", ~/~/ от какой даты выполнять запрос
--  "to": "2023-03-14T07:09:02.364Z" ~/~/ до какой даты выполнять запрос
--}
--
--(% style="text-align: left;" %)
--Ответ:
--
--(% style="text-align: left;" %)
--[
--  {
--    "vehicleId": 0, ~/~/ идентификатор объекта
--    "count": 0 ~/~/ количество сообщений за период
--  }
--]
--
--
  (% class="box" lang="en-US" style="text-align: center;" %)
  (((
  (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **

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

Summary

Details

Меню