Last modified by Андрей Калиновский on 2025/02/25 16:35
<
From version < 45.1 >
edited by Илья Крайнов
on 2022/11/21 10:27
To version < 39.1 >
edited by Илья Крайнов
on 2022/11/17 14:50
>
Change comment: There is no comment for this version

Summary

Details

Icon 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,184 +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" %)В заголовках запроса: X-Auth: Токен авторизации
242 -
243 -(% style="color:#000000" %)Ответ:
244 -
245 -(((
246 -(((
247 -{
248 -)))
249 -)))
250 -
251 -(((
252 -(((
253 - "id": "", ~/~/ GUID пользователя
254 -)))
255 -)))
256 -
257 -(((
258 -(((
259 - "lastName": "", ~/~/ Фамилия
260 -)))
261 -)))
262 -
263 -(((
264 -(((
265 - "firstName": "", ~/~/ Имя
266 -)))
267 -)))
268 -
269 -(((
270 -(((
271 - "position": "", ~/~/ Должность
272 -)))
273 -)))
274 -
275 -(((
276 -(((
277 - "phone": "", ~/~/ Номер телефона
278 -)))
279 -)))
280 -
281 -(((
282 -(((
283 - "parentId": "", ~/~/ GUID клиента, которому принадлежит пользователь
284 -)))
285 -)))
286 -
287 -(((
288 -(((
289 - "parentName": "", Наименование клиента, которому принадлежит пользователь
290 -)))
291 -)))
292 -
293 -(((
294 -(((
295 - "organization": "", ~/~/ Организация
296 -)))
297 -)))
298 -
299 -(((
300 -(((
301 - "login": "", ~/~/ Логин пользователя
302 -)))
303 -)))
304 -
305 -(((
306 -(((
307 - "email": "", ~/~/ Адрес электронной почты
308 -)))
309 -)))
310 -
311 -(((
312 -(((
313 - "language": , ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
314 -)))
315 -)))
316 -
317 -(((
318 -(((
319 - "isReadOnly": , ~/~/ Право только на чтение, true - включено, false - отключено
320 -)))
321 -)))
322 -
323 -(((
324 -(((
325 - "description": "", ~/~/ Описание
326 -)))
327 -)))
328 -
329 -(((
330 -(((
331 - "isEnabled": , ~/~/ Включен, true - включен, false - отключен
332 -)))
333 -)))
334 -
335 -(((
336 -(((
337 - "doubleAuth": , ~/~/ Состояние двухэтапной аутентификации, true - включен, false - отключен
338 -)))
339 -)))
340 -
341 -(((
342 -(((
343 - "doubleAuthEmail": "", ~/~/ Адрес электронной почты двухэтапной аутентификации
344 -)))
345 -)))
346 -
347 -(((
348 -(((
349 - "isDisabledMobile": false, ~/~/ Запретить использовать мобильное приложение, true - включен, false - отключен
350 -)))
351 -)))
352 -
353 -(((
354 -(((
355 - "sessionDuration": 30, ~/~/ Длительность сессии в минутах
356 -)))
357 -)))
358 -
359 -(((
360 -(((
361 - "status": 0, ~/~/ Статус пользователя, 0 - новый, 1 - подтвержден, 2 - активен, 3 - уточнить, 4 - блокирован
362 -)))
363 -)))
364 -
365 -(((
366 -(((
367 - "lastLogged": "2022-08-22T06:57:51.002129Z", ~/~/ Дата и время последнего входа пользователя
368 -)))
369 -)))
370 -
371 -(((
372 -(((
373 - "groups": [], ~/~/ Список ролей пользователя
374 -)))
375 -)))
376 -
377 -(((
378 -(((
379 - "customGroups": [], ~/~/ Список клиентских ролей пользователя
380 -)))
381 -)))
382 -
383 -(((
384 -(((
385 - "authDevices": [ ], ~/~/ Список авторизованных устройств
386 -)))
387 -)))
388 -
389 -(((
390 -(((
391 - "mobileDoubleAuthDevices": [], ~/~/ Список авторизованных мобильных устройств
392 -)))
393 -)))
394 -
395 -(((
396 -(((
397 - "pushNotificationsDevices": [] ~/~/ Список мобильных устройств которые были подписаны на мобильные уведомления
398 -)))
399 -)))
400 -
401 -(((
402 -(((
403 -}
404 -)))
405 -)))
406 -
407 -
408 408  (% class="box warningmessage" %)
409 409  (((
410 410  (% style="color:#000000; line-height:100%" %)**Редактирование пользователя — **(% lang="en-US" %)**PUT /api/v3/users**
... ... @@ -418,8 +418,6 @@
418 418  
419 419  (% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации
420 420  
421 -**При редактировании необходимо передавать все параметры пользователя в теле запроса! Те параметры, значения которых не будут переданы - будут стерты!**
422 -
423 423  (% lang="en-US" style="text-align:left" %)
424 424  (% lang="ru-RU" style="color:#000000; font-weight:normal" %)Параметры в теле запроса (JSON):
425 425  
... ... @@ -433,10 +433,10 @@
433 433   "position": "" , ~/~/ должность
434 434   "phone": "" , ~/~/ телефон
435 435   "organization": "" , ~/~/ организация
436 - "login": "" , ~/~/ логин   (% style="color:#000000" %)(Если null - менять не надо)(%%)
437 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "password": "" , ~/~/ пароль (Если null - менять не надо)
438 - "email": "" , ~/~/ email   (% style="color:#000000" %)(Если null - менять не надо)(%%)
439 -(% lang="ru-RU" style="color:#000000; font-weight:normal" %) "description": "" , ~/~/ описание
256 + "login": "" , ~/~/ логин
257 + "password": "" , ~/~/ пароль (при добавлении - обязателен, при редактировании, если null - менять пароль не надо)
258 + "email": "" , ~/~/ email
259 + "description": "" , ~/~/ описание
440 440   "isEnabled": "" , ~/~/ признак включения
441 441   "parentId": "" , ~/~/ Guid родительского агента
442 442   "leaderId": "" , ~/~/ Guid руководителя (null - не задан)
... ... @@ -549,7 +549,6 @@
549 549  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200»**(%%)
550 550  \\(% style="color:#000000" %)__Для двух, описанных выше, методов если не получилось выполнить включение или отключение некоторых пользователей из переданного списка возвращается ответ - 206 Partial Content__
551 551  
552 -(((
553 553  В теле ответа:
554 554  {
555 555   "errorMessages": [
... ... @@ -562,7 +562,6 @@
562 562  \\\\"errorMessages" - массив ошибок, из-за которых не выполнилось действие с пользователями.
563 563  "users" - массив id пользователей, которых не удалось включить или отключить.
564 564  
565 -)))
566 566  
567 567  (% class="box errormessage" %)
568 568  (((
... ... @@ -611,149 +611,77 @@
611 611  
612 612  (% style="color:#000000" %)Ответ:
613 613  
614 -(((
615 615  {
616 -)))
617 617  
618 -(((
619 619   "vehicleId": "", ~/~/ ID объекта
620 -)))
621 621  
622 -(((
623 623   "name": "", ~/~/ Имя объекта
624 -)))
625 625  
626 -(((
627 627   "imei": "", ~/~/ IMEI объекта
628 -)))
629 629  
630 -(((
631 631   "deviceTypeId": , ~/~/ ID типа устройства
632 -)))
633 633  
634 -(((
635 635   "deviceTypeName": "", ~/~/ Название типа устройства
636 -)))
637 637  
638 -(((
639 639   "sim1": "", ~/~/ Номер SIM1
640 -)))
641 641  
642 -(((
643 643   "parentId": "", Номер SIM2
644 -)))
645 645  
646 -(((
647 647   "parentName": "", (% style="color:#000000" %)Наименование клиента-родителя
648 -)))
649 649  
650 -(((
651 651   "modelId": "", ID модели объекта
652 -)))
653 653  
654 -(((
655 655   "modelName": "", Имя модели объекта
656 -)))
657 657  
658 -(((
659 659   "createdAt": "", Дата создания объекта
660 -)))
661 661  
662 -(((
663 663   "mileageCalcMethod": "", Выбранный метод расчета пробега
664 -)))
665 665  
666 -(((
667 667   "counters": { ~/~/ Нормы
668 -)))
669 669  
670 -(((
671 671   "mileageEnabled": "", ~/~/ Флаг активности счётчика "Пробег" (true - включен, false - отключен)
672 -)))
673 673  
674 -(((
675 675   "motohoursEnabled": "", ~/~/ флаг активности счётчика "Моточасы" (true - включен, false - отключен)
676 -)))
677 677  
678 -(((
679 679   "mileage": "", ~/~/ Пробег по нормам в метрах
680 -)))
681 681  
682 -(((
683 683   "motohours": "" ~/~/ Моточасы по нормам, в секундах
684 -)))
685 685  
686 -(((
687 687   },
688 -)))
689 689  
690 -(((
691 691   "inspectionTasks": [ ~/~/ Задания на тех. обслуживание
692 -)))
693 693  
694 -(((
695 695   {
696 -)))
697 697  
698 -(((
699 699   "id": "", ~/~/ ID  задания
700 -)))
701 701  
702 -(((
703 703   "enabled": "", ~/~/ Флаг активности задания (true - включен, false - отключен)
704 -)))
705 705  
706 -(((
707 707   "name": "", ~/~/ Наименование задания
708 -)))
709 709  
710 -(((
711 711   "description": "", ~/~/ Описание задания
712 -)))
713 713  
714 -(((
715 715   "mileageCondition": "", ~/~/ Условие по пробегу (в метрах, null - условие не работает)
716 -)))
717 717  
718 -(((
719 719   "lastMileage": "", ~/~/ Пробег (в метрах) на момент последнего ТО (null - неважно)
720 -)))
721 721  
722 -(((
723 723   "motohoursCondition": "", ~/~/ Условие по моточасам (в секундах, null - условие не работает)
724 -)))
725 725  
726 -(((
727 727   "lastMotohours": "", ~/~/ Моточасы (в секундах) на момент последнего ТО (null - неважно)
728 -)))
729 729  
730 -(((
731 731   "periodicCondition": "", ~/~/ Условие периодичности по времени (null - условие не работает)
732 -)))
733 733  
734 -(((
735 735   "kind": "", ~/~/ Вид периодичности по времени (дни - Days, месяцы - Months, года - Years, null - условие не работает)
736 -)))
737 737  
738 -(((
739 739   "lastInspectionDate": "" ~/~/ Дата последнего ТО (null - не указано)
740 -)))
741 741  
742 -(((
743 743   "maxQuantity": "" ~/~/ Сколько раз выполнить задание (null - однократно)
744 -)))
745 745  
746 -(((
747 747   }
748 -)))
749 749  
750 -(((
751 751   ]
752 -)))
753 753  
754 -(((
755 755  }
756 -)))
757 757  
758 758  (% style="text-align:left" %)
759 759  Параметр «status» содержит id статуса объекта в системе, соответствие id и текстовое названия статуса приведены ниже:
... ... @@ -914,23 +914,17 @@
914 914  
915 915  (% style="color:#000000" %)Параметры в теле запроса (JSON):
916 916  
663 +(% class="western" style="color:#000000" %)##{##
917 917  
918 -{
919 - "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально)
920 - "name": null, ~/~/ Имя ТС (string, опционально)
921 - "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально)
922 - "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально)
923 - "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально)
924 - "parentId": null, ~/~/ ID клиента (Guid, опционально)
925 - "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)
926 - "customFields\": null ~/~/ значение любого из произвольных полей ТС
927 -}
665 +(% class="western" style="color:#000000" %) "vehicleId": null, ~/~/ 84350, ID ТС (int, опционально) 
666 + "name": null, ~/~/ Имя ТС (string, опционально) 
667 + "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 
668 + "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 
669 + "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 
670 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 
671 + "unitId": null ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально)(%%)
672 +(% style="color:#000000" %)}
928 928  
929 -
930 -(((
931 -
932 -)))
933 -
934 934  (% style="color:#000000" %) Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**.
935 935  
936 936  (% style="color:#000000" %)Ответ:

Меню

ГЛОНАССSoft wiki - 2024 г.