Группа добавочных (/extension_group/)
Мы обновили документацию, актуальная версия страницы доступна по ссылке: Группа внутренних номеров (/extension_group/)
Ресурс позволяет управлять группами добавочных номеров клиента. Группы добавочных предназначены для объединения добавочных номеров клиента в группу, что позволяет:
- работать с рядом ресурсов (записи разговоров, голосовая почта, входящие факсы) на уровне групп. Например, можно получить список записей разговора для добавочных, находящихся в определенной группе;
- организовывать доступ к ресурсам добавочных с помощью создания пользователя типа "группа добавочных". Такой пользователь, в отличие пользователя типа "добавочный", может использовать ресурсы нескольких добавочных, но, в отличие от пользователя типа "клиент", ему доступны ресурсы только тех добавочных, которые находятся в его группе.
Описание структур данных
Имя | Тип | Описание |
---|---|---|
|
| Уникальный идентификатор группы добавочных |
|
| Имя группы добавочных |
client_id | integer | Идентификатор клиента, которому принадлежит группа |
Пример
Создадим группу добавочных
метод | ресурс | данные | ответ |
---|---|---|---|
POST | /client/@me/extension_group/ | { | { |
Поместим добавочный c идентификатором 30 в созданную группу
метод | ресурс | данные | ответ |
---|---|---|---|
PUT | /client/@me/extension/30 | { | { |
Поместим добавочный c идентификатором 28 в созданную группу
метод | ресурс | данные | ответ |
---|---|---|---|
PUT | /client/@me/extension/28 | { | { |
Получим список всех добавочных в данной группе
метод | ресурс | данные | ответ |
---|---|---|---|
GET | /extension_group/14/extension/ | [ |
Получим список записей разговоров добавочных в данной группе с 1-го по 21-е апреля 2016 года
метод | ресурс | данные | ответ |
---|---|---|---|
GET | /extension_group/14/record/?start_datetime=2016-04-01%2000%3A00%3A03&end_datetime=2016-04-21%2000%3A00%3A00 | [ |
Ресурсы раздела "Клиент"
POST /client/{client_id}/extension_group/
Добавить группу добавочных
Параметры URL
Имя | Тип |
---|---|
|
|
Параметры JSON
Имя | Тип | Обязательный |
---|---|---|
|
|
|
Поля ответа
Имя | Тип |
---|---|
|
|
|
|
|
|
GET /client/{client_id}/extension_group/
Получить список групп добавочных клиента
Параметры URL
Имя | Тип |
---|---|
|
|
Параметры запроса
Имя | Тип |
---|---|
|
|
|
|
Поля ответа
Имя | Тип |
---|---|
|
|
|
|
|
|
PUT /client/{client_id}/extension_group/{ext_group_id
}
Обновить группу добавочных
Параметры URL
Имя | Тип |
---|---|
|
|
|
|
Параметры JSON
Имя | Тип | Обязательный |
---|---|---|
|
|
|
Поля ответа
Имя | Тип |
---|---|
|
|
|
|
|
|
GET /client/{client_id}/extension_group/{ext_group_id
}
Получить группу добавочных
Параметры URL
Имя | Тип |
---|---|
|
|
|
|
Поля ответа
Имя | Тип |
---|---|
|
|
|
|
|
|
DELETE /client/{client_id}/extension_group/{ext_group_id
}
Удалить группу добавочных
Параметры URL
Имя | Тип |
---|---|
|
|
|
|
Ресурсы раздела "Группа добавочных"
GET /extension_group/{ext_group_id}/extension_group/
Получить группу добавочных
Параметры URL
Имя | Тип |
---|---|
|
|
Поля ответа
Имя | Тип |
---|---|
|
|
|
|
|
|
Похожие разделы