Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/03/12 10:28
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -10,7 +10,7 @@ 10 10 11 11 (% style="color:#000000" %)−(%%) Между запросами должна быть пауза в 1 секунду (превышение отвергается системой с уведомлением о превышении частоты запросов). 12 12 13 -(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять X-Auth (токен авторизации, получаемый методом auth/login). 13 +(% style="color:#000000" %)−(%%) Для работы со всеми методами API необходимо в заголовок добавлять __**X-Auth**__ (токен авторизации, получаемый методом __**auth/login**__). 14 14 15 15 Пример: X-Auth: 34f4919a-099b-4b7d-8aa1-f478ec2062de. 16 16 ... ... @@ -31,7 +31,7 @@ 31 31 32 32 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo>>url:https://hosting.glonasssoft.ru/api/v3/auth/login?username=demo&password=demo]] 33 33 34 -(% style="color:#000000" %)В случае успешного выполнения метода, поле «AuthId» содержит токен авторизации «X-Auth». 34 +(% style="color:#000000" %)В случае успешного выполнения метода, поле «__**AuthId**__» содержит токен авторизации «__**X-Auth**__». 35 35 36 36 (% lang="en-US" %) 37 37 (% style="color:#000000" %)**Ответ:** ... ... @@ -44,7 +44,7 @@ 44 44 "User": "" , ~/~/ имя пользователя 45 45 46 46 (% lang="en-US" %) 47 - 47 +} 48 48 49 49 **Примечание: **Время жизни токена авторизации задается в настройках пользователя, там есть параметр длительность сессии. При каждом запросе токен пролонгируется. 50 50 ... ... @@ -54,7 +54,7 @@ 54 54 (% style="color:#000000; line-height:100%" %)**Проверка авторизации **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/auth/check** 55 55 ))) 56 56 57 -(% style="color:#000000" %) Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 57 +(% style="color:#000000" %) Метод позволяет проверить статус авторизации. Метод позволяет проверить активен токен авторизации или нет (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 58 58 59 59 (% style="color:#000000" %)Метод запроса: **GET** 60 60 ... ... @@ -76,19 +76,19 @@ 76 76 (% style="color:#000000" %)**Получение основных параметров клиента — **(% lang="en-US" %)**GET **(%%)**/(% lang="en-US" %)api/v3/agents(%%)** 77 77 ))) 78 78 79 -(% style="color:#000000" %) Метод позволяет получить основные параметры клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**): 79 +(% style="color:#000000" %) Метод позволяет получить основные параметры клиентов: наименование, полное наименование, тип, статус и идентификатор клиента-родителя. Метод возвращает информацию о клиентах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 80 80 81 81 (% style="color:#000000" %)− информация о клиентах предоставляется при наличии права «Просмотр клиентов»; 82 82 83 83 (% style="color:#000000" %)− возвращается информация о клиенте, которому принадлежит авторизованный пользователь, и его дочерних клиентах; 84 84 85 -(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «Доступ к партнёрским клиентам». 85 +(% style="color:#000000" %)− информация о клиенте типа «Партнер» и его подклиентов возвращается при наличии права «__**Доступ к партнёрским клиентам**__». 86 86 87 87 (% style="color:#000000" %)Метод запроса: **GET** 88 88 89 89 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/agents?parentId=>>url:https://hosting.glonasssoft.ru/api/v3/agents?parentId=]](% style="color:#000000" %)<parentId> 90 90 91 -(% style="color:#000000" %)Параметр запроса: <parentId> - идентификатор клиента-родителя (опционально) 91 +(% style="color:#000000" %)Параметр запроса: <__**parentId**__> - идентификатор клиента-родителя (опционально) 92 92 93 93 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 94 94 ... ... @@ -99,14 +99,11 @@ 99 99 "parentId": "", ~/~/ идентификатор клиента-родителя 100 100 "name": "", ~/~/ наименование клиента 101 101 "fullName": "", ~/~/ полное наименование клиента 102 - "agentInfoType": "", ~/~/ тип клиента1 102 + "agentInfoType": "", ~/~/ тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 103 103 "status": "", ~/~/ статус клиента 104 - 104 +} 105 105 106 106 107 -(% style="color:#000000" %)**Примечание:** возможные значение параметра agentInfoType: (% lang="en-US" %)[(% style="color:#000000; font-family:Liberation Serif,serif; font-size:12pt; font-style:normal; font-variant:normal; font-weight:normal" %)0 – Клиент, 1 – Партнер, 2 – Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - договор(% style="color:#000000" %)] 108 - 109 - 110 110 (% class="box" style="text-align: center;" %) 111 111 ((( 112 112 (% style="color:#000000; font-size:14pt" %)**Раздел Пользователи** ... ... @@ -117,7 +117,7 @@ 117 117 (% style="color:#000000; line-height:100%" %)**Добавление пользователя — **(% lang="en-US" %)**POST /api/v3/users** 118 118 ))) 119 119 120 -(% style="color:#000000" %) Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 117 +(% style="color:#000000" %) Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 121 121 122 122 (% style="color:#000000" %)Метод запроса: **POST** 123 123 ... ... @@ -145,7 +145,7 @@ 145 145 "kind": "", ~/~/ тип аутентификации (None - выключена, Email - по email) 146 146 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 147 147 "groups": "" , ~/~/ группы пользователя, названия групп 148 - 145 +} 149 149 150 150 (% style="text-align:left" %) 151 151 (% style="color:#000000; font-weight:normal" %)Ответ: ... ... @@ -173,7 +173,7 @@ 173 173 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 174 174 175 175 (% style="text-align:left" %) 176 -(% style="color:#000000; font-weight:normal" %) 173 +(% style="color:#000000; font-weight:normal" %)} 177 177 178 178 179 179 (% class="box successmessage" %) ... ... @@ -183,14 +183,16 @@ 183 183 184 184 (% style="color:#000000" %) Метод позволяет получить основные параметры пользователей: логин, имя, адрес электронной почты, номер телефона, статус, идентификатор клиента-родителя и прочее. 185 185 186 -(% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«Просмотр пользователей»**. 183 +(% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«__Просмотр пользователей__»**. 187 187 188 188 (% style="color:#000000" %)Метод запроса: **POST** 189 189 190 190 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]] 191 191 192 -(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON):189 +(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. 193 193 191 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 192 + 194 194 (% style="color:#000000" %){ 195 195 196 196 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента ... ... @@ -198,7 +198,7 @@ 198 198 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 199 199 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 200 200 201 -(% style="color:#000000" %) 200 +(% style="color:#000000" %)} 202 202 203 203 (% style="color:#000000" %)Ответ: 204 204 ... ... @@ -218,7 +218,7 @@ 218 218 "status": "1", ~/~/ статус пользователя 219 219 "astLogged": "", ~/~/ дата/время последней авторизации 220 220 221 -(% style="color:#000000" %) 220 +(% style="color:#000000" %)} 222 222 223 223 224 224 (% class="box warningmessage" %) ... ... @@ -226,7 +226,7 @@ 226 226 (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users** 227 227 ))) 228 228 229 -(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 228 +(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 230 230 231 231 (% style="color:#000000" %)Метод запроса: **PUT** 232 232 ... ... @@ -261,16 +261,16 @@ 261 261 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 262 262 263 263 (% lang="en-US" style="text-align:left" %) 264 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) // //__}__263 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 265 265 266 266 (% lang="en-US" style="text-align:left" %) 267 267 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 268 268 269 269 (% lang="en-US" style="text-align:left" %) 270 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) //{//269 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 271 271 272 272 (% lang="en-US" style="text-align:left" %) 273 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) //"id": "" , ~/~/ идентификатор пользователя272 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя 274 274 "lastName": "" , ~/~/ фамилия 275 275 "firstName": "" , ~/~/ имя 276 276 "position": "" , ~/~/ должность ... ... @@ -286,10 +286,10 @@ 286 286 "doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации 287 287 "kind": "" , ~/~/ тип аутентификации 288 288 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 289 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя //288 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 290 290 291 291 (% lang="en-US" style="text-align:left" %) 292 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) // //}291 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 293 293 294 294 295 295 (% class="box warningmessage" %) ... ... @@ -297,13 +297,13 @@ 297 297 (% style="color:#000000" %)**Изменение статуса пользователя**// //**— **(% lang="en-US" %)**PUT /api/v3/users/status/{id}** 298 298 ))) 299 299 300 -(% style="color:#000000" %) Метод позволяет изменить статус пользователя. Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 299 +(% style="color:#000000" %) Метод позволяет изменить статус пользователя. Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 301 301 302 302 (% style="color:#000000" %)Метод запроса: **PUT** 303 303 304 304 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/status/>>url:https://hosting.glonasssoft.ru/api/v3/users/status/]](% style="color:#000000" %){id} 305 305 306 -(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя 305 +(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid пользователя 307 307 308 308 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 309 309 ... ... @@ -315,7 +315,7 @@ 315 315 "description": "" , ~/~/ описание 316 316 "data": "" , ~/~/ данные, связанные со сменой статуса 317 317 318 - 317 +(% style="color:#000000" %)} 319 319 320 320 (% style="text-align:left" %) 321 321 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** ... ... @@ -326,13 +326,13 @@ 326 326 (% style="color:#000000; line-height:100%" %)**Удаление пользователя — **(% lang="en-US" %)**DELETE /api/v3/users/{id}** 327 327 ))) 328 328 329 -(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 328 +(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 330 330 331 331 (% style="color:#000000" %)Метод запроса: **DELETE** 332 332 333 333 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/>>url:https://hosting.glonasssoft.ru/api/v3/users/]](% style="color:#000000" %){id} 334 334 335 -(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя 334 +(% style="color:#000000" %)Параметр запроса: {**__id__**} - Guid пользователя 336 336 337 337 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 338 338 ... ... @@ -352,17 +352,17 @@ 352 352 353 353 (% style="color:#000000" %) Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение». 354 354 355 -(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**): 354 +(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 356 356 357 357 (% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов; 358 358 359 -(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«Просмотр заданий на техобслуживание»**. 358 +(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«__Просмотр заданий на техобслуживание__»**. 360 360 361 361 (% style="color:#000000" %)Метод запроса: **GET** 362 362 363 363 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %)<(% lang="en-US" %)v(%%)ehicleID> 364 364 365 -(% style="color:#000000" %)Параметр запроса: <vehicleid> - идентификатор объекта (опционально) 364 +(% style="color:#000000" %)Параметр запроса: <__**vehicleid**__> - идентификатор объекта (опционально) 366 366 367 367 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 368 368 ... ... @@ -383,7 +383,7 @@ 383 383 "unitName": "" , ~/~/ наименование подразделения 384 384 "status": "" , ~/~/ статус объекта 385 385 386 - 385 +} 387 387 388 388 (% style="text-align:left" %) 389 389 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: ... ... @@ -397,7 +397,7 @@ 397 397 (% style="color:#000000; line-height:100%" %)**Добавление объекта — **(% lang="en-US" %)**POST /api/v3/vehicles** 398 398 ))) 399 399 400 -(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**, //Content-Type//: **application/json**; //charset//=**utf-8**). 399 +(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**, //Content-Type//: __**application/json**__; //charset//=__**utf-8**__). 401 401 402 402 (% style="color:#000000" %)Метод запроса: **POST** 403 403 ... ... @@ -425,7 +425,7 @@ 425 425 "mileageEnabled": true, ~/~/ флаг активности счётчика "пробег" 426 426 "motohours": "" , ~/~/ моточасы 427 427 "motohoursEnabled": true ~/~/ флаг активности счётчика "моточасы" 428 - }, 427 + }, 429 429 "cmsv6Parameters": { ~/~/ параметры CMSv6 430 430 "enabled": true, ~/~/ флаг включения 431 431 "id": "" , ~/~/ идентификатор ... ... @@ -432,7 +432,7 @@ 432 432 "host": "" , ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 433 433 "login": "" , ~/~/ имя учетной записи 434 434 "password": "" ~/~/ пароль учетной записи 435 - }, 434 + }, 436 436 "inspectionTasks": ~/~/ задания на ТО 437 437 { 438 438 "enabled": "" , ~/~/ Признак включения ... ... @@ -470,7 +470,7 @@ 470 470 "motohoursEnabled": true, 471 471 "mileage": "", 472 472 "motohours": 345.0 473 - }, 472 + }, 474 474 "cmsv6Parameters": { ~/~/Параметры CmsV6 475 475 "id": null, 476 476 "enabled": true, ~/~/флаг включения ... ... @@ -477,7 +477,7 @@ 477 477 "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 478 478 "login": "", ~/~/ имя учетной записи 479 479 "password": "" ~/~/ пароль учетной записи 480 - }, 479 + }, 481 481 "inspectionTasks": { ~/~/ задания на ТО 482 482 "id": "", ~/~/ ID задачи 483 483 "enabled": false, ~/~/ Признак включения ... ... @@ -490,7 +490,7 @@ 490 490 "periodicCondition": "", ~/~/ Условие периодичности по времени 491 491 "kind": "", ~/~/ Вид периодичности по времени 492 492 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 493 - 492 + } 494 494 495 495 (% style="text-align:left" %) 496 496 (% style="color:#000000" %)} ... ... @@ -503,7 +503,7 @@ 503 503 504 504 (% style="color:#000000" %) Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 505 505 506 -(% style="color:#000000" %) Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**): 505 +(% style="color:#000000" %) Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**): 507 507 508 508 (% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов; 509 509 ... ... @@ -521,12 +521,14 @@ 521 521 522 522 (% style="color:#000000" %)В заголовках запроса: 523 523 524 -(% style="color:#000000" %)− Content-Type: application/json 523 +(% style="color:#000000" %)− Content-Type: __**application/json**__ 525 525 526 526 (% style="color:#000000" %)− X-Auth: Токен авторизации 527 527 528 -(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON):527 +(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. 529 529 529 +(% style="color:#000000" %)Параметры в теле запроса (JSON): 530 + 530 530 (% class="western" style="color:#000000" %)##{## 531 531 532 532 (% class="western" style="color:#000000" %)## "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) ... ... @@ -538,7 +538,7 @@ 538 538 "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)##(%%) 539 539 (% style="color:#000000" %)} 540 540 541 -(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. 542 +(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. 542 542 543 543 (% style="color:#000000" %)Ответ: 544 544 ... ... @@ -561,8 +561,10 @@ 561 561 "createdAt": "" ~/~/ дата создания объектов (%%) 562 562 (% style="color:#000000" %)} 563 563 564 -(% style="color:#000000" %) Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:565 +(% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 565 565 567 +(% style="color:#000000" %)Параметр «__**status**__» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 568 + 566 566 0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 567 567 568 568 ... ... @@ -571,13 +571,13 @@ 571 571 (% style="color:#000000; line-height:100%" %)**Изменение статуса объекта — **(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}** 572 572 ))) 573 573 574 -(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 577 +(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 575 575 576 576 (% style="color:#000000" %)Метод запроса: **POST** 577 577 578 578 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/changeStatus/]](% style="color:#000000" %){vehicleId} 579 579 580 -(% style="color:#000000" %)Параметр запроса: {vehicleId} - ID ТС 583 +(% style="color:#000000" %)Параметр запроса: {__**vehicleId**__} - ID ТС 581 581 582 582 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 583 583 ... ... @@ -594,7 +594,7 @@ 594 594 "overwrite": false, ~/~/ Флаг перезаписи 595 595 "stage": "", ~/~/ Состояние, может быть null 596 596 597 - 600 +(% style="color:#000000" %)} 598 598 599 599 (% style="color:#000000" %)Ответ: 600 600 ... ... @@ -608,7 +608,7 @@ 608 608 "stage": "", ~/~/ Состояние 609 609 610 610 (% style="text-align:left" %) 611 -(% style="color:#000000" %)} 614 +(% style="color:#000000" %) } 612 612 613 613 614 614 (% class="box warningmessage" %) ... ... @@ -616,7 +616,7 @@ 616 616 (% style="color:#000000; line-height:100%" %)**Редактирование объекта — **(% lang="en-US" %)**PUT /api/v3/vehicles** 617 617 ))) 618 618 619 -(% style="color:#000000" %) Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 622 +(% style="color:#000000" %) Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 620 620 621 621 (% style="color:#000000" %)Метод запроса: **PUT** 622 622 ... ... @@ -626,7 +626,7 @@ 626 626 627 627 (% style="color:#000000" %)Параметры в теле запроса (JSON): 628 628 629 -(% style="color:#000000" %) 632 +(% style="color:#000000" %){ 630 630 631 631 (% style="color:#000000" %) "vehicleId": "", ~/~/ ID ТС 632 632 "parentId": "", ~/~/ ID клиента ... ... @@ -667,7 +667,7 @@ 667 667 "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает) 668 668 "kind": "", ~/~/ Вид периодичности по времени 669 669 "maxQuantity": "", ~/~/ Сколько раз выполнить задание 670 - }673 + } 671 671 672 672 (% style="color:#000000" %)} 673 673 ... ... @@ -674,21 +674,66 @@ 674 674 (% style="color:#000000" %)Ответ: 675 675 676 676 (% lang="en-US" style="text-align:left" %) 677 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ «vehicleId»:«», //ID ТС «parentId»:«», //ID клиента «name»:«», //имя ТС «imei»:«»,//IMEI «deviceTypeId»: «», //ID типа устройства «modelId»: «», «unitId»: «», //ID подразделения «sim1»: «», //SIM 1 «sim2»: «», //SIM2 «consumptionPer100Km»: «», //Расход топлива на 100 км «consumptionIdle»: «», //Расход топлива на холостом ходу «counters»: { «mileageEnabled»: true, //флаг активности счётчика «пробег» «motohoursEnabled»: true, //флаг активности счётчика «моточасы» «mileage»: «», //пробег «motohours»: «» //моточасы }, «cmsv6Parameters»: { //параметры CMSv6 «id»: «», //идентификатор «enabled»: true, //флаг включения «host»: «», //IP-адрес или доменное имя из URL веб-сайта CMSV6 «login»: «», //имя учетной записи «password»: «» //пароль учетной записи }, «inspectionTasks»: [ //задания на ТО { «id»: «», //ID задания «enabled»: false, //Признак включения «name»: «», //Имя задания «description»: «», //Описание задания «mileageCondition»: «», //Условие по пробегу «lastMileage»: «», //Пробег (в метрах) на момент последнего ТО «motohoursCondition»: «», //Условие по моточасам «lastMotohours»: «», //Моточасы «periodicCondition»: «», //Условие периодичности по времени «kind»: «», //Вид периодичности по времени «maxQuantity»: «» //Сколько раз выполнить задание } ] }680 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 678 678 682 +(% lang="en-US" style="text-align:left" %) 683 + "vehicleId": "", ~/~/ ID ТС 684 + "parentId": "", ~/~/ ID клиента 685 + "name": "", ~/~/ имя ТС 686 + "imei": "", ~/~/ IMEI 687 + "deviceTypeId": "", ~/~/ типа устройства 688 + "modelId": "", ~/~/ ID модели 689 + "unitId": "", ~/~/ ID подразделения 690 + "sim1": "", ~/~/ SIM 1 691 + "sim2": "", ~/~/ SIM2 692 + "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 693 + "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 694 + "counters": 695 + { 696 + "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 697 + "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» 698 + "mileage": "", ~/~/ пробег 699 + "motohours": "", ~/~/ моточасы 700 + } 701 + "cmsv6Parameters": ~/~/ параметры CMSv6 702 + { 703 + "id": ~/~/ идентификатор 704 + "enabled": true, ~/~/ флаг включения 705 + "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 706 + "login": "", ~/~/ имя учетной записи 707 + "password": "", ~/~/ пароль учетной записи 708 + } 709 + "inspectionTasks": ~/~/ задания на ТО 710 + { 711 + "id": "", ~/~/ ID задания 712 + "enabled": false, ~/~/ Признак включения 713 + "name": "", ~/~/ Имя задания 714 + "description": "", ~/~/ Описание задания 715 + "mileageCondition": "", ~/~/ Условие по пробегу 716 + "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО 717 + "motohoursCondition": "", ~/~/ Условие по моточасам 718 + "lastMotohours": "", ~/~/ Моточасы 719 + "periodicCondition": "", ~/~/ Условие периодичности по времени 720 + "kind": "", ~/~/ Вид периодичности по времени 721 + "maxQuantity": "", ~/~/ Сколько раз выполнить задание 722 + } 679 679 724 +(% lang="en-US" style="text-align:left" %) 725 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 726 + 727 + 680 680 (% class="box errormessage" %) 681 681 ((( 682 682 (% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}** 683 683 ))) 684 684 685 -(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 733 +(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 686 686 687 687 (% style="color:#000000" %)Метод запроса: **DELETE** 688 688 689 689 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %){vehicleId} 690 690 691 -(% style="color:#000000" %)Параметр запроса: {id} - Guid объекта 739 +(% style="color:#000000" %)Параметр запроса: {__**id**__} - Guid объекта 692 692 693 693 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 694 694 ... ... @@ -706,7 +706,7 @@ 706 706 (% style="color:#000000; line-height:100%" %)**Получение списка типов устройств **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/devices/types** 707 707 ))) 708 708 709 -(% style="color:#000000" %) Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 757 +(% style="color:#000000" %) Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 710 710 711 711 (% style="color:#000000" %)Метод запроса: **GET** 712 712 ... ... @@ -714,16 +714,15 @@ 714 714 715 715 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 716 716 717 -(% style="color:#000000" %)Ответ: [765 +(% style="color:#000000" %)Ответ: 718 718 719 -(% class="western" %) 720 -{{{ { 721 - "deviceTypeId" : "", // ID типа устройства 722 - "deviceTypeName" : "" // Название типа устройства 723 - },}}} 767 +(% style="color:#000000" %){ 724 724 769 + "deviceTypeId" : "", ~/~/ ID типа устройства 770 + "deviceTypeName" : "" ~/~/ Название типа устройства 771 + 725 725 (% style="text-align:left" %) 726 -(% style="color:#000000" %) …** **]773 +(% style="color:#000000" %)} 727 727 728 728 729 729 (% class="box" style="text-align: center;" %) ... ... @@ -736,7 +736,7 @@ 736 736 (% style="color:#000000; line-height:100%" %)**Получение списка типов датчиков **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/sensors/types** 737 737 ))) 738 738 739 -(% style="color:#000000" %) Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 786 +(% style="color:#000000" %) Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 740 740 741 741 (% style="color:#000000" %)Метод запроса: **GET** 742 742 ... ... @@ -744,19 +744,16 @@ 744 744 745 745 (% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации 746 746 747 -(% style="color:#000000" %)Ответ: [794 +(% style="color:#000000" %)Ответ: 748 748 749 -(% class="western" style="margin-bottom:19px" %) 750 -{{{ {}}} 796 +(% style="color:#000000" %){ 751 751 752 -(% style="color:#000000" %)«id»: «», //ID типа датчика «name»: «», //Название 798 + "id": "", ~/~/ ID типа датчика 799 + "name": "", ~/~/ Название 800 + "description": "", ~/~/ Описание 753 753 754 -(% class="western" %) 755 -{{{ "description": "" // Описание 756 - },}}} 757 - 758 758 (% style="text-align:left" %) 759 -(% style="color:#000000" %) … ]803 +(% style="color:#000000" %)} 760 760 761 761 762 762 (% class="box" lang="en-US" style="text-align: center;" %)