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
-
... ... @@ -232,121 +232,47 @@ 232 232 (% style="color:#000000; line-height:100%" %)**Получение информации о пользователе — **(% lang="en-US" %)**GET /api/v3/users/{GUID}** 233 233 ))) 234 234 235 -(% style="color:#000000" %)Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользовател яхпредоставляется при наличии права **«__Просмотр пользователей__»**.235 +(% style="color:#000000" %) Метод возвращает подробную информацию о пользователе клиента-родителя авторизованного пользователя или пользователя его дочерних клиентов. Информация о пользователе предоставляется при наличии права **«__Просмотр пользователей__»**. 236 236 237 237 (% style="color:#000000" %)Метод запроса: **GET** 238 238 239 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 240 241 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 242 + 241 241 (% style="color:#000000" %)Ответ: 242 242 243 243 ((( 244 -{ 245 -))) 246 - 247 247 ((( 247 +{ 248 248 "id": "", ~/~/ GUID пользователя 249 -))) 250 - 251 -((( 252 - "lastName": "", ~/~/ Фамилия 253 -))) 254 - 255 -((( 249 + "lastName": "", ~/~/ Фамилия 256 256 "firstName": "", ~/~/ Имя 257 -))) 258 - 259 -((( 260 260 "position": "", ~/~/ Должность 261 -))) 262 - 263 -((( 264 264 "phone": "", ~/~/ Номер телефона 265 -))) 266 - 267 -((( 268 268 "parentId": "", ~/~/ GUID клиента, которому принадлежит пользователь 269 -))) 270 - 271 -((( 272 272 "parentName": "", Наименование клиента, которому принадлежит пользователь 273 -))) 274 - 275 -((( 276 276 "organization": "", ~/~/ Организация 277 -))) 278 - 279 -((( 280 280 "login": "", ~/~/ Логин пользователя 281 -))) 282 - 283 -((( 284 284 "email": "", ~/~/ Адрес электронной почты 285 -))) 286 - 287 -((( 288 288 "language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 289 -))) 290 - 291 -((( 292 292 "isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено 293 -))) 294 - 295 -((( 296 296 "description": "", ~/~/ Описание 297 -))) 298 - 299 -((( 300 300 "isEnabled": , ~/~/ Включен, true - включен, false - отключен 301 -))) 302 - 303 -((( 304 304 "doubleAuth": , ~/~/ Состояние двухэтапной аутентификации, true - включен, false - отключен 305 -))) 306 - 307 -((( 308 308 "doubleAuthEmail": "", ~/~/ Адрес электронной почты двухэтапной аутентификации 309 -))) 310 - 311 -((( 312 312 "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен 313 -))) 314 - 315 -((( 316 316 "sessionDuration": 30, ~/~/ Длительность сессии в минутах 317 -))) 318 - 319 -((( 320 320 "status": 0, ~/~/ Статус пользователя, 0 - новый, 1 - подтвержден, 2 - активен, 3 - уточнить, 4 - блокирован 321 -))) 322 - 323 -((( 324 324 "lastLogged": "2022-08-22T06:57:51.002129Z", ~/~/ Дата и время последнего входа пользователя 325 -))) 326 - 327 -((( 328 328 "groups": [], ~/~/ Список ролей пользователя 329 -))) 330 - 331 -((( 332 332 "customGroups": [], ~/~/ Список клиентских ролей пользователя 333 -))) 334 - 335 -((( 336 336 "authDevices": [ ], ~/~/ Список авторизованных устройств 337 -))) 338 - 339 -((( 340 340 "mobileDoubleAuthDevices": [], ~/~/ Список авторизованных мобильных устройств 341 -))) 342 - 343 -((( 344 344 "pushNotificationsDevices": [] ~/~/ Список мобильных устройств которые были подписаны на мобильные уведомления 345 -))) 346 - 347 -((( 348 348 } 349 349 ))) 275 +))) 350 350 351 351 352 352 (% class="box warningmessage" %) ... ... @@ -362,6 +362,8 @@ 362 362 363 363 (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 364 364 291 +**При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!** 292 + 365 365 (% lang="en-US" style="text-align:left" %) 366 366 (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON): 367 367 ... ... @@ -555,145 +555,40 @@ 555 555 556 556 ((( 557 557 { 558 -))) 559 - 560 -((( 561 561 "vehicleId": "", ~/~/ ID объекта 562 -))) 563 - 564 -((( 565 565 "name": "", ~/~/ Имя объекта 566 -))) 567 - 568 -((( 569 569 "imei": "", ~/~/ IMEI объекта 570 -))) 571 - 572 -((( 573 573 "deviceTypeId": , ~/~/ ID типа устройства 574 -))) 575 - 576 -((( 577 577 "deviceTypeName": "", ~/~/ Название типа устройства 578 -))) 579 - 580 -((( 581 581 "sim1": "", ~/~/ Номер SIM1 582 -))) 583 - 584 -((( 585 585 "parentId": "", Номер SIM2 586 -))) 587 - 588 -((( 589 - "parentName": "", (% style="color:#000000" %)Наименование клиента-родителя 590 -))) 591 - 592 -((( 493 + "parentName": "", Наименование клиента-родителя 593 593 "modelId": "", ID модели объекта 594 -))) 595 - 596 -((( 597 597 "modelName": "", Имя модели объекта 598 -))) 599 - 600 -((( 601 601 "createdAt": "", Дата создания объекта 602 -))) 603 - 604 -((( 605 605 "mileageCalcMethod": "", Выбранный метод расчета пробега 606 -))) 607 - 608 -((( 609 609 "counters": { ~/~/ Нормы 610 -))) 611 - 612 -((( 613 613 "mileageEnabled": "", ~/~/ Флаг активности счётчика "Пробег" (true - включен, false - отключен) 614 -))) 615 - 616 -((( 617 617 "motohoursEnabled": "", ~/~/ флаг активности счётчика "Моточасы" (true - включен, false - отключен) 618 -))) 619 - 620 -((( 621 621 "mileage": "", ~/~/ Пробег по нормам в метрах 622 -))) 623 - 624 -((( 625 625 "motohours": "" ~/~/ Моточасы по нормам, в секундах 626 -))) 627 - 628 -((( 629 629 }, 630 -))) 631 - 632 -((( 633 633 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 634 -))) 635 - 636 -((( 637 637 { 638 -))) 639 - 640 -((( 641 - "id": "", ~/~/ ID задания 642 -))) 643 - 644 -((( 506 + "id": "", ~/~/ ID задания 645 645 "enabled": "", ~/~/ Флаг активности задания (true - включен, false - отключен) 646 -))) 647 - 648 -((( 649 649 "name": "", ~/~/ Наименование задания 650 -))) 651 - 652 -((( 653 653 "description": "", ~/~/ Описание задания 654 -))) 655 - 656 -((( 657 657 "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает) 658 -))) 659 - 660 -((( 661 661 "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно) 662 -))) 663 - 664 -((( 665 665 "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает) 666 -))) 667 - 668 -((( 669 669 "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно) 670 -))) 671 - 672 -((( 673 673 "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает) 674 -))) 675 - 676 -((( 677 677 "kind": "", ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает) 678 -))) 679 - 680 -((( 681 681 "lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано) 682 -))) 683 - 684 -((( 685 685 "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно) 686 -))) 687 - 688 -((( 689 689 } 690 -))) 691 - 692 -((( 693 693 ] 694 -))) 695 - 696 -((( 697 697 } 698 698 ))) 699 699 ... ... @@ -856,17 +856,17 @@ 856 856 857 857 (% style="color:#000000" %)Параметры в теле запроса (JSON): 858 858 859 -(% class="western" style="color:#000000" %)##{## 682 +{ 683 + "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) 684 + "name": null, ~/~/ Имя ТС (string, опционально) 685 + "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 686 + "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 687 + "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 688 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 689 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 690 + "customFields": null ~/~/ значение любого из произвольных полей ТС 691 +} 860 860 861 -(% class="western" style="color:#000000" %) "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) 862 - "name": null, ~/~/ Имя ТС (string, опционально) 863 - "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 864 - "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 865 - "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 866 - "parentId": null, ~/~/ ID клиента (Guid, опционально) 867 - "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)(%%) 868 -(% style="color:#000000" %)} 869 - 870 870 (% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. 871 871 872 872 (% style="color:#000000" %)Ответ: