Справочный центр Wialon

update_user_flags

Чтобы установить флаги пользователя (дополнительные свойства), используйте метод user/update_user_flags:

Copied!
svc=user/update_user_flags&params={"userId":<long>,
				   "flags":<uint>,
				   "flagsMask":<uint>}

Параметры

Обязательные параметры отмечены звездочкой (*).

Название Описание
userId* ID пользователя.
flags* Флаги настроек. См. ниже.
flagsMask* Маска, определяющая, какие биты будут изменены.

Флаги настроек пользователя:

Значение Описание
0x01 Пользователь выключен.
0x02 Не может менять пароль.
0x04 Может создавать элементы.
0x10 Не может менять настройки.
0x20 Может отправлять SMS.
0x40 Администратор. Этот флаг нельзя изменить с помощью этого метода, но он может возвращаться в поле fl ответа.

Пример использования маски и флагов

Необходимо разрешить пользователю менять пароль (0x02), запретить менять настройки (0x10), а все остальные флаги оставить без изменений. В этом случае маска будет равна 0x2+0x10=0x12. Флаг 0x02 необходимо снять, а флаг 0x10 — установить, поэтому значение параметра flags будет равно 0x10.

Ответ

Copied!
{
	"fl":<uint>	/* флаги */
}

Коды ошибок

Код ошибки Описание
4 Указаны неверные параметры.
6 Не удалось обновить флаги.
7 Одна из следующих ошибок:
  • Пользователь не найден, или у вас нет права доступа Редактирование основных свойств пользователя на этого пользователя.
  • Не удалось получить создателя пользователя.
  • Параметр flagsMask содержит флаги, которые нельзя изменить. Можно изменить только флаги 0x01, 0x02, 0x04, 0x10 и 0x20. Флаги 0x04 и 0x20 можно изменить, только если они есть у создателя пользователя.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.