Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/14 11:58
<
>
edited by Андрей Калиновский
on 2024/11/22 14:30
on 2024/11/22 14:30
edited by Андрей Калиновский
on 2024/11/22 14:54
on 2024/11/22 14:54
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,9 +1,22 @@ 1 1 (% class="western" id="H41E43F43844143043D43843541341B41E41D410421421SoftPublicAPI" %) 2 2 ((( 3 -**Содержание страницы:**\ 3 +(% class="box warningmessage" %) 4 +((( 5 +(% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно просим вас соблюдать несколько простых правил при использовании API-команд:## 4 4 ))) 5 5 8 +* Формировать не более 3 отчётов одновременно. 9 +* Ограничить количество активных сессий одного пользователя с одного IP-адреса до 50. 6 6 11 +В случае нарушения этих правил, ГЛОНАССSoft оставляет за собой право принудительно остановить работу команд. 12 + 13 + 14 +**Содержание страницы:** 15 +))) 16 + 17 +{{toc/}} 18 + 19 + 7 7 = (% style="color:#000000; font-size:16px" %)**Действующие ограничения**(%%) = 8 8 9 9 (% style="color:#000000" %)−(%%) **Между запросами должна быть пауза в 1 секунду** (превышение отвергается системой с уведомлением о превышении частоты запросов). ... ... @@ -1170,41 +1170,6 @@ 1170 1170 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 1171 1171 1172 1172 1173 -== **Импортировать историю ТС (Асинхронный запрос)** == 1174 - 1175 -(% class="box successmessage" %) 1176 -((( 1177 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1178 -))) 1179 - 1180 -(% style="color:#000000" %)Метод запроса: **POST** 1181 - 1182 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} 1183 - 1184 -(% style="color:#000000" %)Параметр запроса: {__**vehicleid}**__ - идентификатор транспортного средства 1185 - 1186 - 1187 -Ответ: 1188 - 1189 -{ 1190 - 1191 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1192 - 1193 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1194 - 1195 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1196 - 1197 - "Message": "string", ~/~/ Информация о выполнении запроса 1198 - 1199 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1200 - 1201 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1202 - 1203 - "Data": "string" ~/~/ Данные 1204 - 1205 -} 1206 - 1207 - 1208 1208 == **Отправить команду на терминал** == 1209 1209 1210 1210 (% class="box successmessage" %) ... ... @@ -1590,6 +1590,78 @@ 1590 1590 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1591 1591 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1592 1592 1571 + 1572 +== **Импортировать историю ТС (Асинхронный запрос)** == 1573 + 1574 +(% class="box successmessage" %) 1575 +((( 1576 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1577 +))) 1578 + 1579 +Метод запроса: **POST** 1580 + 1581 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1582 + 1583 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1584 + 1585 + 1586 +Ответ: 1587 + 1588 +{ 1589 + 1590 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1591 + 1592 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1593 + 1594 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1595 + 1596 + "Message": "string", ~/~/ Информация о выполнении запроса 1597 + 1598 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1599 + 1600 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1601 + 1602 + "Data": "string" ~/~/ Данные 1603 + 1604 +} 1605 + 1606 + 1607 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 1608 + 1609 +(% class="box infomessage" %) 1610 +((( 1611 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1612 +))) 1613 + 1614 +Метод запроса: **GET** 1615 + 1616 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1617 + 1618 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1619 + 1620 + 1621 +Ответ: 1622 + 1623 +{ 1624 + 1625 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1626 + 1627 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 1628 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1629 + 1630 + "Message": "string", ~/~/ Информация о выполнении запроса 1631 + 1632 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1633 + 1634 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1635 + 1636 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1637 + 1638 + "Data": "string" ~/~/ Данные 1639 + 1640 +} 1641 + 1642 + 1593 1593 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1594 1594 1595 1595 (% class="box infomessage" %)