Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/02/25 16:35
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -227,182 +227,6 @@ 227 227 (% style="color:#000000" %)} 228 228 229 229 230 -(% class="box successmessage" %) 231 -((( 232 -(% style="color:#000000; line-height:100%" %)**Получение информации о пользователе — **(% lang="en-US" %)**GET /api/v3/users/{GUID}** 233 -))) 234 - 235 -(% style="color:#000000" %)Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользователях предоставляется при наличии права **«__Просмотр пользователей__»**. 236 - 237 -(% style="color:#000000" %)Метод запроса: **GET** 238 - 239 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/(% lang="en-US" %)users/{GUID}>>https://hosting.glonasssoft.ru/api/v3/users/{GUID}]] 240 - 241 -(% style="color:#000000" %)Ответ: 242 - 243 -((( 244 -((( 245 -{ 246 -))) 247 -))) 248 - 249 -((( 250 -((( 251 - "id": "", ~/~/ GUID пользователя 252 -))) 253 -))) 254 - 255 -((( 256 -((( 257 - "lastName": "", ~/~/ Фамилия 258 -))) 259 -))) 260 - 261 -((( 262 -((( 263 - "firstName": "", ~/~/ Имя 264 -))) 265 -))) 266 - 267 -((( 268 -((( 269 - "position": "", ~/~/ Должность 270 -))) 271 -))) 272 - 273 -((( 274 -((( 275 - "phone": "", ~/~/ Номер телефона 276 -))) 277 -))) 278 - 279 -((( 280 -((( 281 - "parentId": "", ~/~/ GUID клиента, которому принадлежит пользователь 282 -))) 283 -))) 284 - 285 -((( 286 -((( 287 - "parentName": "", Наименование клиента, которому принадлежит пользователь 288 -))) 289 -))) 290 - 291 -((( 292 -((( 293 - "organization": "", ~/~/ Организация 294 -))) 295 -))) 296 - 297 -((( 298 -((( 299 - "login": "", ~/~/ Логин пользователя 300 -))) 301 -))) 302 - 303 -((( 304 -((( 305 - "email": "", ~/~/ Адрес электронной почты 306 -))) 307 -))) 308 - 309 -((( 310 -((( 311 - "language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 312 -))) 313 -))) 314 - 315 -((( 316 -((( 317 - "isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено 318 -))) 319 -))) 320 - 321 -((( 322 -((( 323 - "description": "", ~/~/ Описание 324 -))) 325 -))) 326 - 327 -((( 328 -((( 329 - "isEnabled": , ~/~/ Включен, true - включен, false - отключен 330 -))) 331 -))) 332 - 333 -((( 334 -((( 335 - "doubleAuth": , ~/~/ Состояние двухэтапной аутентификации, true - включен, false - отключен 336 -))) 337 -))) 338 - 339 -((( 340 -((( 341 - "doubleAuthEmail": "", ~/~/ Адрес электронной почты двухэтапной аутентификации 342 -))) 343 -))) 344 - 345 -((( 346 -((( 347 - "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 348 -))) 349 -))) 350 - 351 -((( 352 -((( 353 - "sessionDuration": 30, ~/~/ Длительность сессии в минутах 354 -))) 355 -))) 356 - 357 -((( 358 -((( 359 - "status": 0, ~/~/ Статус пользователя, 0 - новый, 1 - подтвержден, 2 - активен, 3 - уточнить, 4 - блокирован 360 -))) 361 -))) 362 - 363 -((( 364 -((( 365 - "lastLogged": "2022-08-22T06:57:51.002129Z", ~/~/ Дата и время последнего входа пользователя 366 -))) 367 -))) 368 - 369 -((( 370 -((( 371 - "groups": [], ~/~/ Список ролей пользователя 372 -))) 373 -))) 374 - 375 -((( 376 -((( 377 - "customGroups": [], ~/~/ Список клиентских ролей пользователя 378 -))) 379 -))) 380 - 381 -((( 382 -((( 383 - "authDevices": [ ], ~/~/ Список авторизованных устройств 384 -))) 385 -))) 386 - 387 -((( 388 -((( 389 - "mobileDoubleAuthDevices": [], ~/~/ Список авторизованных мобильных устройств 390 -))) 391 -))) 392 - 393 -((( 394 -((( 395 - "pushNotificationsDevices": [] ~/~/ Список мобильных устройств которые были подписаны на мобильные уведомления 396 -))) 397 -))) 398 - 399 -((( 400 -((( 401 -} 402 -))) 403 -))) 404 - 405 - 406 406 (% class="box warningmessage" %) 407 407 ((( 408 408 (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users** ... ... @@ -429,9 +429,9 @@ 429 429 "position": "" , ~/~/ должность 430 430 "phone": "" , ~/~/ телефон 431 431 "organization": "" , ~/~/ организация 432 - "login": "" , ~/~/ логин 256 + "login": "" , ~/~/ логин (% style="color:#000000" %)(Если null - менять не надо)(%%) 433 433 (% lang="ru-RU" style="color:#000000; font-weight:normal" %) "password": "" , ~/~/ пароль (Если null - менять не надо) 434 - "email": "" , ~/~/ email 258 + "email": "" , ~/~/ email (% style="color:#000000" %)(Если null - менять не надо)(%%) 435 435 (% lang="ru-RU" style="color:#000000; font-weight:normal" %) "description": "" , ~/~/ описание 436 436 "isEnabled": "" , ~/~/ признак включения 437 437 "parentId": "" , ~/~/ Guid родительского агента ... ... @@ -545,7 +545,6 @@ 545 545 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**(%%) 546 546 \\(% style="color:#000000" %)__Для двух, описанных выше, методов если не получилось выполнить включение или отключение некоторых пользователей из переданного списка возвращается ответ - 206 Partial Content__ 547 547 548 -((( 549 549 В теле ответа: 550 550 { 551 551 "errorMessages": [ ... ... @@ -558,7 +558,6 @@ 558 558 \\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями. 559 559 "users" - массив id пользователей, которых не удалось включить или отключить. 560 560 561 -))) 562 562 563 563 (% class="box errormessage" %) 564 564 ((( ... ... @@ -607,149 +607,77 @@ 607 607 608 608 (% style="color:#000000" %)Ответ: 609 609 610 -((( 611 611 { 612 -))) 613 613 614 -((( 615 615 "vehicleId": "", ~/~/ ID объекта 616 -))) 617 617 618 -((( 619 619 "name": "", ~/~/ Имя объекта 620 -))) 621 621 622 -((( 623 623 "imei": "", ~/~/ IMEI объекта 624 -))) 625 625 626 -((( 627 627 "deviceTypeId": , ~/~/ ID типа устройства 628 -))) 629 629 630 -((( 631 631 "deviceTypeName": "", ~/~/ Название типа устройства 632 -))) 633 633 634 -((( 635 635 "sim1": "", ~/~/ Номер SIM1 636 -))) 637 637 638 -((( 639 639 "parentId": "", Номер SIM2 640 -))) 641 641 642 -((( 643 643 "parentName": "", (% style="color:#000000" %)Наименование клиента-родителя 644 -))) 645 645 646 -((( 647 647 "modelId": "", ID модели объекта 648 -))) 649 649 650 -((( 651 651 "modelName": "", Имя модели объекта 652 -))) 653 653 654 -((( 655 655 "createdAt": "", Дата создания объекта 656 -))) 657 657 658 -((( 659 659 "mileageCalcMethod": "", Выбранный метод расчета пробега 660 -))) 661 661 662 -((( 663 663 "counters": { ~/~/ Нормы 664 -))) 665 665 666 -((( 667 667 "mileageEnabled": "", ~/~/ Флаг активности счётчика "Пробег" (true - включен, false - отключен) 668 -))) 669 669 670 -((( 671 671 "motohoursEnabled": "", ~/~/ флаг активности счётчика "Моточасы" (true - включен, false - отключен) 672 -))) 673 673 674 -((( 675 675 "mileage": "", ~/~/ Пробег по нормам в метрах 676 -))) 677 677 678 -((( 679 679 "motohours": "" ~/~/ Моточасы по нормам, в секундах 680 -))) 681 681 682 -((( 683 683 }, 684 -))) 685 685 686 -((( 687 687 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 688 -))) 689 689 690 -((( 691 691 { 692 -))) 693 693 694 -((( 695 695 "id": "", ~/~/ ID задания 696 -))) 697 697 698 -((( 699 699 "enabled": "", ~/~/ Флаг активности задания (true - включен, false - отключен) 700 -))) 701 701 702 -((( 703 703 "name": "", ~/~/ Наименование задания 704 -))) 705 705 706 -((( 707 707 "description": "", ~/~/ Описание задания 708 -))) 709 709 710 -((( 711 711 "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает) 712 -))) 713 713 714 -((( 715 715 "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно) 716 -))) 717 717 718 -((( 719 719 "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает) 720 -))) 721 721 722 -((( 723 723 "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно) 724 -))) 725 725 726 -((( 727 727 "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает) 728 -))) 729 729 730 -((( 731 731 "kind": "", ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает) 732 -))) 733 733 734 -((( 735 735 "lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано) 736 -))) 737 737 738 -((( 739 739 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 740 -))) 741 741 742 -((( 743 743 } 744 -))) 745 745 746 -((( 747 747 ] 748 -))) 749 749 750 -((( 751 751 } 752 -))) 753 753 754 754 (% style="text-align:left" %) 755 755 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: