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

Last modified by Андрей Калиновский on 2025/01/14 11:58

From version < 192.1 >

edited by Михаил Жучков
on 2024/12/16 18:00

To version < 186.1 >

edited by Андрей Калиновский
on 2024/11/22 14:30

Change comment: Откат к версии 183.1

Raw
Rendered

Summary

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

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.SupportZhuchkov
++XWiki.Gadmin

Content

@@ -1,23 +1,9 @@
  (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %)
  (((
--(% class="box warningmessage" %)
--(((
--(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно
--просим вас соблюдать несколько простых правил при использовании API-команд:##
++**Содержание страницы:**\
  )))
--* Формировать не более 3 отчётов одновременно.
--* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50.
--В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить выполнение запросов с определенных IP адресов.
--
--
--**Содержание страницы:**
--)))
--
--{{toc/}}
--
--
  = (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) =
  (% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов).
@@ -1184,6 +1184,41 @@
 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется».
++== **Импортировать историю ТС (Асинхронный запрос)** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
++)))
++
++(% style="color:#000000" %)Метод запроса: **POST**
++
++(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId}
++
++(% style="color:#000000" %)Параметр запроса: {__**vehicleid}**__ - идентификатор транспортного средства
++
++
++Ответ:
++
++{
++
++  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
++
++  "Status": 0, ~/~/ Перечисление состояний выполнения запроса
++
++~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
++
++  "Message": "string", ~/~/ Информация о выполнении запроса
++
++  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
++
++  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
++
++  "Data": "string" ~/~/ Данные
++
++}
++
++
  == **Отправить команду на терминал** ==
  (% class="box successmessage" %)
@@ -1194,15 +1194,13 @@
  Команда для отправки на тс.
  {
--"id": "",  ~/~/идентификатор объекта (он же идентификатор ТС: vehicleId)
--"command": "", ~/~/  Текст отправляемой команды
--"retries": "",  ~/~/ Количество попыток отправки на терминал
--"idTemplate": "" ~/~/ ID шаблона команды (при использовании ранее созданных шаблонов).
++"id": "",  ~/~/идентификатор произвольного поля
++"command": "", ~/~/  Текст команды
++"retries": "",  ~/~/ Количество попыток
++"idTemplate": "" ~/~/ ID шаблона команды
  }
--В ответ получаем cmdid
--
  == **Получить ответ на отправленную на ТС команду** ==
  (% class="box infomessage" %)
@@ -1210,13 +1210,13 @@
  (% lang="en-US" %)**GET **(%%)**/api/v3/Vehicles/cmd/{cmdId}/answer**
  )))
--Идентификатор команды: cmdId
++Идентификатор команды: cmdid
  Запрос от терминала на ответ команды
  Пример ответ от терминала:
--ID= "" ~/~/ идентификатор объекта
++ID= "" ~/~/ идентификатор произвольного поля
  Soft="" ~/~/ версия софта
  GPS=4 ~/~/ тип трекера
  Time=11:05:43 28.06.24 ~/~/ время запроса
@@ -1571,78 +1571,6 @@
  - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма;
  - при задании сезонной нормы обязательны соответствующие даты начала/окончания.
--
--== **Импортировать историю ТС (Асинхронный запрос)** ==
--
--(% class="box successmessage" %)
--(((
--**POST /api/v3/Vehicles/importAsync/history/{vehicleId} **
--)))
--
--Метод запроса: **POST**
--
--URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} **
--
--Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства
--
--
--Ответ:
--
--{
--
--  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
--
--  "Status": 0, ~/~/ Перечисление состояний выполнения запроса
--
--~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest)
--
--  "Message": "string", ~/~/ Информация о выполнении запроса
--
--  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None)
--
--  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
--
--  "Data": "string" ~/~/ Данные
--
--}
--
--
--== **Возвращает статус асинхронного запроса импорта истории ТС** ==
--
--(% class="box infomessage" %)
--(((
--**GET /api/v3/Vehicles/importAsync/history/state/{requestId}**
--)))
--
--Метод запроса: **GET**
--
--URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}**
--
--Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса
--
--
--Ответ:
--
--{
--
--  "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса
--
--  "Status": 0, ~/~/ Перечисление состояний выполения запроса
--~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest
--
--  "Message": "string", ~/~/ Информация о выполнении запроса
--
--  "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса
--
--~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None
--
--  "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress
--
--  "Data": "string" ~/~/ Данные
--
--}
--
--
  == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) ==
  (% class="box infomessage" %)
