Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/05/06 12:41
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -1628,10 +1628,81 @@ 1628 1628 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1629 1629 1630 1630 1631 - (% style="color:#000000;font-size:16px" %)**Получениесписка объектовсосновнымипараметрами**1631 +== **Импортировать историю ТС (Асинхронный запрос)** == 1632 1632 1633 +(% class="box successmessage" %) 1634 +((( 1635 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 1636 +))) 1637 + 1638 +Метод запроса: **POST** 1639 + 1640 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 1641 + 1642 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 1643 + 1644 + 1645 +Ответ: 1646 + 1647 +{ 1648 + 1649 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1650 + 1651 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 1652 + 1653 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 1654 + 1655 + "Message": "string", ~/~/ Информация о выполнении запроса 1656 + 1657 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 1658 + 1659 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1660 + 1661 + "Data": "string" ~/~/ Данные 1662 + 1663 +} 1664 + 1665 + 1666 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 1667 + 1633 1633 (% class="box infomessage" %) 1634 1634 ((( 1670 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 1671 +))) 1672 + 1673 +Метод запроса: **GET** 1674 + 1675 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 1676 + 1677 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 1678 + 1679 + 1680 +Ответ: 1681 + 1682 +{ 1683 + 1684 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 1685 + 1686 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 1687 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 1688 + 1689 + "Message": "string", ~/~/ Информация о выполнении запроса 1690 + 1691 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 1692 + 1693 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 1694 + 1695 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 1696 + 1697 + "Data": "string" ~/~/ Данные 1698 + 1699 +} 1700 + 1701 + 1702 +== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1703 + 1704 +(% class="box infomessage" %) 1705 +((( 1635 1635 (% lang="en-US" %)**POST /api/v3/vehicles/find** 1636 1636 ))) 1637 1637 ... ... @@ -1773,6 +1773,7 @@ 1773 1773 "stage": "", ~/~/ Состояние 1774 1774 (% style="color:#000000" %) } 1775 1775 1847 +== == 1776 1776 1777 1777 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1778 1778 ... ... @@ -2734,35 +2734,6 @@ 2734 2734 } 2735 2735 ] 2736 2736 2737 - 2738 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2739 - 2740 -(% class="box successmessage" %) 2741 -((( 2742 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2743 -))) 2744 - 2745 -(% style="color:#000000" %)Метод запроса: **PUT** 2746 - 2747 -Пример запроса: 2748 - 2749 -((( 2750 -{ 2751 - "id": 0, ~/~/ Идентификатор объекта геозоны 2752 - "name": "string", ~/~/ Наименование объекта геозоны 2753 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2754 - "description": "string", ~/~/ Описание объекта геозоны 2755 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2756 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2757 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2758 -} 2759 -))) 2760 - 2761 - 2762 -Пример ответа: 2763 - 2764 -200 ~/~/ Success 2765 - 2766 2766 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2767 2767 2768 2768 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -4247,43 +4247,6 @@ 4247 4247 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4248 4248 |msgCount|Кол-во обработанных сообщений всего 4249 4249 4250 -== **Импортировать историю ТС (Асинхронный запрос)** == 4251 - 4252 -(% class="box successmessage" %) 4253 -((( 4254 -**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4255 -))) 4256 - 4257 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4258 - 4259 -Метод запроса: **POST** 4260 - 4261 -URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4262 - 4263 -Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4264 - 4265 - 4266 -Ответ: 4267 - 4268 -{ 4269 - 4270 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4271 - 4272 - "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4273 - 4274 -~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4275 - 4276 - "Message": "string", ~/~/ Информация о выполнении запроса 4277 - 4278 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4279 - 4280 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4281 - 4282 - "Data": "string" ~/~/ Данные 4283 - 4284 -} 4285 - 4286 - 4287 4287 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4288 4288 4289 4289 (% class="box infomessage" %) ... ... @@ -4301,59 +4301,10 @@ 4301 4301 "message": "string" 4302 4302 } 4303 4303 4304 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4305 -**Параметр** 4306 -)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4307 -**Описание** 4308 -))) 4309 -|((( 4310 -activity 4311 -)))|((( 4312 -Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4313 -))) 4314 -|((( 4315 -progress 4316 -)))|((( 4317 -Guid ТС 4318 -))) 4310 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4311 +|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4312 +|progress|Guid ТС 4319 4319 4320 -== **Возвращает статус асинхронного запроса импорта истории ТС** == 4321 - 4322 -(% class="box infomessage" %) 4323 -((( 4324 -**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4325 -))) 4326 - 4327 -При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4328 - 4329 -Метод запроса: **GET** 4330 - 4331 -URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4332 - 4333 -Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4334 - 4335 - 4336 -Ответ: 4337 - 4338 -{ 4339 - 4340 - "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4341 - 4342 - "Status": 0, ~/~/ Перечисление состояний выполения запроса 4343 -~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4344 - 4345 - "Message": "string", ~/~/ Информация о выполнении запроса 4346 - 4347 - "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4348 - 4349 -~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4350 - 4351 - "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4352 - 4353 - "Data": "string" ~/~/ Данные 4354 - 4355 -} 4356 - 4357 4357 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4358 4358 4359 4359 (% class="box infomessage" %) ... ... @@ -4865,51 +4865,8 @@ 4865 4865 } 4866 4866 ] 4867 4867 } 4868 - 4869 - 4870 -== **Превышение скорости** == 4871 - 4872 -(% class="box infomessage" %) 4873 -((( 4874 -**POST /api/v3/Reports/overSpeedDuration** 4875 4875 ))) 4876 4876 4877 - Публичный API запрос о превышениях скорости по объекту в секундах с выбором способа определения нарушений (дорожное ограничение или фиксированное ограничение). 4878 - 4879 -Пример запроса: 4880 - 4881 -((( 4882 -{ 4883 - "vehicleId": 0, ~/~/ идентификационный номер транспортного средства 4884 - "from": "2025-04-21T10:45:25.258Z", ~/~/ Начало периода (локальное время клиента) 4885 - "to": "2025-04-21T10:45:25.258Z", ~/~/ Конец периода (локальное время клиента) 4886 - "timezone": 0, ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 4887 - "overSpeedDetectionType": 0 ~/~/ тип нарушения (1-дорожное ограничение, 2-фиксированный ) 4888 -} 4889 -))) 4890 - 4891 -((( 4892 - 4893 -))) 4894 - 4895 -((( 4896 -Пример ответа: 4897 -))) 4898 - 4899 -((( 4900 -((( 4901 -[ 4902 - { 4903 - "eventDate": "2025-04-21T10:45:25.267Z", ~/~/ Дата и время события 4904 - "duration": 0, ~/~/ Продолжительность события в секундах 4905 - "maxSpeed": 0, ~/~/ Максимальная скорость 4906 - "speedLimit": 0 ~/~/ Ограничение скорости 4907 - } 4908 -] 4909 -))) 4910 -))) 4911 -))) 4912 - 4913 4913 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4914 4914 4915 4915 ... ... @@ -6177,73 +6177,6 @@ 6177 6177 6178 6178 6179 6179 6180 -= **Раздел: Управление доступа к машинам** = 6181 - 6182 - 6183 -== Получение списка транспортных средств видимых пользователю == 6184 - 6185 -(% class="box infomessage" %) 6186 -((( 6187 -**GET /api/v3/UserVisibleVehicles/{userId}** 6188 -))) 6189 - 6190 -Пример ответа: 6191 - 6192 -((( 6193 -{ 6194 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6195 - 0 6196 - ] 6197 -} 6198 -))) 6199 - 6200 - 6201 - 6202 -== Задает видимость транспортных средств пользователю == 6203 - 6204 -(% class="box infomessage" %) 6205 -((( 6206 -**POST /api/v3/UserVisibleVehicles** 6207 -))) 6208 - 6209 -Пример запроса: 6210 - 6211 -((( 6212 -((( 6213 -{ 6214 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6215 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6216 - 0 6217 - ] 6218 -} 6219 -))) 6220 - 6221 -((( 6222 - 6223 -))) 6224 - 6225 -((( 6226 - 6227 -))) 6228 - 6229 -((( 6230 -Пример ответа : 6231 -))) 6232 - 6233 -((( 6234 - 6235 -))) 6236 - 6237 -((( 6238 -200 ~/~/ Success 6239 -))) 6240 -))) 6241 - 6242 - 6243 - 6244 - 6245 - 6246 - 6247 6247 (% class="box" lang="en-US" style="text-align: center;" %) 6248 6248 ((( 6249 6249 (% 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]] **