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 ... ... @@ -1425,7 +1425,7 @@ 1425 1425 - сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 1426 1426 - при задании сезонной нормы обязательны соответствующие даты начала/окончания. 1427 1427 1428 -== (% style="color:#000000; font-size:16px" %)**Получение па раметровобъектов**(%%) ==1437 +== (% style="color:#000000; font-size:16px" %)**Получение списка объектов с основными параметрами**(%%) == 1429 1429 1430 1430 (% class="box infomessage" %) 1431 1431 ((( ... ... @@ -2021,10 +2021,12 @@ 2021 2021 { 2022 2022 "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 2023 2023 "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 2024 - "mileageBegin": 0, ~/~/ Пробег на начало периода 2025 - "mileageEnd": 0, ~/~/ Пробег на окончание периода 2026 - "motohoursBegin": 0, ~/~/ Моточасы на начало периода 2027 - "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 2033 + "mileage": 0, ~/~/ Пробег за период, километры 2034 + "mileageBegin": 0, ~/~/ Пробег на начало периода, километры 2035 + "mileageEnd": 0, ~/~/ Пробег на окончание периода, километры 2036 + "motohours": 0, ~/~/ Моточасы за период, секунды 2037 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода, секунды 2038 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода, секунды 2028 2028 } 2029 2029 ] 2030 2030 } ... ... @@ -2073,6 +2073,12 @@ 2073 2073 } 2074 2074 ] 2075 2075 2087 +(% class="box warningmessage" %) 2088 +((( 2089 +Максимальное кол-во периодов - 1440 (maxPeriodsCount = 1440) 2090 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2091 +))) 2092 + 2076 2076 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 2077 2077 2078 2078 (% class="box infomessage" %) ... ... @@ -2515,6 +2515,32 @@ 2515 2515 2516 2516 Success 2517 2517 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 + 2518 2518 == (% style="color:#000000; font-size:16px" %)**Удаление уведомления**(%%) == 2519 2519 2520 2520 (% class="box errormessage" %) ... ... @@ -3705,7 +3705,7 @@ 3705 3705 **POST /api/v3/vehicles/import/{agentId}** 3706 3706 ))) 3707 3707 3708 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 3751 +Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml (расширение *.xls)** или **wlp. **Также они могут находится в** zip-архиве (один файл - один архив).** 3709 3709 3710 3710 В пути указывается **agentId** - id клиента. 3711 3711 ... ... @@ -3717,7 +3717,7 @@ 3717 3717 3718 3718 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3719 3719 |withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3720 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1- Замена,2- Слияние,3- Добавление3763 +|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: Replace - Замена, Merge - Слияние, Add - Добавление 3721 3721 3722 3722 В теле использовать тип **form-data,** тип значения** file** 3723 3723 ... ... @@ -3979,7 +3979,7 @@ 3979 3979 |dangerousDrivingViolations|Резкое вождение 3980 3980 |sensorViolations|Нарушение по датчику 3981 3981 |moveTime|Время в движении 3982 -|mileage|Пробег 4025 +|mileage|Пробег (км) 3983 3983 |tripsCount|Количество рейсов 3984 3984 |motohours|Моточасы 3985 3985 |maxSpeed|Максимальная скорость