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
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Artem1 +XWiki.krainovim - Content
-
... ... @@ -303,7 +303,7 @@ 303 303 (% style="color:#000000" %)**Изменение статуса пользователя**// //**— **(% lang="en-US" %)**PUT /api/v3/users/status/{id}** 304 304 ))) 305 305 306 -(% style="color:#000000" %) Метод позволяет изменить статус пользователя . Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**).306 +(% style="color:#000000" %) Метод позволяет изменить статус пользователя, указанного в запросе (обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 307 307 308 308 (% style="color:#000000" %)Метод запроса: **PUT** 309 309 ... ... @@ -327,6 +327,48 @@ 327 327 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** 328 328 329 329 330 +(% class="box warningmessage" %) 331 +((( 332 +**Блокировка пользователей** (% style="color:#000000; line-height:100%" %)**— POST /api/v3/users/disable** 333 +))) 334 + 335 +Метода позволяет выполнить массовую блокировку пользователей (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 336 + 337 +(% style="color:#000000" %)Метод запроса: (% style="color:#000000; line-height:100%" %)**POST** 338 + 339 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/disable>>https://hosting.glonasssoft.ru/api/v3/users/disable]] 340 + 341 +(% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 342 + 343 + [ 344 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 345 + "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 346 + ] 347 + 348 +(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** 349 + 350 + 351 +(% class="box warningmessage" %) 352 +((( 353 +**Разблокировка пользователей** (% style="color:#000000; line-height:100%" %)**— POST /api/v3/users/find** 354 +))) 355 + 356 +Метода позволяет выполнить массовую разблокировку пользователей (% style="color:#000000" %)(обязательный параметр в заголовках запроса - токен авторизации **«__X-Auth__»**). 357 + 358 +(% style="color:#000000" %)Метод запроса: (% style="color:#000000; line-height:100%" %)**POST** 359 + 360 +(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/enable>>https://hosting.glonasssoft.ru/api/v3/users/enable]] 361 + 362 +(% style="color:#000000" %)В теле запроса перечисляете массив id пользователей (JSON): 363 + 364 + [ 365 + "8ed730d3-c61c-4c3a-ae4f-f41d9e710abc", 366 + "415f9ea3-8bc0-4e87-8d78-0852b0c0a4f1" 367 + ] 368 + 369 +(% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»** 370 + 371 + 330 330 (% class="box errormessage" %) 331 331 ((( 332 332 (% style="color:#000000; line-height:100%" %)**Удаление пользователя — **(% lang="en-US" %)**DELETE /api/v3/users/{id}** ... ... @@ -426,16 +426,17 @@ 426 426 "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) 427 427 "consumptionPerHour": "" , ~/~/ Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено) 428 428 "consumptionIdle": "" , ~/~/ Расход топлива на холостом ходу 429 - "consumptionPer100KmSeasonal": 0, \ Расход топлива на 100 км (Сезонные нормы - если задано - возвращаем) 430 - "consumptionPerHourSeasonal": 0, \ Расход топлива за моточас (Сезонные нормы - если задано - возвращаем) 431 - "consumptionIdleSeasonal": 0, \ Расход топлива на холостом ходу (Сезонные нормы - если задано - возвращаем) 432 - "consumptionPer100KmSeasonalBegin": "" , ~/~/ параметры начала применения значений сезонных норм 433 - "consumptionPer100KmSeasonalEnd": "" , ~/~/ параметры окончания применения значений сезонных норм 434 - "consumptionPerHourSeasonalBegin": "" , ~/~/ параметры начала применения значений сезонных норм 435 - "consumptionPerHourSeasonalEnd": "" , ~/~/параметры окончания применения значений сезонных норм 436 - "consumptionIdleSeasonalBegin": "" , ~/~/ параметры начала применения значений сезонных норм 437 - "consumptionIdleSeasonalEnd": "" , ~/~/ параметры окончания применения значений сезонных норм 438 - "counters": { 471 + "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 472 + "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 473 + "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 474 + "consumptionPer100KmSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 475 + "consumptionPer100KmSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 476 + "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 477 + "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 478 + "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 479 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 480 + "counters": ~/~/ счетчики 481 + { 439 439 "mileage": "" , ~/~/ пробег 440 440 "mileageEnabled": true, ~/~/ флаг активности счётчика "пробег" 441 441 "motohours": "" , ~/~/ моточасы ... ... @@ -510,7 +510,12 @@ 510 510 (% style="text-align:left" %) 511 511 (% style="color:#000000" %)} 512 512 556 +**Валидация:** 557 +- сезонный параметр может быть задан только если задана соответствующая обычная норма; 558 +- сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 559 +- при задании сезонной нормы обязательны соответствующие даты начала/окончания. 513 513 561 + 514 514 (% class="box successmessage" %) 515 515 ((( 516 516 (% style="color:#000000; line-height:100%" %)**Получение параметров объектов — **(% lang="en-US" %)**POST /api/v3/vehicles/find** ... ... @@ -645,6 +645,7 @@ 645 645 646 646 (% style="color:#000000" %){ 647 647 696 +((( 648 648 (% style="color:#000000" %) "vehicleId": "", ~/~/ ID ТС 649 649 "parentId": "", ~/~/ ID клиента 650 650 "name": "", ~/~/ имя ТС ... ... @@ -653,10 +653,20 @@ 653 653 "modelId": "", ~/~/ , ID модели 654 654 "unitId": "", ~/~/ подразделения 655 655 "sim1": "", ~/~/ SIM 1 656 - "sim2": "", ~/~/ SIM2 657 - "consumptionPer100Km": "", ~/~/ Расход топлива на 100 км 658 - "consumptionIdle": "", ~/~/ Расход топлива на холостом ходу 659 - "counters": 705 + "sim2": "", ~/~/ SIM2 (%%) 706 + "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) 707 + "consumptionPerHour": "" , ~/~/ Расход топлива за моточас (если заполнено, то consumptionPer100Km не может быть заполнено) 708 + "consumptionIdle": "" , ~/~/ Расход топлива на холостом ходу 709 + "consumptionPer100KmSeasonal": 0, ~/~/ Сезонный расход топлива на 100 км 710 + "consumptionPerHourSeasonal": 0, ~/~/ Сезонный расход топлива на моточас 711 + "consumptionIdleSeasonal": 0, ~/~/ Сезонный расход топлива на холостом ходу 712 + "consumptionPer100KmSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на 100 км 713 + "consumptionPer100KmSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на 100 км 714 + "consumptionPerHourSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на моточас 715 + "consumptionPerHourSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на моточас 716 + "consumptionIdleSeasonalBegin": "" , ~/~/ День/месяц начала работы сезонной нормы расхода на х/х 717 + "consumptionIdleSeasonalEnd": "" , ~/~/ День/месяц окончания работы сезонной нормы расхода на х/х 718 +(% style="color:#000000" %) "counters": 660 660 { 661 661 "mileageEnabled": true, ~/~/ флаг активности счётчика «пробег» 662 662 "motohoursEnabled": true, ~/~/ флаг активности счётчика «моточасы» ... ... @@ -685,6 +685,7 @@ 685 685 "kind": "", ~/~/ Вид периодичности по времени 686 686 "maxQuantity": "", ~/~/ Сколько раз выполнить задание 687 687 } 747 +))) 688 688 689 689 (% style="color:#000000" %)} 690 690 ... ... @@ -738,7 +738,12 @@ 738 738 (% lang="en-US" style="text-align:left" %) 739 739 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)} 740 740 801 +**валидация:** 802 +- сезонный параметр может быть задан только если задана соответствующая обычная норма; 803 +- сезонные начало и окончание могут быть заданы только если задана соответствующая сезонная норма; 804 +- при задании сезонной нормы обязательны соответствующие даты начала/окончания. 741 741 806 + 742 742 (% class="box errormessage" %) 743 743 ((( 744 744 (% style="color:#000000; line-height:100%" %)**Удаление объекта — **(% lang="en-US" %)**DELETE /api/v3/vehicles/{vehicleId}**