Пользователь

/api/user методы.

DELETE /api/user/:id

Выключить пользователя User. Не удаляет пользователя User из БД, но но вместо этого отключает его учетную запись.

Вы должны обладать правами суперпользователя, чтобы использовать этот метод.

Параметры:

  • id

GET /api/user/

Получить список всех пользователей Users. По умолчанию возвращает всех активных пользователей, и только их.

  • Если status является deactivated, включает также деактивированных пользователей.

  • Если status является all, включает всех пользователей (активных и неактивных) .

  • Также поддерживает include_deactivated, который если true, то равен status=all; если false, то равен status=active. status и include_deactivated требует разрешения суперпользователя.

  • include_deactivated это устаревшая связка для status и будет удалена в будущем релизе, пользователям предлагается использовать status. Если оба параметра переданы, status имеет приоритет.

    Для пользователей с сегментированными разрешениями вернет только себя.

    Использует limit, offset для разбивки на страницы. Использует query для фильтра по имени, фамилии, эл. почте. Также использует group_id для фильтров по группе id.

Параметры:

  • status строка или null.

  • query строка или null.

  • group_id целое число больше нуля или null.

  • include_deactivated логическое значение, может быть пустым.

GET /api/user/:id

Получить одного пользователя User. Вы должны получать себя или быть суперпользователем или менеджером группы.

Параметры:

  • id

GET /api/user/current

Получить текущего пользователя User.

GET /api/user/recipients

Получить список пользователей Users. В списке будут только активные пользователи. Предназначен для не-администраторов, в отличие от GET /api/user.

  • Если видимость пользователей :all или пользователь является администратором, то в списке будут все пользователи.

  • Если видимость пользователей :group, то в списке будут только пользователи из той же группы, в которую входит пользователь (не считая группы “все пользователи”).

  • Если видимость пользователей :none или пользователь находится в песочнице, то в списке будет только сам пользователь.

POST /api/user/

Создать нового пользователя User. Возвращает 400, если адрес электронной почты уже занят.

Вы должны обладать правами суперпользователя, чтобы использовать этот метод.

Параметры:

  • first_name непустая строка или null.

  • last_name непустая строка или null.

  • email действительный адрес электронной почты.

  • user_group_memberships null или массив, каждый элемент которого - карта со схемой: ( is_group_manager (optional) : логическое значение. id : целое число больше нуля. )

  • login_attributes null или ключи атрибутов входа, должны быть ключевым словом или строкой.

POST /api/user/:id/send_invite

Повторно отправить электронное письмо с приглашением для данного пользователя.

Вы должны обладать правами суперпользователя, чтобы использовать этот метод.

Параметры:

  • id целое число больше нуля.

PUT /api/user/:id

Обновление существующего активного пользователя User. Сам пользователь или суперпользователь могут обновлять информацию пользователя и группы. Администраторы групп могут только добавлять/удалять пользователей из групп, которыми они управляют.

Параметры:

  • email null или действительный адрес электронной почты.

  • first_name непустая строка или null.

  • is_group_manager логическое значение, может быть пустым.

  • locale null или строка, являющаяся допустимым двухбуквенным кодом ISO или кодом страны, например, en или en_US.

  • user_group_memberships null или массив, каждый элемент которого - карта со схемой: ( is_group_manager (optional) : логическое значение. id : целое число больше нуля. )

  • id

  • is_superuser логическое значение, может быть пустым.

  • login_attributes null или ключи атрибутов входа, должны быть ключевым словом или строкой.

  • last_name непустая строка или null.

PUT /api/user/:id/modal/:modal

Указать, что пользователь был проинформирован о всех тонкостях «Конструктора запросов».

Параметры:

  • id

  • modal

PUT /api/user/:id/password

Обновить пароль пользователя.

Параметры:

  • id

  • password пароль.

  • old_password

  • request

PUT /api/user/:id/reactivate

Заново активировать пользователя с :id.

Вы должны обладать правами суперпользователя, чтобы использовать этот метод.

Параметры:

  • id

<< Назад к разделу API