Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Gadmin1 +XWiki.krainovim - Content
-
... ... @@ -14,13 +14,13 @@ 14 14 15 15 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 16 16 17 -(% style="color:#000000" %)− (%%)При **редактировании**необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!17 +(% style="color:#000000" %)− (%%)При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты! 18 18 19 19 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Авторизация**(%%) = 20 20 21 21 == (% style="color:#000000; font-size:16px" %)**Авторизация**(%%) == 22 22 23 -(% class="box successmessage" %)23 +(% class="box infomessage" %) 24 24 ((( 25 25 (% lang="en-US" %)**POST /api/v3/auth/login** 26 26 ))) ... ... @@ -31,7 +31,7 @@ 31 31 32 32 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login>>https://hosting.glonasssoft.ru/api/v3/auth/login]] 33 33 34 -(% style="color:#000000" %)В случае успешного выполнения метода, поле «AuthId» содержит токен авторизации «X-Auth». 34 +(% style="color:#000000" %)В случае успешного выполнения метода, поле «__**AuthId**__» содержит токен авторизации «__**X-Auth**__». 35 35 36 36 (% style="color:#000000" %)Параметры в теле запроса (JSON): 37 37 ... ... @@ -40,6 +40,7 @@ 40 40 "password": "testuser" 41 41 } 42 42 43 + 43 43 (% style="color:#000000" %)**Ответ:** 44 44 45 45 (% lang="en-US" %) ... ... @@ -54,12 +54,6 @@ 54 54 55 55 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. 56 56 57 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 58 -|(% style="width:215px" %)(% style="color:#000000" %)login|(% style="width:861px" %)Логин пользователя 59 -|(% style="width:215px" %)(% style="color:#000000" %)password|(% style="width:861px" %)Пароль пользователя 60 -|(% style="width:215px" %)(% style="color:#000000" %)AuthId|(% style="width:861px" %)Токен авторизации 61 -|(% style="width:215px" %)(% style="color:#000000" %)User|(% style="width:861px" %)Логин пользователя 62 - 63 63 == (% style="color:#000000; font-size:16px" %)**Проверка авторизации**(%%) == 64 64 65 65 (% class="box infomessage" %) ... ... @@ -98,51 +98,30 @@ 98 98 Запрос должен содержать данные параметра "**agentId**" 99 99 100 100 (% style="color:#000000" %)Ответ: 96 +А 101 101 { 102 - "agentId": "", (%%) 103 - "parentId": "", 104 - "parentName": "string", 105 - "name": "string", 106 - "fullName": "string", 107 - "agentInfoType": 0, 108 - "isForeign": true/false, 109 - "district": "string", 110 - "region": "string", 111 - "city": "string", 112 - "inn": "string", 113 - "kpp": "string", 114 - "address": "string", 115 - "addressFact": "string", 116 - "email": "string", 117 - "director": "string", 118 - "bankName": "string", 119 - "bankBIK": "string", 120 - "bankRS": "string", 121 - "bankKS": "string" 98 + "agentId": "", ~/~/ идентификатор клиента (%%) 99 + "parentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента-родителя(%%) 100 + "parentName": "string", ~/~/ наименование (% style="color:#000000" %)клиента-родителя(%%) 101 + "name": "string", (% style="color:#000000" %)~/~/ наименование клиента (%%) 102 + "fullName": "string", (% style="color:#000000" %)~/~/ полное наименование клиента(%%) 103 + "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%) 104 + "isForeign": true/false, ~/~/ Иностранный контрагент 105 + "district": "string", ~/~/ округ 106 + "region": "string", ~/~/ регион 107 + "city": "string", ~/~/ город 108 + "inn": "string", ~/~/ ИНН клиента 109 + "kpp": "string", ~/~/ КПП клиента 110 + "address": "string", ~/~/ юридический адрес 111 + "addressFact": "string", ~/~/ фактический адрес 112 + "email": "string", ~/~/ почта 113 + "director": "string", ~/~/ ФИО руководителя 114 + "bankName": "string", ~/~/ Банк 115 + "bankBIK": "string", ~/~/ БИК 116 + "bankRS": "string", ~/~/ Номер счета 117 + "bankKS": "string" ~/~/ Корр. счет 122 122 } 123 123 124 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 125 -|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 126 -|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 127 -|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 128 -|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 129 -|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 130 -|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 131 -|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 132 -|(% style="width:215px" %)district|(% style="width:861px" %)Округ 133 -|(% style="width:215px" %)region|(% style="width:861px" %)Регион 134 -|(% style="width:215px" %)city|(% style="width:861px" %)Город 135 -|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 136 -|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 137 -|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 138 -|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 139 -|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 140 -|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 141 -|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 142 -|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 143 -|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 144 -|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 145 - 146 146 == (% style="color:#000000; font-size:16px" %)**Получение параметров дочерних клиентов**(%%) == 147 147 148 148 (% class="box infomessage" %) ... ... @@ -156,7 +156,7 @@ 156 156 157 157 (% style="color:#000000" %)− возвращается информация о клиенте, которому принадлежит авторизованный пользователь, и его дочерних клиентах; 158 158 159 -(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его клиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__». 133 +(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__». 160 160 161 161 (% style="color:#000000" %)Метод запроса: **POST** 162 162 ... ... @@ -171,23 +171,15 @@ 171 171 (% style="color:#000000" %)Ответ: 172 172 173 173 { 174 - "agentId": "",(% style="color:#000000" %) (%%) 175 - "parentId": "", 176 - "name": "string", 177 - "fullName": "string", 178 - "agentInfoType": 0, 179 -(% style="color:#000000" %) "status": "", 148 + "agentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента (%%) 149 + "parentId": "", (% style="color:#000000" %)~/~/ идентификатор клиента-родителя(%%) 150 + "parentName": "string", ~/~/ наименование (% style="color:#000000" %)клиента-родителя(%%) 151 + "name": "string", (% style="color:#000000" %)~/~/ наименование клиента (%%) 152 + "fullName": "string", (% style="color:#000000" %)~/~/ полное наименование клиента(%%) 153 + "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 154 + "status": "",~/~/ статус клиента (0- Новый, 1 - Потенциальный, 2 - В разработке, 3 - Тест, 4 - На оформлении, 5 - Внедрение, 6 - Работает, 7 - Работал, 8 - Потерян, 9 - Отказ) 180 180 } 181 181 182 - 183 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 184 -|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 185 -|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 186 -|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 187 -|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 188 -|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 189 -|(% style="width:215px" %)(% style="color:#000000" %)status|(% style="width:861px" %)Статус клиента, 0 - заблокирован, 1 - Активен 190 - 191 191 == (% style="color:#000000; font-size:16px" %)**Добавление клиента**(%%) == 192 192 193 193 (% class="box successmessage" %) ... ... @@ -206,7 +206,7 @@ 206 206 Параметры в теле запроса (JSON): 207 207 208 208 { 209 - "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 175 + "parentId": "00000000-0000-0000-0000-000000000000", ~/~/ идентификатор клиента-родителя 210 210 "name": "string", ~/~/ имя 211 211 "fullName": "string", ~/~/ полное наименование 212 212 "agentInfoType": 0, (% style="color:#000000" %)~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор)(%%) ... ... @@ -251,28 +251,6 @@ 251 251 "bankKS": "string" ~/~/ корр. счёт 252 252 } 253 253 254 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 255 -|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 256 -|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 257 -|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 258 -|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 259 -|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 260 -|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 261 -|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 262 -|(% style="width:215px" %)district|(% style="width:861px" %)Округ 263 -|(% style="width:215px" %)region|(% style="width:861px" %)Регион 264 -|(% style="width:215px" %)city|(% style="width:861px" %)Город 265 -|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 266 -|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 267 -|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 268 -|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 269 -|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 270 -|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 271 -|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 272 -|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 273 -|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 274 -|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 275 - 276 276 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 277 277 278 278 (% class="box warningmessage" %) ... ... @@ -288,6 +288,7 @@ 288 288 289 289 В заголовках запроса: X-Auth: Токен авторизации 290 290 235 + 291 291 Параметры в теле запроса (JSON): 292 292 293 293 { ... ... @@ -312,6 +312,7 @@ 312 312 "bankKS": "string" ~/~/ корр. счёт 313 313 } 314 314 260 + 315 315 Ответ: 316 316 317 317 { ... ... @@ -354,21 +354,6 @@ 354 354 355 355 Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200». 356 356 357 -== (% style="color:#000000; font-size:16px" %)**Смена статуса клиента (активация/блокировка)**(%%) == 358 - 359 -(% class="box warningmessage" %) 360 -((( 361 -**PUT /api/v3/agents/{id}/changeStatus/{status}** 362 -))) 363 - 364 -Метод позволяет изменить статус клиента, указанного в запросе. 365 - 366 -В пути указывается GUID клиента и статус клиента. 367 - 368 -**status **- значение 0 - заблокирован, 1 - активен. 369 - 370 -Ответ: Code 204 371 - 372 372 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Пользователи**(%%) = 373 373 374 374 == (% style="color:#000000; font-size:16px" %)**Добавление пользователя**(%%) == ... ... @@ -432,6 +432,7 @@ 432 432 "password": "string", 433 433 "email": "string", 434 434 366 + 435 435 (% style="text-align:left" %) 436 436 (% style="color:#000000; font-weight:normal" %)Ответ: 437 437 ... ... @@ -460,7 +460,6 @@ 460 460 (% style="text-align:left" %) 461 461 (% style="color:#000000; font-weight:normal" %)} 462 462 463 - 464 464 == (% style="color:#000000; font-size:16px" %)**Получение списка пользователей**(%%) == 465 465 466 466 (% class="box infomessage" %) ... ... @@ -780,6 +780,7 @@ 780 780 "maxspeed": 0, 781 781 "width": 0, 782 782 "imbeddedtrailer": true, 714 + "fueloutlay": 0, 783 783 "hoppercapacity": 0, 784 784 "hopperdischargespeed": 0, 785 785 "modelType": 0, ... ... @@ -796,8 +796,9 @@ 796 796 |(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч 797 797 |(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах 798 798 |(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат 731 +|(% style="width:215px" %)(% style="color:#000000" %)fueloutlay|(% style="width:861px" %)- 799 799 |(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера 800 -|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость 2выгрузки из бункера, л/сек733 +|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость выгрузки из бункера, л/сек 801 801 |(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car 802 802 |(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта 803 803 |(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта ... ... @@ -889,24 +889,12 @@ 889 889 "maxspeed": 0, 890 890 "width": 0, 891 891 "imbeddedtrailer": true, 825 + "fueloutlay": 0, 892 892 "hoppercapacity": 0, 893 893 "hopperdischargespeed": 0, 894 894 "modelType": 0 895 895 } 896 896 897 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 898 -|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта 899 -|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта 900 -|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта 901 -|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта 902 -|(% style="width:215px" %)(% style="color:#000000" %)picture|(% style="width:861px" %)Название иконки транспорта 903 -|(% style="width:215px" %)(% style="color:#000000" %)minspeed|(% style="width:861px" %)Минимальная технологическая скорость обработки поля, в км/ч 904 -|(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч 905 -|(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах 906 -|(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат 907 -|(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера 908 -|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость выгрузки из бункера, л/сек 909 -|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car 910 910 911 911 == (% style="color:#000000; font-size:16px" %)**Редактирование модели**(%%) == 912 912 ... ... @@ -961,20 +961,6 @@ 961 961 "modelType": 0 962 962 } 963 963 964 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 965 -|(% style="width:215px" %)(% style="color:#000000" %)id|(% style="width:861px" %)ID модели объекта 966 -|(% style="width:215px" %)(% style="color:#000000" %)parentId|(% style="width:861px" %)ID клиента, которому принадлежит модель объекта 967 -|(% style="width:215px" %)(% style="color:#000000" %)parentName|(% style="width:861px" %)Имя клиента, которому принадлежит модель объекта 968 -|(% style="width:215px" %)(% style="color:#000000" %)name|(% style="width:861px" %)Имя модели объекта 969 -|(% style="width:215px" %)(% style="color:#000000" %)picture|(% style="width:861px" %)Название иконки транспорта 970 -|(% style="width:215px" %)(% style="color:#000000" %)minspeed|(% style="width:861px" %)Минимальная технологическая скорость обработки поля, в км/ч 971 -|(% style="width:215px" %)(% style="color:#000000" %)maxspeed|(% style="width:861px" %)Максимальная технологическая скорость обработки поля, в км/ч 972 -|(% style="width:215px" %)(% style="color:#000000" %)width|(% style="width:861px" %)Ширина агрегата, в метрах 973 -|(% style="width:215px" %)(% style="color:#000000" %)imbeddedtrailer|(% style="width:861px" %)Опция: Содержит встроенный агрегат 974 -|(% style="width:215px" %)(% style="color:#000000" %)hoppercapacity|(% style="width:861px" %)Объем бункера 975 -|(% style="width:215px" %)(% style="color:#000000" %)hopperdischargespeed|(% style="width:861px" %)Скорость выгрузки из бункера, л/сек 976 -|(% style="width:215px" %)(% style="color:#000000" %)modelType|(% style="width:861px" %)Определяет тип модели объекта: 0 - None, 1 - Agro, 2 - Cargo, 3 - Car 977 - 978 978 == (% style="color:#000000; font-size:16px" %)**Удаление модели**(%%) == 979 979 980 980 (% class="box errormessage" %) ... ... @@ -1802,7 +1802,7 @@ 1802 1802 1803 1803 (% style="color:#000000" %)Метод запроса: **GET** 1804 1804 1805 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/devices/types>>https://hosting.glonasssoft.ru/api/v3/devices/types]] 1712 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]] 1806 1806 1807 1807 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1808 1808 ... ... @@ -1885,51 +1885,6 @@ 1885 1885 } 1886 1886 ] 1887 1887 1888 -== (% style="color:#000000; font-size:16px" %)**Получить тип и номер входа сырого параметра **(%%) == 1889 - 1890 -(% class="box infomessage" style="text-align: left;" %) 1891 -((( 1892 -**POST /api/v3/terminalMessages/mapping** 1893 -))) 1894 - 1895 -Запрос позволяет узнать тип и номер входа для сырого параметра, приходящего по указанному протоколу. 1896 - 1897 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/terminalMessages/mapping 1898 - 1899 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1900 - 1901 -{ 1902 - "protocolType": 0, 1903 - "params": ["string"] 1904 -} 1905 - 1906 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1907 -|protocolType|ID типа протокола 1908 -|params|((( 1909 -Массив наименований параметров в сообщении 1910 -))) 1911 - 1912 -Ответ: 1913 - 1914 -{ 1915 - "protocolType": 0, 1916 - "mapping": { 1917 - "additionalProp1": { 1918 - "inputType": 0, 1919 - "inputNumber": 0 1920 - }, 1921 - "additionalProp2": { 1922 - "inputType": 0, 1923 - "inputNumber": 0 1924 - } 1925 - } 1926 -} 1927 - 1928 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1929 -|protocolType|Тип протокола 1930 -|inputType|Тип входа, 0 - Цифровой, 1 - Аналоговый, 2 - Импульсный, 3 - Rs232, 4 - Rs485, 5 - FMS, 6 - Диагностический, 7 - 1-Wire, 8 - Частотный, 9 - BLE, 255 - Виртуальный 1931 -|inputNumber|Номер входа 1932 - 1933 1933 == (% style="color:#000000; font-size:16px" %)**Запрос списка сообщений**(%%) == 1934 1934 1935 1935 (% class="box infomessage" %) ... ... @@ -1954,11 +1954,6 @@ 1954 1954 "to": "2023-03-29T09:14:46.107Z" ~/~/ конец периода запроса 1955 1955 } 1956 1956 1957 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1958 -|vehicleId|ID объекта 1959 -|from|Дата и время начала периода запроса 1960 -|to|Дата и время окончания периода запроса 1961 - 1962 1962 Ответ: 1963 1963 1964 1964 [ ... ... @@ -1965,43 +1965,80 @@ 1965 1965 { 1966 1966 "messages": [ 1967 1967 { 1968 - "deviceTime": "2023-11-29T07:40:44.052Z", 1969 - "serverTime": "2023-11-29T07:40:44.052Z", 1970 - "speed": 0, 1971 - "altitude": 0, 1972 - "latitude": 0, 1973 - "longitude": 0, 1974 - "satellites": 0, 1975 - "course": 0, 1976 - "voltage": 0, 1977 - "parameters": { 1825 + "deviceTime": "2023-03-29T09:14:46.125Z", ~/~/ Время устройства 1826 + "serverTime": "2023-03-29T09:14:46.125Z", ~/~/ Время сервера 1827 + "speed": 0, ~/~/ Скорость, км/ч 1828 + "altitude": 0, ~/~/ Высота, м 1829 + "latitude": 0, ~/~/ Широта [-90°;90°] 1830 + "longitude": 0, ~/~/ Долгота [-180°;180°] 1831 + "satellites": 0, ~/~/ Кол-во спутников 1832 + "voltage": 0, ~/~/ Напряжение 1833 + "parameters": { ~/~/ список параметров датчиков передаваемых терминалом 1978 1978 "additionalProp1": "string", 1979 1979 "additionalProp2": "string", 1980 1980 "additionalProp3": "string" 1981 1981 }, 1982 - "photoCount": 0, 1983 - "lbsCorrectedCoords": true, 1984 - "protocolType": 0 1838 + "photoCount": 0 ~/~/ Кол-во фото 1985 1985 } 1986 1986 ] 1987 1987 } 1988 1988 ] 1989 1989 1990 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 1991 -|deviceTime|Время сообщения терминала 1992 -|serverTime|Время когда сообщение поступило на сервер 1993 -|speed|Скорость 1994 -|altitude|Высота над уровнем моря 1995 -|latitude|Широта 1996 -|longitude|Долгота 1997 -|satellites|Кол-во спутников 1998 -|course|Курс 1999 -|voltage|Бортовое напряжение 2000 -|parameters|Список параметров и их значений 2001 -|photoCount|Количество фото 2002 -|lbsCorrectedCoords|Признак того, что координаты были скорректированы по LBS, true - скорректированы, false - не скорректированы 2003 -|protocolType|ID типа протокола 1844 +== (% style="color:#000000; font-size:16px" %)**Экспорт сообщений**(%%) == 2004 2004 1846 +(% class="box infomessage" %) 1847 +((( 1848 +**POST /api/v3/vehicles/export/history** 1849 +))) 1850 + 1851 +Метод возвращает список сообщений терминала объекта за выбранный период. 1852 + 1853 +(% style="text-align: left;" %) 1854 +Метод запроса **POST** 1855 + 1856 +(% style="text-align: left;" %) 1857 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/export/history 1858 + 1859 +(% style="text-align: left;" %) 1860 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1861 + 1862 +{ 1863 + "vehicleId": 0, ~/~/ ID объекта 1864 + "asArchive": true, ~/~/ true - Архивировать файл, False - не архивировать 1865 + "from": "2023-09-27T12:17:45.973Z", ~/~/ Дата и время начала запроса 1866 + "to": "2023-09-27T12:17:45.973Z" ~/~/ Дата и время окончания запроса 1867 +} 1868 + 1869 +Ответ: 1870 + 1871 +Получаете файл. Сообщение: Code 200/Success 1872 + 1873 +== (% style="color:#000000; font-size:16px" %)**Статус экспорта сообщений**(%%) == 1874 + 1875 +(% class="box infomessage" %) 1876 +((( 1877 +**GET /api/v3/vehicles/export/history/status** 1878 +))) 1879 + 1880 +Метод возвращает список сообщений терминала объекта за выбранный период. 1881 + 1882 +(% style="text-align: left;" %) 1883 +Метод запроса **GET** 1884 + 1885 +(% style="text-align: left;" %) 1886 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/export/history/status 1887 + 1888 +(% style="text-align: left;" %) 1889 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1890 + 1891 +Ответ: 1892 + 1893 +{ 1894 + "activity": true, ~/~/ статус экспорт, где true - экспорт в процессе выполнения, false - в данный момент ничего не экспортируется. 1895 + "progress": 0, ~/~/ прогресс экспорта, от 0 до 100%. 1896 + "message": "string" ~/~/ текст описывающий статус. 1897 +} 1898 + 2005 2005 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных об объекте за период**(%%) = 2006 2006 2007 2007 == (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) == ... ... @@ -2135,91 +2135,6 @@ 2135 2135 } 2136 2136 ] 2137 2137 2138 - 2139 -(% style="color:#000000; font-size:16px" %)**Получение данных по событиям движения и стоянок у объектов** 2140 - 2141 -(% class="box infomessage" %) 2142 -((( 2143 -**POST/api/v3/vehicles/moveStop** 2144 -))) 2145 - 2146 -Метод запроса: **POST** 2147 - 2148 -URL запроса: https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/moveStop 2149 - 2150 -В заголовках запроса: X-Auth: Токен авторизации 2151 - 2152 - 2153 -Тело запроса: 2154 - 2155 -{ 2156 - 2157 - "vehicleIds": [ ], ~/~/ Список ID объектов 2158 - 2159 - "from": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время начало запроса 2160 - 2161 - "to": "2024-01-30T10:12:19.125Z", ~/~/ Дата и время окончания запроса 2162 - 2163 - "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 2164 - 2165 -} 2166 - 2167 - 2168 -Ответ: 2169 - 2170 -[ 2171 - 2172 - { 2173 - 2174 - "vehicleId": 0, ~/~/ ID объекта 2175 - 2176 - "vehicleName": "string", ~/~/ Имя объекта 2177 - 2178 - "moves": [ ~/~/ Событие движения 2179 - 2180 - { 2181 - 2182 - "mileage": 0, ~/~/ Пробег, км 2183 - 2184 - "eventId": 0, ~/~/ Идентификатор события 2185 - 2186 - "eventName": "string", ~/~/ Название события 2187 - 2188 - "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2189 - 2190 - "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2191 - 2192 - "duration": 0 ~/~/ Продолжительность события, секунд 2193 - 2194 - } 2195 - 2196 - ], 2197 - 2198 - "stops": [ ~/~/ События стоянок 2199 - 2200 - { 2201 - 2202 - "address": "string", ~/~/ Адрес события 2203 - 2204 - "eventId": 0, ~/~/ Идентификатор события 2205 - 2206 - "eventName": "string", ~/~/ Название события 2207 - 2208 - "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события 2209 - 2210 - "end": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время окончания события 2211 - 2212 - "duration": 0 ~/~/ Продолжительность события, секунд 2213 - 2214 - 2215 - } 2216 - 2217 - ] 2218 - 2219 - } 2220 - 2221 -] 2222 - 2223 2223 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2224 2224 2225 2225 == (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == ... ... @@ -3118,83 +3118,6 @@ 3118 3118 Success 3119 3119 3120 3120 3121 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Назначения агрегатов**(%%) = 3122 - 3123 -== (% style="color:#000000; font-size:16px" %)**Получить список назначений агрегатов на выбранные объекты**(%%) == 3124 - 3125 -(% class="box infomessage" %) 3126 -((( 3127 -**POST /api/v3/Trailers** 3128 -))) 3129 - 3130 -Пример запроса: 3131 - 3132 -{ 3133 - "startDate": "2023-11-14T10:48:03.671Z", 3134 - "endDate": "2023-11-14T10:48:03.671Z", 3135 - "ids": [ 0 ], 3136 - "timezone": 0 3137 -} 3138 - 3139 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3140 -|(% style="width:215px" %)startDate|(% style="width:861px" %)Дата и время начала запроса 3141 -|(% style="width:215px" %)endDate|(% style="width:861px" %)Дата и время окончания запроса 3142 -|(% style="width:215px" %)ids|(% style="width:861px" %)Массив ID объектов 3143 -|(% style="width:215px" %)timezone|(% style="width:861px" %)Часовой пояс, по умолчанию UTC. 3144 - 3145 -Пример ответа: 3146 - 3147 -[ 3148 - { 3149 - "SD": "2023-11-14T10:48:03.717Z", 3150 - "ED": "2023-11-14T10:48:03.717Z", 3151 - "id": 0, 3152 - "SLat": 0, 3153 - "SLon": 0, 3154 - "ELat": 0, 3155 - "ELon": 0, 3156 - "mileage": 0 3157 - "Duration": 0 3158 - "Address": "string", 3159 - "Address2": "string", 3160 - "name": "string", 3161 - "rid": "string", 3162 - "rguid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3163 - "trailer": { 3164 - "ModelGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3165 - "Number": "string", 3166 - "Description": "string", 3167 - "OwnerGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3168 - "ExternalID": "string", 3169 - "Guid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3170 - "CreateTime": "2023-11-14T10:48:03.717Z", 3171 - "UpdateTime": "2023-11-14T10:48:03.717Z", 3172 - "IsDeleted": true 3173 - }, 3174 - "filesCount": 0, 3175 - } 3176 -] 3177 - 3178 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3179 -|SD|Дата и время начала события 3180 -|ED|Дата и время окончания события 3181 -|id|ID объекта 3182 -|SLat|Широта начальной координаты 3183 -|SLon|Долгота начальной координаты 3184 -|ELat|Широта конечной координаты 3185 -|ELon|Долгота конечной координаты 3186 -|mileage|Пробег 3187 -|Duration|Продолжительность 3188 -|Address|Адрес начального местоположения 3189 -|Address2|Адрес конечного местоположения 3190 -|name|Имя радиометки 3191 -|rid|Номер радиометки 3192 -|rguid|ID радиометки 3193 -|trailer|Информация об агрегате 3194 -|ModelGuid|ID агрегата 3195 -|Number|Название/номер агрегата 3196 -|Description|Текст примечания агрегата 3197 - 3198 3198 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Карты-метки**(%%) = 3199 3199 3200 3200 == (% style="color:#000000; font-size:16px" %)**Получить список карт-меток определенного клиента**(%%) == ... ... @@ -3216,19 +3216,13 @@ 3216 3216 { 3217 3217 "name": "string", 3218 3218 "number": 0, 3219 - "period": 0, 2951 + "period": 0, ~/~/ Частота трансляции радиометки 3220 3220 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3221 3221 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 2954 + "deleted": true 3222 3222 } 3223 3223 ] 3224 3224 3225 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3226 -|parentId|ID клиента 3227 -|name|Название карты-метки 3228 -|number|Номер 3229 -|period|Период запросов в секундах (работает только для агрегатов) 3230 -|id|ID карты-метки 3231 - 3232 3232 == (% style="color:#000000; font-size:16px" %)**Получить данные карты-метки**(%%) == 3233 3233 3234 3234 (% class="box infomessage" %) ... ... @@ -3244,18 +3244,13 @@ 3244 3244 { 3245 3245 "name": "string", 3246 3246 "number": 0, 3247 - "period": 0, 2973 + "period": 0, ~/~/ Частота трансляции радиометки 3248 3248 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3249 3249 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 2976 + "deleted": true 3250 3250 } 3251 3251 ] 3252 3252 3253 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3254 -|name|Название карты-метки 3255 -|number|Номер 3256 -|period|Период запросов в секундах (работает только для агрегатов) 3257 -|id|ID карты-метки 3258 -|parentId|ID клиента 3259 3259 3260 3260 == (% style="color:#000000; font-size:16px" %)**Добавить карту-метку**(%%) == 3261 3261 ... ... @@ -3271,6 +3271,7 @@ 3271 3271 "number": 0, 3272 3272 "period": 0, 3273 3273 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 2995 + "deleted": true 3274 3274 } 3275 3275 3276 3276 Ответ: ... ... @@ -3281,15 +3281,9 @@ 3281 3281 "period": 0, 3282 3282 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3283 3283 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3006 + "deleted": true 3284 3284 } 3285 3285 3286 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3287 -|name|Название карты-метки 3288 -|number|Номер 3289 -|period|Период запросов в секундах (работает только для агрегатов) 3290 -|id|ID карты-метки 3291 -|parentId|ID клиента 3292 - 3293 3293 == (% style="color:#000000; font-size:16px" %)**Редактировать карту-метку**(%%) == 3294 3294 3295 3295 (% class="box warningmessage" %) ... ... @@ -3305,6 +3305,7 @@ 3305 3305 "period": 0, 3306 3306 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3307 3307 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3024 + "deleted": true 3308 3308 } 3309 3309 3310 3310 Ответ: ... ... @@ -3315,15 +3315,9 @@ 3315 3315 "period": 0, 3316 3316 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3317 3317 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3035 + "deleted": true 3318 3318 } 3319 3319 3320 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3321 -|name|Название карты-метки 3322 -|number|Номер 3323 -|period|Период запросов в секундах (работает только для агрегатов) 3324 -|id|ID карты-метки 3325 -|parentId|ID клиента 3326 - 3327 3327 == (% style="color:#000000; font-size:16px" %)**Удалить карту-метку**(%%) == 3328 3328 3329 3329 (% class="box errormessage" %) ... ... @@ -3331,7 +3331,7 @@ 3331 3331 **DELETE /api/v3/Rfids/{rfidGuid}** 3332 3332 ))) 3333 3333 3334 -Передаем параметр **rfidGuid**- идентификатор карты-метки3045 +Передаем параметр rfidGuid - идентификатор карты-метки 3335 3335 3336 3336 Ответ: 3337 3337 ... ... @@ -3572,8 +3572,6 @@ 3572 3572 **PUT /api/v3/Billing/client/balance** 3573 3573 ))) 3574 3574 3575 -Устанавливает указанное значение баланса не создавая операции пополнение/снятие. 3576 - 3577 3577 Тело запроса: 3578 3578 3579 3579 { ... ... @@ -3587,50 +3587,6 @@ 3587 3587 |(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3588 3588 |(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3589 3589 3590 -== (% style="color:#000000; font-size:16px" %)**Пополнить баланс**(%%) == 3591 - 3592 -(% class="box warningmessage" %) 3593 -((( 3594 -**PUT /api/v3/billing/client/balance/deposit** 3595 -))) 3596 - 3597 -Создает операцию **Пополнение **с указанной суммой 3598 - 3599 -Тело запроса: 3600 - 3601 -{ 3602 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3603 - "Balance": 0 3604 -} 3605 - 3606 -Ответ: Success 3607 - 3608 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3609 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3610 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3611 - 3612 -== (% style="color:#000000; font-size:16px" %)**Списать с баланса**(%%) == 3613 - 3614 -Создает операцию **Списание **с указанной суммой 3615 - 3616 -(% class="box warningmessage" %) 3617 -((( 3618 -**PUT /api/v3/billing/client/balance/withdraw** 3619 -))) 3620 - 3621 -Тело запроса: 3622 - 3623 -{ 3624 - "ClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3625 - "Balance": 0 3626 -} 3627 - 3628 -Ответ: Success 3629 - 3630 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3631 -|(% style="width:215px" %)ClientId|(% style="width:861px" %)Идентификатор клиента 3632 -|(% style="width:215px" %)Balance|(% style="width:861px" %)Значение баланса 3633 - 3634 3634 == (% style="color:#000000; font-size:16px" %)**Изменить ограничения клиента**(%%) == 3635 3635 3636 3636 (% class="box warningmessage" %) ... ... @@ -3693,7 +3693,6 @@ 3693 3693 3694 3694 |=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3695 3695 |ClientId|Идентификатор клиента 3696 -|PlanId|Идентификатор тарифного плана 3697 3697 |Feature|Код услуги 3698 3698 |IsEnabled|Признак, определяющий активирована ли услуга 3699 3699 |IsFactual|Признак, определяющий расчёт по факту ... ... @@ -3703,305 +3703,6 @@ 3703 3703 |PeriodValue|Значение периода. 3704 3704 |PeriodType|Определяет тип периода действия услуги в тарифном плане, 0 - Дни, 1 - Месяцы 3705 3705 3706 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Импорт и Экспорт**(%%) = 3707 - 3708 -(% class="box warningmessage" %) 3709 -((( 3710 -Для тестирования запросов **Импорта **в Postman необходимо скачать его на ПК. Версия в браузере не позволяет загружать файлы в тело запроса. 3711 -))) 3712 - 3713 -== (% style="color:#000000; font-size:16px" %)**Импорт объектов**(%%) == 3714 - 3715 -(% class="box infomessage" %) 3716 -((( 3717 -**POST /api/v3/vehicles/import/{agentId}** 3718 -))) 3719 - 3720 -Запрос позволяет загрузить объекты в систему из файла. Импортируемый файл может быть в формате **xml** или **wlp. **Также они могут находится в** zip-архиве.** 3721 - 3722 -В пути указывается **agentId** - id клиента. 3723 - 3724 -**Заголовок** 3725 - 3726 -**X-Auth: [токен авторизации]** 3727 - 3728 -**Параметры** 3729 - 3730 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3731 -|withNoData|Параметр **Объекты без данных**. Определяет способ загрузки объекта, у которого отсутствует имя или модель объекта. true - загружать, false - пропускать. 3732 -|importMethod|Параметр **Метода импорта датчиков**. Определяет метод добавления датчиков импортируемых из файла. Значение: 1 - Замена, 2 - Слияние, 3 - Добавление 3733 - 3734 -В теле использовать тип **form-data,** тип значения** file** 3735 - 3736 -**Ключи** 3737 - 3738 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3739 -|data|В значении передаем файл объекта, формат **xml** или **wlp ** 3740 -|csv|В значении передаем файл датчиков, формат **csv** 3741 - 3742 -Ответ: 3743 - 3744 -{ 3745 - "vehicleId": 0, 3746 - "name": "string", 3747 - "errors": ["string"] 3748 -} 3749 - 3750 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3751 -|vehicleId|ID созданного объекта 3752 -|name|Имя созданного объекта 3753 -|errors|Ошибки и их описание 3754 - 3755 -== (% style="color:#000000; font-size:16px" %)**Импорт сообщений**(%%) == 3756 - 3757 -(% class="box infomessage" %) 3758 -((( 3759 -**POST** **/api/v3/vehicles/import/history/{vehicleId}** 3760 -))) 3761 - 3762 -(% class="wikigeneratedid" %) 3763 -Позволяет импортировать сообщения в выбранный объект. Сообщения должны иметь формат **wln** или **json**. Также они могут быть упакованы и переданы в виде в **zip-архива**. 3764 - 3765 -(% class="wikigeneratedid" %) 3766 -В пути указывается **vehicleId **- id объекта. 3767 - 3768 -**Заголовок** 3769 - 3770 -**X-Auth: [токен авторизации]** 3771 - 3772 -В теле использовать тип **form-data.** 3773 - 3774 -Ключи: 3775 - 3776 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3777 -|**history**|В значении передавать файл с историей 3778 - 3779 -В случае, если загружается история из файла **wln **можно выполнять подмену названий параметров. В ключе вы указываете название параметра из файла, в значении указываете значение на которое нужно заменить. 3780 - 3781 -Ответ: 3782 - 3783 -{ 3784 - "results": [ 3785 - { 3786 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3787 - "vehicleId": 0, 3788 - "errors": [ 3789 - "string" 3790 - ], 3791 - "firstMessageDate": "2023-11-28T09:27:58.949Z", 3792 - "lastMessageDate": "2023-11-28T09:27:58.949Z", 3793 - "producedCount": 0, 3794 - "msgCount": 0 3795 - } 3796 - ] 3797 -} 3798 - 3799 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3800 -|results|Результаты импорта в разрезе ТС 3801 -|vehicleGuid|Guid ТС 3802 -|vehicleId|ID ТС 3803 -|errors|Список ошибок импорта истории (если пустой - нет ошибок) 3804 -|firstMessageDate|Дата первого импортированного сообщения (UTC) 3805 -|lastMessageDate|Дата последнего импортированного сообщения (UTC) 3806 -|producedCount|Кол-во успешно отправленных в шину данных сообщений 3807 -|msgCount|Кол-во обработанных сообщений всего 3808 - 3809 -== (% style="color:#000000; font-size:16px" %)**Статус импорта сообщений**(%%) == 3810 - 3811 -(% class="box infomessage" %) 3812 -((( 3813 -**GET /api/v3/vehicles/import/history/status** 3814 -))) 3815 - 3816 -Запрос статуса импорта истории. Может потребоваться в случае импорта истории за большой период. 3817 - 3818 -Ответ: 3819 - 3820 -{ 3821 - "activity": true, 3822 - "progress": 0, 3823 - "message": "string" 3824 -} 3825 - 3826 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3827 -|activity|Активен ли экспорт/импорт истории сейчас, true - да, false - нет 3828 -|progress|Guid ТС 3829 - 3830 -== (% style="color:#000000; font-size:16px" %)**Экспорт объектов**(%%) == 3831 - 3832 -(% class="box infomessage" %) 3833 -((( 3834 -**POST /api/v3/vehicles/export** 3835 -))) 3836 - 3837 -Запрос позволяет экспортировать файлы с настройками объектов. В запросе передается массив id объектов. 3838 - 3839 -Тело запроса: 3840 - 3841 -[ 3842 - id 3843 -] 3844 - 3845 -Ответ: Success 200, получаете файлы с настройками. 3846 - 3847 -== (% style="color:#000000; font-size:16px" %)**Экспорт сообщений**(%%) == 3848 - 3849 -(% class="box infomessage" %) 3850 -((( 3851 -**POST /api/v3/vehicles/export/history** 3852 -))) 3853 - 3854 -Метод возвращает список сообщений терминала объекта за выбранный период. 3855 - 3856 -Тело запроса: 3857 - 3858 -{ 3859 - "vehicleId": 0, 3860 - "asArchive": true, 3861 - "from": "2023-09-27T12:17:45.973Z", 3862 - "to": "2023-09-27T12:17:45.973Z" 3863 -} 3864 - 3865 -Ответ: 3866 - 3867 -Получаете файл. Сообщение: Code 200/Success 3868 - 3869 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3870 -|vehicleId|ID объекта 3871 -|asArchive|true - Архивировать файл, False - не архивировать 3872 -|from|Дата и время начала запроса 3873 -|to|Дата и время окончания запроса 3874 - 3875 -== (% style="color:#000000; font-size:16px" %)**Статус экспорта сообщений**(%%) == 3876 - 3877 -(% class="box infomessage" %) 3878 -((( 3879 -**GET /api/v3/vehicles/export/history/status** 3880 -))) 3881 - 3882 -Метод возвращает список сообщений терминала объекта за выбранный период. 3883 - 3884 -Ответ: 3885 - 3886 -{ 3887 - "activity": true, 3888 - "progress": 0, 3889 - "message": "string" 3890 -} 3891 - 3892 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3893 -|activity|Статус экспорта, где true - экспорт в процессе выполнения, false - в данный момент ничего не экспортируется. 3894 -|progress|Прогресс экспорта, от 0 до 100% 3895 -|message|Текст описывающий статус 3896 - 3897 -= (% style="color:#000000; font-size:18.6667px" %)Раздел: **Экодрайвинг**(%%) = 3898 - 3899 -== (% style="color:#000000; font-size:16px" %)**Запрос рейтинга качества вождения**(%%) == 3900 - 3901 -(% class="box infomessage" %) 3902 -((( 3903 -**POST /api/v3/EcoDriving/rating** 3904 -))) 3905 - 3906 -Позволяет получить данные рейтинга нарушений выбранных объектов за указанный период времени. Данные, выдаваемые этим запросом аналогичны тем, что вы можете увидеть в окне **Качество вождения** в мониторинге. В массиве **items **передается список объектов из рейтинга качества вождения, в **trips **передается информация по отдельным рейсам объекта. 3907 - 3908 -Тело запроса: 3909 - 3910 -{ 3911 - "vehicleIds": [vehicleId], 3912 - "from": "2023-11-22T09:29:48.051Z", 3913 - "to": "2023-11-22T09:29:48.051Z" 3914 -} 3915 - 3916 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3917 -|vehicleIds|Массив ID объектов 3918 -|from|Дата начала запроса 3919 -|to|Дата окончания запроса 3920 - 3921 -Ответ: 3922 - 3923 -{ 3924 - "items": [ 3925 - { 3926 - "from": "2023-11-22T09:29:48.052Z", 3927 - "to": "2023-11-22T09:29:48.052Z", 3928 - "vehicleId": 0, 3929 - "vehicleName": "string", 3930 - "vehicleModel": "string", 3931 - "penalty": 0, 3932 - "score": 0, 3933 - "totalViolations": 0, 3934 - "violationsByType": { 3935 - "overspeedingViolations": 0, 3936 - "accelerationViolations": 0, 3937 - "brakingViolations": 0, 3938 - "turningViolations": 0, 3939 - "dangerousDrivingViolations": 0, 3940 - "sensorViolations": 0 3941 - }, 3942 - "moveTime": 0, 3943 - "mileage": 0, 3944 - "tripsCount": 0, 3945 - "trips": [ 3946 - { 3947 - "penalty": 0, 3948 - "score": 0, 3949 - "violationsCount": 0, 3950 - "violationsByType": { 3951 - "overspeedingViolations": 0, 3952 - "accelerationViolations": 0, 3953 - "brakingViolations": 0, 3954 - "turningViolations": 0, 3955 - "dangerousDrivingViolations": 0, 3956 - "sensorViolations": 0 3957 - }, 3958 - "moveTime": 0, 3959 - "mileage": 0, 3960 - "motohours": 0, 3961 - "maxSpeed": 0, 3962 - "startAddress": "string", 3963 - "endAddress": "string", 3964 - "drivers": [ 3965 - { 3966 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 3967 - "driverName": "string", 3968 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 3969 - } 3970 - ] 3971 - } 3972 - ] 3973 - } 3974 - ] 3975 -} 3976 - 3977 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 3978 -|from|Дата начала запроса 3979 -|to|Дата окончания 3980 -|vehicleId|ID объекта 3981 -|vehicleName|Имя объекта 3982 -|vehicleModel|Модель объекта 3983 -|penalty|Сумма штрафных баллов 3984 -|score|Оценка 3985 -|totalViolations|Суммарное количество нарушений 3986 -|violationsByType|Список типов нарушений и количество нарушений для каждого типа 3987 -|overspeedingViolations|Превышение скорости 3988 -|accelerationViolations|Ускорение 3989 -|brakingViolations|Торможение 3990 -|turningViolations|Резкий поворот 3991 -|dangerousDrivingViolations|Резкое вождение 3992 -|sensorViolations|Нарушение по датчику 3993 -|moveTime|Время в движении 3994 -|mileage|Пробег 3995 -|tripsCount|Количество рейсов 3996 -|motohours|Моточасы 3997 -|maxSpeed|Максимальная скорость 3998 -|startAddress|Адрес начала рейса 3999 -|endAddress|Адрес окончания рейса 4000 -|drivers|Список водителей, которые были на объекте в течениии рейса 4001 -|driverGuid|Guid водителя 4002 -|driverName|Имя водителя 4003 -|driverRfid|Номер Карты-метки 4004 - 4005 4005 (% class="box" lang="en-US" style="text-align: center;" %) 4006 4006 ((( 4007 4007 (% 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]] **
- image-20231020124453-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.krainovim - Size
-
... ... @@ -1,1 +1,0 @@ 1 -268.0 KB - Content