@@ -4438,22 +4438,22 @@
  Пример ответа:
  {
--"description": "",  ~/~/ Поле описания ретранслятора
--"subscriberId": "",  ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
--"protocolType": 0,  ~/~/ Тип протокола ретрансляции
--"isEnabled": true,  ~/~/ Признак включения ретранслятора, Включен, true - включен, false - отключен
--"address": "string",  ~/~/ Адрес и порт принимающего сервера
--"objects": [    ~/~/ Объекты для ретрансляции
++"description": "",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ Подписчик
++"protocolType": 0,  ~/~/ Тип протокола
++"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",  ~/~/ Адрес события
++"objects": [    ~/~/Объекты для ретрансляции
  {
  "id": "",  ~/~/ Идентификатор объекта ретрансляции
  "name": "",   ~/~/ Наименование объекта ретрансляции
--"imei": "",     ~/~/ IMEI объекта  ретрансляции
--"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
++"imei": "",     ~/~/ IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
  }
    ],
--"id": "",  ~/~/ Идентификатор ретранслятора
--"parentId": "",  ~/~/ Идентификатор родителя (вышестоящего клиента)
--"deleted": "" ~/~/ Признак удаления ретранслятора: true - включен, false - отключен
++"id": "",  ~/~/ идентификатор пользователя
++"parentId": "",  ~/~/Guid родителя
++"deleted": "" ~/~/ Признак удаления, Включен, true - включен, false - отключен
  }
@@ -4464,7 +4464,7 @@
  **DELETE** **/api/v3/retranslations/{id}**
  )))
--Параметр запроса: ID - Идентификатор ретранслятора
++Параметр запроса: ID
  == **Создание ретранслятора** ==
@@ -4477,16 +4477,16 @@
  Запрос:
  {
--"description": "",  ~/~/ Поле описания ретранслятора
--"subscriberId": "",  ~/~/ Идентификатор подписчика
--"protocolType": 0,  ~/~/ Тип протокола ретрансляции
--"address": "",  ~/~/ Адрес и порт принимающего сервера
--"isEnabled": "",  ~/~/ Признак включения ретранслятора, true - включен, false - отключен
++"description": "",  ~/~/ Описание
++"subscriberId": "",  ~/~/ Подписчик
++"protocolType": 0,  ~/~/ Тип протокола
++"address": "",  ~/~/ Адрес ретрансляции
++"isEnabled": "",  ~/~/ признак включения, Включен, true - включен, false - отключен
  "objects": [    ~/~/Объекты для ретрансляции
  {
--"id": "",  ~/~/ Идентификатор ретранслятора
--"imei": "",     ~/~/ IMEI объекта ретрансляции
--"isEnabled":  ""  ~/~/ Признак включения объекта  ретрансляции: true - включен, false - отключен
++"id": "",  ~/~/ идентификатор пользователя
++"imei": "",     ~/~/IMEI объекта
++"isEnabled":  ""  ~/~/ признак включения, Включен, true - включен, false - отключен
  }
    ]
  }
@@ -4495,22 +4495,22 @@
  Ответ:
  {
--"description": "",  ~/~/ Поле описания ретранслятора
--"subscriberId": "",  ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
--"protocolType": 0,  ~/~/ Тип протокола ретрансляции
--"isEnabled": true,  ~/~/ Признак включения ретранслятора: true - включен, false - отключен
--"address": "string",  ~/~/ Адрес и порт принимающего сервера
--"objects": [     ~/~/ Объекты для ретрансляции
++"description": "string",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ идентификатор запроса
++"protocolType": 0,   ~/~/ Тип протокола
++"isEnabled":  "",  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "",  ~/~/ Адрес события
++"objects": [    ~/~/Объекты для ретрансляции
  {
--"id": "",    ~/~/ Идентификатор объекта ретрансляции
--"name": "string",  ~/~/ Наименование объекта ретрансляции
--"imei": "",      ~/~/ IMEI объекта ретрансляции
--"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
++"id": "",     ~/~/ идентификатор пользователя
++"name": "string",     ~/~/ Название уведомления
++"imei": "string",    ~/~/IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
  }
--  ],
--"id": "",  ~/~/ Идентификатор ретранслятора
--"parentId": "",  ~/~/ Идентификатор родителя (вышестоящего клиента)
--"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
++  ],
++"id": "",  ~/~/ идентификатор пользователя
++"parentId": "",  ~/~/ Guid идентификатор родителя
++"deleted": true ~/~/ Признак удаления
  }
