Пользователь группы внутренних номеров (/user/extension_group/)

^{Протестировать методы API можно на странице}^{интерактивного обозревателя API}^{и без написания кода}
^{Некоторые ресурсы, описанные на странице, по умолчанию могут быть не доступны из-за типа приложения (см.}^{Создание и авторизация приложений}⁾

Данный ресурс предназначен для создания, удаления, а также для управления и уточнения параметров пользователя уровня группы внутренних номеров. Пользователь уровня группы внутренних номеров имеет доступ к настройкам и ресурсам конкретной группы внутренних номеров, а в зависимости от типа доступа (access type) имеет полный доступ (full) или доступ только для чтения (read_only) без права на какие-либо изменения в настройках.

1 Описание структур данных
2 Ресурсы раздела “Клиент”

Описание структур данных

Имя	Тип	Обяза-тельный	Описание

Имя	Тип	Обяза-тельный	Описание
comment	string	нет	Комментарий (заметка)
status	string	нет	Статус пользователя. Может быть: 'active' или 'blocked'
name	string	да	Имя пользователя
extension_group_id	integer	да	Идентификатор группы внутренних номеров, для которой создается пользователь
access	string	нет	Тип доступа к ресурсам. Может быть 'full' или 'read_only' (нет прав на изменения)
extra_params	string	нет	Поле для дополнительных параметров, можно приспособить для любых целей
timezone	string	нет	Пользовательская тайм-зона
login	string	да	Логин пользователя
password	string	да	Пароль пользователя
email	string	да	e-mail пользователя
email_notify	boolean	нет	Если параметр принимает значение ‘True’, тогда данные для доступа в систему для нового пользователя будут высланы на электронную почту: в случае задания параметра email_for_notify – на почту из email_for_notify; если параметр email_for_notify не задан – текущему пользователю (который создает)
email_for_notify	string	нет	Поле, необходимое для параметра email_notify – это e-mail, куда будут отправлены данные при создании нового пользователя

Ресурсы раздела “Клиент”

POST /client/{client_id}/user/extension_group/

Добавить нового пользователя уровня "Группа внутренних номеров"

Параметры URL

Имя	Тип

Имя	Тип
client_id	string

Параметры запроса

Имя	Тип

Имя	Тип
comment	string
status	string
name	string
extension_group_id	long
access	string
extra_params	string
timezone	string
login	string
password	string
email	string
email_notify	boolean

Параметры ответа

Имя	Тип

Имя	Тип
comment	string
status	string
name	string
extension_group_id	long
email	string
access	string
extra_params	string
timezone	string
login	string
id	long

GET /client/{client_id}/user/extension_group/

Получить список пользователей уровня "Группа внутренних номеров"

Параметры URL

Имя	Тип

Имя	Тип
client_id	string

Параметры запроса (фильтр)

Имя	Тип

Имя	Тип
comment	Array[string]
status	Array[string]
name	Array[string]
id	Array[integer]
access	Array[string]
extension_group_id	Array[integer]
timezone	Array[string]
login	Array[string]
email	Array[string]

Параметры ответа

Имя	Тип

Имя	Тип
comment	string
status	string
name	string
extension_group_id	long
email	string
access	string
extra_params	string
timezone	string
login	string
id	long

PUT /client/{client_id}/user/extension_group/{user_id}

Обновить пользователя уровня "Группа внутренних номеров"

Параметры URL

Имя	Тип

Имя	Тип
user_id	integer
client_id	string

Параметры запроса

Имя	Тип

Имя	Тип
comment	string
status	string
name	string
extension_group_id	long
access	string
extra_params	string
timezone	string
password	string
email	string

Параметры ответа

Имя	Тип

Имя	Тип
comment	string
status	string
name	string
extension_group_id	long
email	string
access	string
extra_params	string
timezone	string
login	string
id	long

GET /client/{client_id}/user/extension_group/{user_id}

Запросить параметры пользователя уровня "Группа внутренних номеров"

Параметры URL

Имя	Тип

Имя	Тип
user_id	integer
client_id	string

Параметры ответа

Имя	Тип

Имя	Тип
comment	string
status	string
name	string
extension_group_id	long
email	string
access	string
extra_params	string
timezone	string
login	string
id	long

DELETE /client/{client_id}/user/extension_group/{user_id}

Удалить пользователя уровня "Группа внутренних номеров"

Параметры URL

Имя	Тип

Имя	Тип
user_id	integer
client_id	string