Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/06/27 16:12
<
>
edited by Андрей Калиновский
on 2025/04/24 15:46
on 2025/04/24 15:46
edited by Андрей Калиновский
on 2025/06/09 16:20
on 2025/06/09 16:20
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -877,7 +877,7 @@ 877 877 { 878 878 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 879 879 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 880 - "deleted": true,880 + "deleted": false, 881 881 "extId": "string", 882 882 "name": "string", 883 883 "picture": "string", ... ... @@ -896,7 +896,7 @@ 896 896 { 897 897 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 898 898 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 899 - "deleted": true,899 + "deleted": false, 900 900 "extId": "string", 901 901 "name": "string", 902 902 "picture": "string", ... ... @@ -930,7 +930,7 @@ 930 930 (% style="color:#000000" %)// //(% lang="en-US" %)**PUT /api/v3/models** 931 931 ))) 932 932 933 -(% style="color:#000000" %)Метод позволяет изменить статус пользователя, указанного в запросе.933 +(% style="color:#000000" %)Метод позволяет изменить статус модели, указанного в запросе. 934 934 935 935 (% style="color:#000000" %)Метод запроса: **PUT** 936 936 ... ... @@ -997,7 +997,7 @@ 997 997 (% lang="en-US" %)**DELETE /api/v3/models/{Id}** 998 998 ))) 999 999 1000 -(% style="color:#000000" %)Метод позволяет удалить пользователя. Метод позволяет удалитьпользователя, указанного в строке запроса.1000 +(% style="color:#000000" %)Метод позволяет удалить модели. Метод позволяет удалить модель, указанного в строке запроса. 1001 1001 1002 1002 (% style="color:#000000" %)Метод запроса: **DELETE** 1003 1003 ... ... @@ -1628,77 +1628,6 @@ 1628 1628 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1629 1629 1630 1630 1631 -== **Импортировать историю ТС (Асинхронный запрос)** == 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 - 1668 -(% class="box infomessage" %) 1669 -((( 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 1702 == (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1703 1703 1704 1704 (% class="box infomessage" %) ... ... @@ -1844,7 +1844,6 @@ 1844 1844 "stage": "", ~/~/ Состояние 1845 1845 (% style="color:#000000" %) } 1846 1846 1847 -== == 1848 1848 1849 1849 == (% style="color:#000000; font-size:16px" %)**Редактирование объекта**(%%) == 1850 1850 ... ... @@ -2527,6 +2527,8 @@ 2527 2527 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2528 2528 "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 2529 2529 "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 2458 + "fuelTankLevelStart": 0, ~/~/ Уровень топлива в цистерне на начало периода 2459 + "fuelTankLevelEnd": 0, ~/~/ Уровень топлива в цистерне на конец периода 2530 2530 "fuelConsumption": 0, ~/~/ Расход топлива 2531 2531 "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 2532 2532 "fuelConsumptionFactTank": 0 ~/~/ Фактический расход топлива в цистерне ... ... @@ -2866,7 +2866,7 @@ 2866 2866 "id": 0, ~/~/ ID уведомления 2867 2867 "name": "string", ~/~/ Название уведомления 2868 2868 "active": true, ~/~/ Состояние true - активен, false - деактивирован 2869 - "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО 2799 + "type": 0, ~/~/ Шаблон события 0 - Въезд и выезд из геозоны, 2 - Превышение скорости, 4 - Слив, 5 - Заправка, 6 - Сработка тревожной кнопки, 7 - Потеря связи с объектом, 8 - Сработка дискретного датчика, 9 - Значение аналогового датчика, 10 - Адрес, 11 - Простой, 12 - Выполнение ТО, 13 - Назначение водителя) 2870 2870 "userId": "", ~/~/ Пользователь, создавший уведомление 2871 2871 "parentId": "", ~/~/ Идентификатор клиента 2872 2872 "parentName": "string" ~/~/ Имя клиента ... ... @@ -4319,6 +4319,43 @@ 4319 4319 |producedCount|Кол-во успешно отправленных в шину данных сообщений 4320 4320 |msgCount|Кол-во обработанных сообщений всего 4321 4321 4252 +== **Импортировать историю ТС (Асинхронный запрос)** == 4253 + 4254 +(% class="box successmessage" %) 4255 +((( 4256 +**POST /api/v3/Vehicles/importAsync/history/{vehicleId} ** 4257 +))) 4258 + 4259 +При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4260 + 4261 +Метод запроса: **POST** 4262 + 4263 +URL запроса: **https:~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/{vehicleId} ** 4264 + 4265 +Параметр запроса: {**__vehicleid}__** - идентификатор транспортного средства 4266 + 4267 + 4268 +Ответ: 4269 + 4270 +{ 4271 + 4272 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4273 + 4274 + "Status": 0, ~/~/ Перечисление состояний выполнения запроса 4275 + 4276 +~/~/ ( 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest) 4277 + 4278 + "Message": "string", ~/~/ Информация о выполнении запроса 4279 + 4280 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса (1 - Intermediate, 2 - ProgressProcent, 255 - None) 4281 + 4282 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4283 + 4284 + "Data": "string" ~/~/ Данные 4285 + 4286 +} 4287 + 4288 + 4322 4322 == (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 4323 4323 4324 4324 (% class="box infomessage" %) ... ... @@ -4336,10 +4336,59 @@ 4336 4336 "message": "string" 4337 4337 } 4338 4338 4339 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4340 -|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4341 -|progress|Guid ТС 4306 +|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)((( 4307 +**Параметр** 4308 +)))|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)((( 4309 +**Описание** 4310 +))) 4311 +|((( 4312 +activity 4313 +)))|((( 4314 +Активен ли экспорт/импорт истории сейчас, true - да, false - нет 4315 +))) 4316 +|((( 4317 +progress 4318 +)))|((( 4319 +Guid ТС 4320 +))) 4342 4342 4322 +== **Возвращает статус асинхронного запроса импорта истории ТС** == 4323 + 4324 +(% class="box infomessage" %) 4325 +((( 4326 +**GET /api/v3/Vehicles/importAsync/history/state/{requestId}** 4327 +))) 4328 + 4329 +При выгрузке большого объема информации, выполняющихся более 90 секунд, рекомендуется использовать этот запрос. 4330 + 4331 +Метод запроса: **GET** 4332 + 4333 +URL запроса: https:**~/~/hosting.glonasssoft.ru/api/v3/Vehicles/importAsync/history/state/{requestId}** 4334 + 4335 +Параметр запроса: {**requestId__}__** - Уникальный идентификатор запроса 4336 + 4337 + 4338 +Ответ: 4339 + 4340 +{ 4341 + 4342 + "RequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Уникальный идентификатор запроса 4343 + 4344 + "Status": 0, ~/~/ Перечисление состояний выполения запроса 4345 +~/~/ 0 - Success, 1 - InPorgress, 2 - Canceled, 10 - Error, 20 - ErrorRequestValidation, 50 - ErrorExceedMaximumActiveRequest 4346 + 4347 + "Message": "string", ~/~/ Информация о выполнении запроса 4348 + 4349 + "ProgressState": 1, ~/~/ Тип информирования о ходе выполнении запроса 4350 + 4351 +~/~/ 1 - Intermediate, 2 - ProgressProcent, 255 - None 4352 + 4353 + "ProgressValue": 0, ~/~/ Прогресс выполнения запроса. Актуально, только если ProgressState=InProgress 4354 + 4355 + "Data": "string" ~/~/ Данные 4356 + 4357 +} 4358 + 4343 4343 == (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 4344 4344 4345 4345 (% class="box infomessage" %) ... ... @@ -5900,6 +5900,62 @@ 5900 5900 ))) 5901 5901 5902 5902 5919 += **Раздел: Роли** = 5920 + 5921 +== **Получение списка клиентских и системных ролей пользователя ** == 5922 + 5923 +(% class="box successmessage" %) 5924 +((( 5925 +**POST /api/v3/groups/find** 5926 +))) 5927 + 5928 +Пример запроса: 5929 + 5930 +((( 5931 +{ 5932 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента содержащий пользовательские роли 5933 + "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 5934 +} 5935 +))) 5936 + 5937 +((( 5938 + 5939 +))) 5940 + 5941 +((( 5942 +Пример ответа: 5943 +))) 5944 + 5945 +((( 5946 +((( 5947 +{ 5948 + "groups": [ ~/~/ Системные роли пользователя 5949 + { 5950 + "code": "string", ~/~/ Код роли. 5951 + "name": "string", ~/~/ Имя 5952 + "shortName": "string" ~/~/ Короткое имя 5953 + } 5954 + ], 5955 + "customGroups": [ ~/~/ Системные роли пользователя 5956 + { 5957 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор роли. 5958 + "name": "string", ~/~/ Наименование 5959 + "shortName": "string", ~/~/ Короткое наименование 5960 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор владельца 5961 + } 5962 + ] 5963 +} 5964 +))) 5965 +))) 5966 + 5967 +((( 5968 + 5969 +))) 5970 + 5971 +((( 5972 + 5973 +))) 5974 + 5903 5903 = **Раздел: Локатор ** = 5904 5904 5905 5905 ... ... @@ -5907,7 +5907,7 @@ 5907 5907 5908 5908 (% class="box infomessage" %) 5909 5909 ((( 5910 -**GET /api/v3/locators** 5982 +**GET /api/v3/locators ** 5911 5911 ))) 5912 5912 5913 5913 В заголовках запроса: X-Auth: Токен авторизации ... ... @@ -5916,33 +5916,83 @@ 5916 5916 Пример ответа: 5917 5917 5918 5918 ((( 5991 +((( 5992 +{ 5993 + "vehiclesIds": [ ~/~/ Объекты 5994 + 0 5995 + ], 5996 + "geoIds": [ ~/~/ Геозоны 5997 + 0 5998 + ], 5999 + "fieldsIds": [ ~/~/ Поля 6000 + 0 6001 + ], 6002 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6003 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 6004 + "agentName": "string", ~/~/ Наименование агента. 6005 + "isEnabled": true, ~/~/ Активность 6006 + "created": "2025-05-26T11:31:05.399Z", ~/~/ Дата создания 6007 + "updated": "2025-05-26T11:31:05.399Z", ~/~/ Дата обновления 6008 + "name": "string", ~/~/ Наименование. 6009 + "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6010 + "activationMode": 0, ~/~/ Определяет вид активации локаторов ( 0 - сейчас, 1 - запланировать на время) 6011 + "activationTime": "2025-05-26T11:31:05.399Z", ~/~/ Время активации 6012 + "validity": 0, ~/~/ Значение срока действия 6013 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6014 + "autoProlongation": true, ~/~/ Автопродление срока действия. 6015 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6016 + "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6017 + "url": "string", ~/~/ Ссылка 6018 + "language": 0, ~/~/ Язык 6019 + "showVehicleName": true, ~/~/ Наименование объекта 6020 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6021 + "allowTrackReport": true, ~/~/ Трек 6022 + "showTrackTracing": true, ~/~/ Трассировка трека 6023 + "showSensors": true, ~/~/ Датчик 6024 + "availableMapLayers": [ ~/~/ Слои на карте 6025 + 0 6026 + ] 6027 +} 6028 +))) 6029 +))) 6030 + 6031 + 6032 +== **Получение перечня моделей ** == 6033 + 6034 +(% class="box successmessage" %) 6035 +((( 6036 +**POST /api/v3/models/find** 6037 +))) 6038 + 6039 +Пример запроса: 6040 + 6041 +((( 6042 +((( 6043 +{ 6044 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6045 + "name": "string", ~/~/ Наименование локатора 6046 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6047 +))) 6048 + 6049 + 6050 + 6051 + Пример ответа: 6052 + 6053 + 6054 +((( 5919 5919 [ 5920 5920 { 5921 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 5922 - "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 5923 - "agentName": "string", ~/~/ Наименование агента. 5924 - "isEnabled": true, ~/~/ Активен 5925 - "created": "2025-03-12T06:48:41.254Z", ~/~/ Дата создания 5926 - "updated": "2025-03-12T06:48:41.254Z", ~/~/ Дата обновления 5927 - "name": "string", ~/~/ Наименование 5928 - "status": 0, ~/~/ 5929 - "activationMode": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 5930 - "activationTime": "2025-03-12T06:48:41.254Z", ~/~/ Определяет вид активации локаторов. ( 0 - сейчас, 1 - время активации) 5931 - "validity": 0, ~/~/ Срок действия в днях (1-90). 5932 - "autoProlongation": true, ~/~/ Автопродление срока действия. 5933 - "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 5934 - "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 5935 - "url": "string", ~/~/ Ссылка 5936 - "language": 0, ~/~/ Язык. 5937 - "vehiclesCount": 0, ~/~/ Количество объектов. 5938 - "geozonesCount": 0, ~/~/ Количество геозон. 5939 - "fieldsCount": 0 ~/~/ Количество полей. 6057 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6058 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6059 + "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6060 + "name": "string", ~/~/ Наименование локатора 6061 + "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 5940 5940 } 5941 5941 ] 5942 5942 ))) 6065 +))) 5943 5943 5944 5944 5945 - 5946 5946 == **Создание локатора** == 5947 5947 5948 5948 (% class="box successmessage" %) ... ... @@ -5963,6 +5963,24 @@ 5963 5963 "autoProlongation": true, ~/~/ Автопродление срока действия. 5964 5964 "url": "string", ~/~/ Ссылка 5965 5965 "language": 0 ~/~/ Язык 6088 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6089 + "vehiclesIds": [ ~/~/ Oбъекты 6090 + 0 6091 + ], 6092 + "geoIds": [ ~/~/ Геозоны 6093 + 0 6094 + ], 6095 + "fieldsIds": [ ~/~/ Поля 6096 + 0 6097 + ], 6098 + "showVehicleName": true, ~/~/ Наименование объекта 6099 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6100 + "allowTrackReport": true, ~/~/ Трек 6101 + "showTrackTracing": true, ~/~/ Трассировка трека 6102 + "showSensors": true, ~/~/ Датчик 6103 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6104 + 0 6105 + ] 5966 5966 } 5967 5967 ))) 5968 5968 ... ... @@ -5995,10 +5995,29 @@ 5995 5995 "autoProlongation": true, ~/~/ Автопродление срока действия 5996 5996 "url": "string", ~/~/ Ссылка 5997 5997 "language": 0 ~/~/ Язык 6138 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6139 + "vehiclesIds": [ ~/~/ Oбъекты 6140 + 0 6141 + ], 6142 + "geoIds": [ ~/~/ Геозоны 6143 + 0 6144 + ], 6145 + "fieldsIds": [ ~/~/ Поля 6146 + 0 6147 + ], 6148 + "showVehicleName": true, ~/~/ Наименование объекта 6149 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6150 + "allowTrackReport": true, ~/~/ Трек 6151 + "showTrackTracing": true, ~/~/ Трассировка трека 6152 + "showSensors": true, ~/~/ Датчик 6153 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6154 + 0 6155 + ] 5998 5998 } 6157 + 6158 + 5999 5999 ))) 6000 6000 6001 - 6002 6002 Пример ответа: 6003 6003 6004 6004 200 ~/~/ Success ... ... @@ -6162,7 +6162,6 @@ 6162 6162 Id ~/~/ Идентификатор поля 6163 6163 6164 6164 6165 -==== ==== 6166 6166 6167 6167 = **Раздел: Управление доступа к машинам** = 6168 6168