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,11 +99,14 @@ 99 99 "parentId": "", ~/~/ идентификатор клиента-родителя 100 100 "name": "", ~/~/ наименование клиента 101 101 "fullName": "", ~/~/ полное наименование клиента 102 - "agentInfoType": "", ~/~/ тип клиента (0- Клиент,1-Партнер,2-Группа,3-Административнаягруппа, 4 - Тестовый клиент, 5 - Договор)102 + "agentInfoType": "", ~/~/ тип клиента1 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 + 107 107 (% class="box" style="text-align: center;" %) 108 108 ((( 109 109 (% style="color:#000000; font-size:14pt" %)**Раздел Пользователи** ... ... @@ -114,7 +114,7 @@ 114 114 (% style="color:#000000; line-height:100%" %)**Добавление пользователя — **(% lang="en-US" %)**POST /api/v3/users** 115 115 ))) 116 116 117 -(% style="color:#000000" %) Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).120 +(% style="color:#000000" %) Метод позволяет добавить пользователя. Метод позволяет добавить пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 118 118 119 119 (% style="color:#000000" %)Метод запроса: **POST** 120 120 ... ... @@ -142,7 +142,7 @@ 142 142 "kind": "", ~/~/ тип аутентификации (None - выключена, Email - по email) 143 143 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 144 144 "groups": "" , ~/~/ группы пользователя, названия групп 145 -} 148 + } 146 146 147 147 (% style="text-align:left" %) 148 148 (% style="color:#000000; font-weight:normal" %)Ответ: ... ... @@ -170,7 +170,7 @@ 170 170 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 171 171 172 172 (% style="text-align:left" %) 173 -(% style="color:#000000; font-weight:normal" %)} 176 +(% style="color:#000000; font-weight:normal" %) } 174 174 175 175 176 176 (% class="box successmessage" %) ... ... @@ -180,16 +180,14 @@ 180 180 181 181 (% style="color:#000000" %) Метод позволяет получить основные параметры пользователей: логин, имя, адрес электронной почты, номер телефона, статус, идентификатор клиента-родителя и прочее. 182 182 183 -(% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **« __Просмотр пользователей__»**.186 +(% style="color:#000000" %)Метод возвращает информацию о пользователях клиента-родителя авторизованного пользователя и пользователях его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«Просмотр пользователей»**. 184 184 185 185 (% style="color:#000000" %)Метод запроса: **POST** 186 186 187 187 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/find>>url:https://hosting.glonasssoft.ru/api/v3/users/find]] 188 188 189 -(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. 192 +(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON): 190 190 191 -(% style="color:#000000" %)Параметры в теле запроса (JSON): 192 - 193 193 (% style="color:#000000" %){ 194 194 195 195 "parentId": "375a1f06-c384-43f8-8562-1c3d79a32303", ~/~/ GUID агента, для которого надо получить данные, null - для текущего агента ... ... @@ -197,7 +197,7 @@ 197 197 "login": "qqqqqq", ~/~/ Логин пользователя, по которому фильтруется, null - неважно 198 198 "email": "eee", ~/~/ Email пользователя, по которому фильтруется, null - неважно 199 199 200 -(% style="color:#000000" %)} 201 +(% style="color:#000000" %) } 201 201 202 202 (% style="color:#000000" %)Ответ: 203 203 ... ... @@ -217,7 +217,7 @@ 217 217 "status": "1", ~/~/ статус пользователя 218 218 "astLogged": "", ~/~/ дата/время последней авторизации 219 219 220 -(% style="color:#000000" %)} 221 +(% style="color:#000000" %) } 221 221 222 222 223 223 (% class="box warningmessage" %) ... ... @@ -225,7 +225,7 @@ 225 225 (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users** 226 226 ))) 227 227 228 -(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).229 +(% style="color:#000000" %) Метод позволяет отредактировать пользователя. Метод позволяет отредактировать пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 229 229 230 230 (% style="color:#000000" %)Метод запроса: **PUT** 231 231 ... ... @@ -260,16 +260,16 @@ 260 260 "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 261 261 262 262 (% lang="en-US" style="text-align:left" %) 263 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %)__}__ 264 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)// //__}__ 264 264 265 265 (% lang="en-US" style="text-align:left" %) 266 266 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)//Ответ~:// 267 267 268 268 (% lang="en-US" style="text-align:left" %) 269 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 270 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)//{ // 270 270 271 271 (% lang="en-US" style="text-align:left" %) 272 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "id": "" , ~/~/ идентификатор пользователя 273 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)// "id": "" , ~/~/ идентификатор пользователя 273 273 "lastName": "" , ~/~/ фамилия 274 274 "firstName": "" , ~/~/ имя 275 275 "position": "" , ~/~/ должность ... ... @@ -285,10 +285,10 @@ 285 285 "doubleAuth": "" , ~/~/ параметры двухфакторной аутентификации 286 286 "kind": "" , ~/~/ тип аутентификации 287 287 "target": "" , ~/~/ в случае аутентификации по email - email-адрес 288 - "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя 289 + "groups": "" , ~/~/ группы пользователя, «user» названия группы пользователя// 289 289 290 290 (% lang="en-US" style="text-align:left" %) 291 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 292 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %)// //} 292 292 293 293 294 294 (% class="box warningmessage" %) ... ... @@ -296,13 +296,13 @@ 296 296 (% style="color:#000000" %)**Изменение статуса пользователя**// //**— **(% lang="en-US" %)**PUT /api/v3/users/status/{id}** 297 297 ))) 298 298 299 -(% style="color:#000000" %) Метод позволяет изменить статус пользователя. Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).300 +(% style="color:#000000" %) Метод позволяет изменить статус пользователя. Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 300 300 301 301 (% style="color:#000000" %)Метод запроса: **PUT** 302 302 303 303 (% 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} 304 304 305 -(% style="color:#000000" %)Параметр запроса: { __**id**__} - Guid пользователя306 +(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя 306 306 307 307 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 308 308 ... ... @@ -314,7 +314,7 @@ 314 314 "description": "" , ~/~/ описание 315 315 "data": "" , ~/~/ данные, связанные со сменой статуса 316 316 317 -(% style="color:#000000" %)} 318 + (% style="color:#000000" %)} 318 318 319 319 (% style="text-align:left" %) 320 320 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** ... ... @@ -325,13 +325,13 @@ 325 325 (% style="color:#000000; line-height:100%" %)**Удаление пользователя — **(% lang="en-US" %)**DELETE /api/v3/users/{id}** 326 326 ))) 327 327 328 -(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).329 +(% style="color:#000000" %) Метод позволяет удалить пользователя. Метод позволяет удалить пользователя, указанного в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 329 329 330 330 (% style="color:#000000" %)Метод запроса: **DELETE** 331 331 332 332 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/>>url:https://hosting.glonasssoft.ru/api/v3/users/]](% style="color:#000000" %){id} 333 333 334 -(% style="color:#000000" %)Параметр запроса: { **__id__**} - Guid пользователя335 +(% style="color:#000000" %)Параметр запроса: {id} - Guid пользователя 335 335 336 336 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 337 337 ... ... @@ -351,17 +351,17 @@ 351 351 352 352 (% style="color:#000000" %) Метод позволяет получить всю информацию из карточки объекта: ID, имя объекта, imei, тип устройства, SIM1, SIM2, ID клиента, название клиента, ID модели, наименование модели объекта, ID подразделения, водители, ТО, текущий пробег, моточасы, нормы расхода, полную историю статусов со всеми комментариями, список датчиков (тип, наименование, тип входа, номер входа, псевдоним, тип датчика, тип тарировки, тарировка, состояние чекбоксов «отображается в подсказке» и «отображать последнее валидное значение». 353 353 354 -(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**):355 +(% style="color:#000000" %) Метод возвращает информацию об объекте с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**): 355 355 356 356 (% style="color:#000000" %)− возвращается информация об объекте клиента-родителя авторизованного пользователя и объекте его дочерних клиентов; 357 357 358 -(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **« __Просмотр заданий на техобслуживание__»**.359 +(% style="color:#000000" %)− информация о ТО предоставляется с учётом прав на **«Просмотр заданий на техобслуживание»**. 359 359 360 360 (% style="color:#000000" %)Метод запроса: **GET** 361 361 362 362 (% 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> 363 363 364 -(% style="color:#000000" %)Параметр запроса: < __**vehicleid**__> - идентификатор объекта (опционально)365 +(% style="color:#000000" %)Параметр запроса: <vehicleid> - идентификатор объекта (опционально) 365 365 366 366 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 367 367 ... ... @@ -382,7 +382,7 @@ 382 382 "unitName": "" , ~/~/ наименование подразделения 383 383 "status": "" , ~/~/ статус объекта 384 384 385 -} 386 + } 386 386 387 387 (% style="text-align:left" %) 388 388 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: ... ... @@ -396,7 +396,7 @@ 396 396 (% style="color:#000000; line-height:100%" %)**Добавление объекта — **(% lang="en-US" %)**POST /api/v3/vehicles** 397 397 ))) 398 398 399 -(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**, //Content-Type//:__**application/json**__; //charset//=__**utf-8**__).400 +(% style="color:#000000" %) Метод позволяет добавить объект. Метод позволяет добавить объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**, //Content-Type//: **application/json**; //charset//=**utf-8**). 400 400 401 401 (% style="color:#000000" %)Метод запроса: **POST** 402 402 ... ... @@ -424,7 +424,7 @@ 424 424 "mileageEnabled": true, ~/~/ флаг активности счётчика "пробег" 425 425 "motohours": "" , ~/~/ моточасы 426 426 "motohoursEnabled": true ~/~/ флаг активности счётчика "моточасы" 427 - 428 + }, 428 428 "cmsv6Parameters": { ~/~/ параметры CMSv6 429 429 "enabled": true, ~/~/ флаг включения 430 430 "id": "" , ~/~/ идентификатор ... ... @@ -431,7 +431,7 @@ 431 431 "host": "" , ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 432 432 "login": "" , ~/~/ имя учетной записи 433 433 "password": "" ~/~/ пароль учетной записи 434 - 435 + }, 435 435 "inspectionTasks": ~/~/ задания на ТО 436 436 { 437 437 "enabled": "" , ~/~/ Признак включения ... ... @@ -469,7 +469,7 @@ 469 469 "motohoursEnabled": true, 470 470 "mileage": "", 471 471 "motohours": 345.0 472 - 473 + }, 473 473 "cmsv6Parameters": { ~/~/Параметры CmsV6 474 474 "id": null, 475 475 "enabled": true, ~/~/флаг включения ... ... @@ -476,7 +476,7 @@ 476 476 "host": "", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6 477 477 "login": "", ~/~/ имя учетной записи 478 478 "password": "" ~/~/ пароль учетной записи 479 - 480 + }, 480 480 "inspectionTasks": { ~/~/ задания на ТО 481 481 "id": "", ~/~/ ID задачи 482 482 "enabled": false, ~/~/ Признак включения ... ... @@ -489,7 +489,7 @@ 489 489 "periodicCondition": "", ~/~/ Условие периодичности по времени 490 490 "kind": "", ~/~/ Вид периодичности по времени 491 491 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 492 - } 493 + } 493 493 494 494 (% style="text-align:left" %) 495 495 (% style="color:#000000" %)} ... ... @@ -502,7 +502,7 @@ 502 502 503 503 (% style="color:#000000" %) Метод позволяет получить основные параметры объектов: наименование, IMEI, тип устройства, модель объекта, подразделение, номера телефонов и идентификатор клиента, к которому прикреплен объект (клиент-родитель). 504 504 505 -(% style="color:#000000" %) Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**):506 +(% style="color:#000000" %) Метод возвращает информацию об объектах с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**): 506 506 507 507 (% style="color:#000000" %)− возвращается информация об объектах клиента-родителя авторизованного пользователя и объектах его дочерних клиентов; 508 508 ... ... @@ -520,14 +520,12 @@ 520 520 521 521 (% style="color:#000000" %)В заголовках запроса: 522 522 523 -(% style="color:#000000" %)− Content-Type: __**application/json**__524 +(% style="color:#000000" %)− Content-Type: application/json 524 524 525 525 (% style="color:#000000" %)− X-Auth: Токен авторизации 526 526 527 -(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. 528 +(% style="color:#000000" %)Условия фильтрации объектов задаются в теле запроса. Параметры в теле запроса (JSON): 528 528 529 -(% style="color:#000000" %)Параметры в теле запроса (JSON): 530 - 531 531 (% class="western" style="color:#000000" %)##{## 532 532 533 533 (% class="western" style="color:#000000" %)## "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) ... ... @@ -539,7 +539,7 @@ 539 539 "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)##(%%) 540 540 (% style="color:#000000" %)} 541 541 542 -(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров « __**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.541 +(% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «vehicleId», «deviceTypeId», «parentId», «unitId», и по частичному - «name», «imei», «sim». Фильтрация по значению параметра «sim» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. 543 543 544 544 (% style="color:#000000" %)Ответ: 545 545 ... ... @@ -558,27 +558,27 @@ 558 558 "modelName": "" ~/~/ наименование модели объекта 559 559 "unitId": "" ~/~/ идентификатор подразделения 560 560 "unitName": "" ~/~/ наименование подразделения 561 - "status": "" ~/~/ статус объекта (%%)(-1 - Новый, 0 - Блокировка, 1 - Активен, 2 - Отменен, 3 - Оборудован, 4 - Диагностика, 562 - ~/~/ 5 - Сервис, 6 - Демонтаж, 7 - Монтаж, 8 - Дозаказ, 9 - Обслужен, 10 - Списан, 563 - ~/~/ 11 - Неисправен, 12 - Проверен, 13 - Не эксплуатируется) 564 -(% style="color:#000000" %) "createdAt": "" ~/~/ дата создания объектов (%%) 560 + "status": "" ~/~/ статус объекта 561 + "createdAt": "" ~/~/ дата создания объектов (%%) 565 565 (% style="color:#000000" %)} 566 566 567 -(% style="color:#000000" %) Параметры « __**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**.564 +(% style="color:#000000" %) Параметры «sim1» и «sim2» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «status» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: 568 568 566 +0 - «Блокировка» 1 - «Активен», 2 - «Отменен», 3 - «Оборудован», 4 - «Диагностика», 5 - «Сервис», 6 - «Демонтаж», 7 - «Монтаж», 8 - «Дозаказ», 9 - «Обслужен», 10 - «Списан», 11 - «Неисправен», 12 - «Проверен», 13 - «Не эксплуатируется». 569 569 568 + 570 570 (% class="box successmessage" %) 571 571 ((( 572 572 (% style="color:#000000; line-height:100%" %)**Изменение статуса объекта — **(% lang="en-US" %)**POST /api/v3/vehicles/changeStatus/{vehicleId}** 573 573 ))) 574 574 575 -(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).574 +(% style="color:#000000" %) Метод позволяет изменить статус объекта. Метод позволяет изменить статус объекта, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 576 576 577 577 (% style="color:#000000" %)Метод запроса: **POST** 578 578 579 579 (% 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} 580 580 581 -(% style="color:#000000" %)Параметр запроса: { __**vehicleId**__} - ID ТС580 +(% style="color:#000000" %)Параметр запроса: {vehicleId} - ID ТС 582 582 583 583 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 584 584 ... ... @@ -595,7 +595,7 @@ 595 595 "overwrite": false, ~/~/ Флаг перезаписи 596 596 "stage": "", ~/~/ Состояние, может быть null 597 597 598 -(% style="color:#000000" %)} 597 + (% style="color:#000000" %)} 599 599 600 600 (% style="color:#000000" %)Ответ: 601 601 ... ... @@ -609,7 +609,7 @@ 609 609 "stage": "", ~/~/ Состояние 610 610 611 611 (% style="text-align:left" %) 612 -(% style="color:#000000" %) 611 +(% style="color:#000000" %)} 613 613 614 614 615 615 (% class="box warningmessage" %) ... ... @@ -617,7 +617,7 @@ 617 617 (% style="color:#000000; line-height:100%" %)**Редактирование объекта — **(% lang="en-US" %)**PUT /api/v3/vehicles** 618 618 ))) 619 619 620 -(% style="color:#000000" %) Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).619 +(% style="color:#000000" %) Метод позволяет отредактировать объект. Метод позволяет отредактировать объект, указанный в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 621 621 622 622 (% style="color:#000000" %)Метод запроса: **PUT** 623 623 ... ... @@ -627,7 +627,7 @@ 627 627 628 628 (% style="color:#000000" %)Параметры в теле запроса (JSON): 629 629 630 -(% style="color:#000000" %){ 629 +(% style="color:#000000" %) { 631 631 632 632 (% style="color:#000000" %) "vehicleId": "", ~/~/ ID ТС 633 633 "parentId": "", ~/~/ ID клиента ... ... @@ -668,7 +668,7 @@ 668 668 "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает) 669 669 "kind": "", ~/~/ Вид периодичности по времени 670 670 "maxQuantity": "", ~/~/ Сколько раз выполнить задание 671 - 670 + } 672 672 673 673 (% style="color:#000000" %)} 674 674 ... ... @@ -675,7 +675,7 @@ 675 675 (% style="color:#000000" %)Ответ: 676 676 677 677 (% lang="en-US" style="text-align:left" %) 678 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 677 +(% lang="ru-RU" style="color:#000000; font-weight:normal" %){ 679 679 680 680 (% lang="en-US" style="text-align:left" %) 681 681 "vehicleId": "", ~/~/ ID ТС ... ... @@ -728,13 +728,13 @@ 728 728 (% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}** 729 729 ))) 730 730 731 -(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).730 +(% style="color:#000000" %) Метод позволяет удалить объект. Метод позволяет удалить объект, указанный в строке запроса (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 732 732 733 733 (% style="color:#000000" %)Метод запроса: **DELETE** 734 734 735 735 (% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/vehicles/>>url:https://hosting.glonasssoft.ru/api/v3/vehicles/]](% style="color:#000000" %){vehicleId} 736 736 737 -(% style="color:#000000" %)Параметр запроса: { __**id**__} - Guid объекта736 +(% style="color:#000000" %)Параметр запроса: {id} - Guid объекта 738 738 739 739 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 740 740 ... ... @@ -752,7 +752,7 @@ 752 752 (% style="color:#000000; line-height:100%" %)**Получение списка типов устройств **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/devices/types** 753 753 ))) 754 754 755 -(% style="color:#000000" %) Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).754 +(% style="color:#000000" %) Метод позволяет получить список типов устройств. Метод возвращает информацию о типах устройств с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 756 756 757 757 (% style="color:#000000" %)Метод запроса: **GET** 758 758 ... ... @@ -760,15 +760,16 @@ 760 760 761 761 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 762 762 763 -(% style="color:#000000" %)Ответ: 762 +(% style="color:#000000" %)Ответ: [ 764 764 765 -(% style="color:#000000" %){ 764 +(% class="western" %) 765 +{{{ { 766 + "deviceTypeId" : "", // ID типа устройства 767 + "deviceTypeName" : "" // Название типа устройства 768 + },}}} 766 766 767 - "deviceTypeId" : "", ~/~/ ID типа устройства 768 - "deviceTypeName" : "" ~/~/ Название типа устройства 769 - 770 770 (% style="text-align:left" %) 771 -(% style="color:#000000" %) }771 +(% style="color:#000000" %)…** **] 772 772 773 773 774 774 (% class="box" style="text-align: center;" %) ... ... @@ -781,7 +781,7 @@ 781 781 (% style="color:#000000; line-height:100%" %)**Получение списка типов датчиков **(% style="color:#000000" %)**— **(% lang="en-US" %)**GET /api/v3/sensors/types** 782 782 ))) 783 783 784 -(% style="color:#000000" %) Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **« __X-Auth__»**).784 +(% style="color:#000000" %) Метод позволяет получить список типов датчиков. Метод возвращает информацию о типах датчиков с учетом настроек авторизованного пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«X-Auth»**). 785 785 786 786 (% style="color:#000000" %)Метод запроса: **GET** 787 787 ... ... @@ -789,16 +789,19 @@ 789 789 790 790 (% style="color:#000000" %)В заголовках запроса:X-Auth: Токен авторизации 791 791 792 -(% style="color:#000000" %)Ответ: 792 +(% style="color:#000000" %)Ответ: [ 793 793 794 -(% style="color:#000000" %){ 794 +(% class="western" style="margin-bottom:19px" %) 795 +{{{ {}}} 795 795 796 - "id": "", ~/~/ ID типа датчика 797 - "name": "", ~/~/ Название 798 - "description": "", ~/~/ Описание 797 +(% style="color:#000000" %)«id»: «», //ID типа датчика «name»: «», //Название 799 799 799 +(% class="western" %) 800 +{{{ "description": "" // Описание 801 + },}}} 802 + 800 800 (% style="text-align:left" %) 801 -(% style="color:#000000" %) }804 +(% style="color:#000000" %)… ] 802 802 803 803 804 804 (% class="box" lang="en-US" style="text-align: center;" %)