Ресурс записи разговоров позволяет получить список доступных записей разговора клиента или добавочного за определенный период, получить непосредственно файлы записи, а также удалить записи в диапазоне или поштучно.
Получение списка записей разговора
Интервал получения и удаления списка указывается параметрами запроса start_datetime и end_datetime. Интервал времени должен находится в пределах одного месяца. Для получения данных за больший период следует делать несколько запросов.
При получении списка возможно указать параметр запроса order, который задает направление, в котором результирующий список будет отсортирован по полю init_time_gmt.
Параметры запроса
Имя | Тип | Обязательный | Значение по умолчанию |
|---|---|---|---|
| YYYY-MM-DD HH:MM:SS | да | |
| YYYY-MM-DD HH:MM:SS | да | |
|
| нет | desc |
Поля записей разговора
Поля ресурса "Запись разговора" совпадают с полями ресурса CDR, но в отличие от CDR, поля record_uuid и record_file_size никогда не принимают значения null.
Имя | Тип | Описание |
|---|---|---|
|
| Идентификатор клиента-владельца записи |
|
| Идентификатор дилера-владельца записи |
|
| Домен назначения вызова |
|
| Номер назначения вызова |
|
| Домен внешнего номера |
|
| Внешний номер |
|
| Длительность вызова |
|
| Зарегистрированный внешний номер |
|
| Идентификатор группы добавочных, владеющей записью |
|
| Идентификатор добавочного |
|
| Имя добавочного |
|
| Тип добавочного |
|
| Направление вызова. Может принимать значение "in" или "out" |
|
| Исходный домен звонящего |
|
| Исходное отображаемое имя звонящего |
|
| Исходное имя пользователя звонящего |
|
| Причина окончания вызова |
|
| Время окончания вызова |
|
| Время инициализации вызова |
|
| Размер файла записи в байтах |
|
| Идентификатор записи разговора |
|
| Результат вызова |
|
| Домен источника вызова |
|
| Номер источника вызова |
|
| Время начала вызова |
|
| Исходный домен назначения |
|
| Исходный имя пользователя назначения |
Получение статистики записей разговора
Параметры запроса
Имя | Тип | Обязательный | Значение по умолчанию |
|---|---|---|---|
| YYYY-MM-DD HH:MM:SS | да | |
| YYYY-MM-DD HH:MM:SS | да |
Поля статистики записей разговора
Имя | Тип | Описание |
|---|---|---|
|
| Суммарный размер файлов записей |
|
| Количество файлов записей |
Получение файлов записей разговора
Для непосредственного получения файла записи разговора нужно совершить GET-запрос на соответствующий нужному уровню пользователя ресурс, указав идентификатор записи:
GET /client/{client_id}/record/{record_uuid}
GET /extension_group/{ext_group_id}/record/{record_uuid}
GET /extension/{extension_id}/record/{record_uuid}
Данные файла записи будут возвращены в теле запроса, имя файла содержится в заголовке Content-Disposition.
Пример
Запрос: GET /api/ver1.0/client/12/record/30-7FD1F974054E11E68FD30968F8BBCB45 HTTP/1.1 User-Agent: Wget/1.15 (linux-gnu) Accept: */* Host: host.domain Connection: Keep-Alive Authorization: Bearer token Ответ: HTTP/1.0 200 OK Content-Length: 1008 Content-Disposition: attachment; filename=2016-04-18-13-13-47_outbound_0000000000_300.mp3 Server: nginx/1.8.1 Date: Tue, 19 Apr 2016 11:56:19 GMT Content-Type: audio/mpeg
Получение файлов через базовую HTTP-аутентификацию
Существует возможность получить доступ к файлам записей разговоров, используя базовую HTTP-аутентификацию, вместо передачи OAuth2-токена.
Подробнее этот способ описан в разделе Получение файлов через базовую HTTP-аутентификацию.
Ресурсы раздела "Клиент"
GET /client/{client_id}/record/
Получить список записей разговора клиента в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DELETE /client/{client_id}/record/
Удалить записи разговора клиента в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
GET /client/{client_id}/record/stats/
Получить статистику по записям разговора в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
GET /client/{client_id}/record/{record_uuid}
Получить файл записи разговора
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
DELETE /client/{client_id}/record/{record_uuid}
Удалить запись разговора
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Ресурсы раздела "Группа добавочных"
GET /extension_group/{ext_group_id}/record/
Получить список записей разговора группы добавочных в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GET /extension_group/{ext_group_id}/record/stats/
Получить статистику по записям разговора в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
GET /extension_group/{ext_group_id}/record/{record_uuid}
Получить файл записи разговора
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Ресурсы раздела "Добавочный"
GET /extension/{extension_id}/record/
Получить список записей разговора добавочного в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DELETE /extension/{extension_id}/record/
Удалить записи разговора добавочного в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
GET /extension/{extension_id}/record/stats/
Получить статистику по записям разговора добавочного в интервале
Параметры URL
Имя | Тип |
|---|---|
|
|
Параметры запроса
Имя | Тип |
|---|---|
|
|
|
|
Поля ответа
Имя | Тип |
|---|---|
|
|
|
|
GET /extension/{extension_id}/record/{record_uuid}
Получить файл записи разговора
Параметры URL
Имя | Тип |
|---|---|
|
|
|
|
Похожие разделы