@@ -4524,18 +4524,18 @@
  Пример запроса:
  {
--"id": "",  ~/~/ Идентификатор ретранслятора
--"description": "string",  ~/~/ Поле описания ретранслятора
--"subscriberId": "",  ~/~/ Идентификатор подписчика
--"protocolType": 0,  ~/~/ Тип протокола ретрансляции
--"isEnabled": true,  ~/~/ Признак включения ретранслятора: true - включен, false - отключен
--"address": "string",   ~/~/ Адрес и порт принимающего сервера
--"objects":  ~/~/ Объекты для ретрансляции
++"id": "",  ~/~/ идентификатор пользователя
++"description": "string",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ идентификатор запроса
++"protocolType": 0,  ~/~/ Тип протокола
++"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",   ~/~/ Адрес события
++"objects":  ~/~/Объекты для ретрансляции
  [
  {
--"id": "",  ~/~/ Идентификатор объекта ретрансляции
--"imei": "",       ~/~/ IMEI объекта  ретрансляции
--"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
++"id": "",  ~/~/ идентификатор пользователя
++"imei": "",       ~/~/IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
  }
    ]
  }
@@ -4544,22 +4544,22 @@
  Пример ответа:
  {
--"description": "",  ~/~/ Поле описания ретранслятора
--"subscriberId": "",  ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
--"protocolType": 0,  ~/~/ Тип протокола ретрансляции
--"isEnabled": true,  ~/~/ Признак включения ретранслятора: true - включен, false - отключен
--"address": "string",  ~/~/ Адрес и порт принимающего сервера
--"objects": [     ~/~/ Объекты для ретрансляции
++"description": "",  ~/~/ Определяет описание
++"subscriberId": "",  ~/~/ идентификатор запроса
++"protocolType": 0,  ~/~/ Тип протокола
++"isEnabled": true,  ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",  ~/~/ Адрес события
++"objects": [     ~/~/Объекты для ретрансляции
  {
--"id": "",    ~/~/ Идентификатор объекта ретрансляции
--"name": "string",  ~/~/ Наименование объекта ретрансляции
--"imei": "",      ~/~/ IMEI объекта ретрансляции
--"isEnabled": true    ~/~/ Признак включения объекта ретрансляции: true - включен, false - отключен
++"id": "",    ~/~/ идентификатор пользователя
++"name": "string",  ~/~/ Название уведомления
++"imei": "",      ~/~/IMEI объекта
++"isEnabled": true    ~/~/ признак включения, Включен, true - включен, false - отключен
  }
    ],
--"id": "",  ~/~/ Идентификатор ретранслятора
--"parentId": "",  ~/~/ Идентификатор родителя (вышестоящего клиента)
--"deleted": true ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
++"id": "",  ~/~/ идентификатор пользователя
++"parentId": "",  ~/~/ Guid идентификатор родителя
++"deleted": true ~/~/ Признак удаления
  }
@@ -4573,9 +4573,9 @@
  Пример запроса:
  {
--"id": "",  ~/~/ Идентификатор ретранслятора
++"id": "",  ~/~/ идентификатор пользователя
  "search": "string",  ~/~/Строка поиска. Поиск производится по имени подписчика, описанию, типу протокола и адресу
--"parentId": "" ~/~/ Идентификатор родительского агента, для которого надо получить данные (вышестоящего клиента).
++"parentId": "" ~/~/ Идентификатор агента, для которого надо получить данные.
  }
  Ответ:
@@ -4582,14 +4582,14 @@
  [
  {
--"description": "",    ~/~/ Поле описания ретранслятора
--"subscriberId": "",    ~/~/ Идентификатор подписчика (клиента, чьи объекты будут ретранслироваться)
--"protocolType": 0,     ~/~/ Тип протокола ретрансляции
--"isEnabled": true,    ~/~/ Признак включения ретранслятора: true - включен, false - отключен
--"address": "string",    ~/~/ Адрес и порт принимающего сервера
--"id": "",    ~/~/ Идентификатор ретранслятора
--"parentId": "",    ~/~/ Идентификатор родителя (вышестоящего клиента)
--"deleted": true   ~/~/ Признак удаления ретранслятора: true - удален, false - не удален
++"description": "",    ~/~/ Определяет описание
++"subscriberId": "",    ~/~/ идентификатор запроса
++"protocolType": 0,     ~/~/ Тип протокола
++"isEnabled": true,    ~/~/ признак включения, Включен, true - включен, false - отключен
++"address": "string",    ~/~/ Адрес события
++"id": "",    ~/~/ идентификатор пользователя
++"parentId": "",    ~/~/ Guid идентификатор родителя
++"deleted": true   ~/~/ Признак удаления
  }
  ]

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

Summary

Details

Меню