Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Gadmin1 +XWiki.SupportZhuchkov - Content
-
... ... @@ -14,11 +14,20 @@ 14 14 15 15 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 16 16 17 -(% style="color:#000000" %)− (%%)При **редактировании** необходимо передавать все параметры пользователяв теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При **редактировании** любой записи (пользователь, объект и т.д) необходимо передавать все параметры записи в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 18 18 19 + 20 +(% style="color:#000000; font-size:16px" %)**Рекомендации** 21 + 22 +- Для запросов по API рекомендуется наделить пользователя ролью **Администратора партнера**, в противном случае при выполнении некоторых запросов у него не будет хватать прав (чаще всего сталкиваются с отсутствием прав при запросах сообщений от терминала за период). 23 + 19 19 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 20 20 21 -== (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 26 +(% class="box warningmessage" id="H41043244243E44043843743044643844F" %) 27 +((( 28 +(% style="color:#000000; font-size:16px" %)**Авторизация**(%%) 29 +(% style="color:#000000; font-size:16px" %)Адрес сервера всегда следует указывать именно тот, по которому происходит вход в СМТ (https:~/~/hosting.glonasssoft.ru/ , [[https:~~/~~/regions.glonasssoft.ru/>>https://regions.glonasssoft.ru/]] или другие) 30 +))) 22 22 23 23 (% class="box successmessage" %) 24 24 ((( ... ... @@ -971,7 +971,7 @@ 971 971 972 972 Ответ: В случае успеха **Success 200** 973 973 974 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства**(%%) = 983 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Транспортные средства (объекты)**(%%) = 975 975 976 976 == (% style="color:#000000; font-size:16px" %)**Получение информации об объекте**(%%) == 977 977 ... ... @@ -1179,8 +1179,6 @@ 1179 1179 "idTemplate": "" ~/~/ ID шаблона команды 1180 1180 } 1181 1181 1182 -(% class="wikigeneratedid" %) 1183 -== == 1184 1184 1185 1185 == **Получить ответ на отправленную на ТС команду** == 1186 1186 ... ... @@ -1427,7 +1427,7 @@ 1427 1427 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1428 1428 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1429 1429 1430 -== (% style="color:#000000; font-size:16px" %)**Получение па раметровобъектов**(%%) ==1437 +== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1431 1431 1432 1432 (% class="box infomessage" %) 1433 1433 ((( ... ... @@ -2023,10 +2023,12 @@ 2023 2023 { 2024 2024 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2025 2025 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2026 - "mileageBegin": 0, ~/~/ Пробег на начало периода 2027 - "mileageEnd": 0, ~/~/ Пробег на окончание периода 2028 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2029 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2033 + "mileage": 0, ~/~/ Пробег за период, километры 2034 + "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2035 + "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2036 + "motohours": 0, ~/~/ Моточасы за период, секунды 2037 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2038 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2030 2030 } 2031 2031 ] 2032 2032 } ... ... @@ -2075,6 +2075,12 @@ 2075 2075 } 2076 2076 ] 2077 2077 2087 +(% class="box warningmessage" %) 2088 +((( 2089 +Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2090 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2091 +))) 2092 + 2078 2078 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2079 2079 2080 2080 (% class="box infomessage" %) ... ... @@ -2517,6 +2517,32 @@ 2517 2517 2518 2518 Success 2519 2519 2535 + 2536 +== (% style="color:#000000; font-size:16px" %)**Автоматическое продление уведомлений **(%%) == 2537 + 2538 +(% class="box warningmessage" %) 2539 +((( 2540 +**PUT** /api/v3/notifications/prolongation 2541 +))) 2542 + 2543 +Метод позволяет продлить уведомления. 2544 + 2545 +Метод запроса **PUT** 2546 + 2547 +URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/notifications/prolongation 2548 + 2549 +В заголовках запроса: X-Auth: Токен авторизации. 2550 + 2551 +Тело запроса: 2552 + 2553 +[ 2554 + 2555 +0 2556 + 2557 +] 2558 + 2559 +где 0 идентификатор ids. 2560 + 2520 2520 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2521 2521 2522 2522 (% class="box errormessage" %) ... ... @@ -3707,7 +3707,7 @@ 3707 3707 **POST /api/v3/vehicles/import/{agentId}** 3708 3708 ))) 3709 3709 3710 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 3751 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).** 3711 3711 3712 3712 В пути указывается **agentId** - id клиента. 3713 3713 ... ... @@ -3719,7 +3719,7 @@ 3719 3719 3720 3720 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3721 3721 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3722 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1- Замена,2- Слияние,3- Добавление3763 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление 3723 3723 3724 3724 В теле использовать тип **form-data,** тип значения** file** 3725 3725 ... ... @@ -3981,7 +3981,7 @@ 3981 3981 |dangerousDrivingViolations|Резкое вождение 3982 3982 |sensorViolations|Нарушение по датчику 3983 3983 |moveTime|Время в движении 3984 -|mileage|Пробег 4025 +|mileage|Пробег (км) 3985 3985 |tripsCount|Количество рейсов 3986 3986 |motohours|Моточасы 3987 3987 |maxSpeed|Максимальная скорость