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
-
... ... @@ -137,9 +137,9 @@ 137 137 "position": "", ~/~/ должность 138 138 "phone": "", ~/~/ телефон 139 139 "organization": "", ~/~/ организация 140 - "login": "", ~/~/ логин (обязателен)141 - "password": "", ~/~/ пароль (обязателен) 142 - "email": "", ~/~/ email (обязателен)140 + "login": "", ~/~/ логин 141 + "password": "", ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо) 142 + "email": "", ~/~/ email 143 143 "description": "", ~/~/ описание 144 144 "isEnabled": "", ~/~/ признак включения 145 145 "parentId": "", ~/~/ Guid родительского агента ... ... @@ -227,128 +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 - "id": "", ~/~/ GUID пользователя 249 -))) 250 - 251 -((( 252 - "lastName": "", ~/~/ Фамилия 253 -))) 254 - 255 -((( 256 - "firstName": "", ~/~/ Имя 257 -))) 258 - 259 -((( 260 - "position": "", ~/~/ Должность 261 -))) 262 - 263 -((( 264 - "phone": "", ~/~/ Номер телефона 265 -))) 266 - 267 -((( 268 - "parentId": "", ~/~/ GUID клиента, которому принадлежит пользователь 269 -))) 270 - 271 -((( 272 - "parentName": "", Наименование клиента, которому принадлежит пользователь 273 -))) 274 - 275 -((( 276 - "organization": "", ~/~/ Организация 277 -))) 278 - 279 -((( 280 - "login": "", ~/~/ Логин пользователя 281 -))) 282 - 283 -((( 284 - "email": "", ~/~/ Адрес электронной почты 285 -))) 286 - 287 -((( 288 - "language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 289 -))) 290 - 291 -((( 292 - "isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено 293 -))) 294 - 295 -((( 296 - "description": "", ~/~/ Описание 297 -))) 298 - 299 -((( 300 - "isEnabled": , ~/~/ Включен, true - включен, false - отключен 301 -))) 302 - 303 -((( 304 - "doubleAuth": , ~/~/ Состояние двухэтапной аутентификации, true - включен, false - отключен 305 -))) 306 - 307 -((( 308 - "doubleAuthEmail": "", ~/~/ Адрес электронной почты двухэтапной аутентификации 309 -))) 310 - 311 -((( 312 - "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 313 -))) 314 - 315 -((( 316 - "sessionDuration": 30, ~/~/ Длительность сессии в минутах 317 -))) 318 - 319 -((( 320 - "status": 0, ~/~/ Статус пользователя, 0 - новый, 1 - подтвержден, 2 - активен, 3 - уточнить, 4 - блокирован 321 -))) 322 - 323 -((( 324 - "lastLogged": "2022-08-22T06:57:51.002129Z", ~/~/ Дата и время последнего входа пользователя 325 -))) 326 - 327 -((( 328 - "groups": [], ~/~/ Список ролей пользователя 329 -))) 330 - 331 -((( 332 - "customGroups": [], ~/~/ Список клиентских ролей пользователя 333 -))) 334 - 335 -((( 336 - "authDevices": [ ], ~/~/ Список авторизованных устройств 337 -))) 338 - 339 -((( 340 - "mobileDoubleAuthDevices": [], ~/~/ Список авторизованных мобильных устройств 341 -))) 342 - 343 -((( 344 - "pushNotificationsDevices": [] ~/~/ Список мобильных устройств которые были подписаны на мобильные уведомления 345 -))) 346 - 347 -((( 348 -} 349 -))) 350 - 351 - 352 352 (% class="box warningmessage" %) 353 353 ((( 354 354 (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users** ... ... @@ -375,10 +375,10 @@ 375 375 "position": "" , ~/~/ должность 376 376 "phone": "" , ~/~/ телефон 377 377 "organization": "" , ~/~/ организация 378 - "login": "" , ~/~/ логин (%style="color:#000000"%)(Если null - менять не надо)(%%)379 - (%lang="ru-RU"style="color:#000000;font-weight:normal"%)"password": "" , ~/~/ пароль (Если null - менять380 - "email": "" , ~/~/ email (%style="color:#000000"%)(Если null - менять не надо)(%%)381 - (%lang="ru-RU"style="color:#000000;font-weight:normal"%)"description": "" , ~/~/ описание256 + "login": "" , ~/~/ логин 257 + "password": "" , ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо) 258 + "email": "" , ~/~/ email 259 + "description": "" , ~/~/ описание 382 382 "isEnabled": "" , ~/~/ признак включения 383 383 "parentId": "" , ~/~/ Guid родительского агента 384 384 "leaderId": "" , ~/~/ Guid руководителя (null - не задан) ... ... @@ -491,7 +491,6 @@ 491 491 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**(%%) 492 492 \\(% style="color:#000000" %)__Для двух, описанных выше, методов если не получилось выполнить включение или отключение некоторых пользователей из переданного списка возвращается ответ - 206 Partial Content__ 493 493 494 -((( 495 495 В теле ответа: 496 496 { 497 497 "errorMessages": [ ... ... @@ -504,7 +504,6 @@ 504 504 \\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями. 505 505 "users" - массив id пользователей, которых не удалось включить или отключить. 506 506 507 -))) 508 508 509 509 (% class="box errormessage" %) 510 510 ((( ... ... @@ -553,149 +553,77 @@ 553 553 554 554 (% style="color:#000000" %)Ответ: 555 555 556 -((( 557 557 { 558 -))) 559 559 560 -((( 561 561 "vehicleId": "", ~/~/ ID объекта 562 -))) 563 563 564 -((( 565 565 "name": "", ~/~/ Имя объекта 566 -))) 567 567 568 -((( 569 569 "imei": "", ~/~/ IMEI объекта 570 -))) 571 571 572 -((( 573 573 "deviceTypeId": , ~/~/ ID типа устройства 574 -))) 575 575 576 -((( 577 577 "deviceTypeName": "", ~/~/ Название типа устройства 578 -))) 579 579 580 -((( 581 581 "sim1": "", ~/~/ Номер SIM1 582 -))) 583 583 584 -((( 585 585 "parentId": "", Номер SIM2 586 -))) 587 587 588 -((( 589 589 "parentName": "", (% style="color:#000000" %)Наименование клиента-родителя 590 -))) 591 591 592 -((( 593 593 "modelId": "", ID модели объекта 594 -))) 595 595 596 -((( 597 597 "modelName": "", Имя модели объекта 598 -))) 599 599 600 -((( 601 601 "createdAt": "", Дата создания объекта 602 -))) 603 603 604 -((( 605 605 "mileageCalcMethod": "", Выбранный метод расчета пробега 606 -))) 607 607 608 -((( 609 609 "counters": { ~/~/ Нормы 610 -))) 611 611 612 -((( 613 613 "mileageEnabled": "", ~/~/ Флаг активности счётчика "Пробег" (true - включен, false - отключен) 614 -))) 615 615 616 -((( 617 617 "motohoursEnabled": "", ~/~/ флаг активности счётчика "Моточасы" (true - включен, false - отключен) 618 -))) 619 619 620 -((( 621 621 "mileage": "", ~/~/ Пробег по нормам в метрах 622 -))) 623 623 624 -((( 625 625 "motohours": "" ~/~/ Моточасы по нормам, в секундах 626 -))) 627 627 628 -((( 629 629 }, 630 -))) 631 631 632 -((( 633 633 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 634 -))) 635 635 636 -((( 637 637 { 638 -))) 639 639 640 -((( 641 641 "id": "", ~/~/ ID задания 642 -))) 643 643 644 -((( 645 645 "enabled": "", ~/~/ Флаг активности задания (true - включен, false - отключен) 646 -))) 647 647 648 -((( 649 649 "name": "", ~/~/ Наименование задания 650 -))) 651 651 652 -((( 653 653 "description": "", ~/~/ Описание задания 654 -))) 655 655 656 -((( 657 657 "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает) 658 -))) 659 659 660 -((( 661 661 "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно) 662 -))) 663 663 664 -((( 665 665 "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает) 666 -))) 667 667 668 -((( 669 669 "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно) 670 -))) 671 671 672 -((( 673 673 "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает) 674 -))) 675 675 676 -((( 677 677 "kind": "", ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает) 678 -))) 679 679 680 -((( 681 681 "lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано) 682 -))) 683 683 684 -((( 685 685 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 686 -))) 687 687 688 -((( 689 689 } 690 -))) 691 691 692 -((( 693 693 ] 694 -))) 695 695 696 -((( 697 697 } 698 -))) 699 699 700 700 (% style="text-align:left" %) 701 701 Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже: