Ресурс записи разговоров позволяет получить список доступных записей разговора клиента или добавочного за определенный период, получить непосредственно файлы записи, а также удалить записи в диапазоне или поштучно.

Получение списка записей разговора

Интервал получения и удаления списка указывается параметрами запроса start_datetime и end_datetime. Дата и время, содержащиеся в параметре end_datetime не должны превышать последний день следующего за start_datetime месяца. Для получения данных за больший период следует делать несколько запросов.

При получении списка возможно указать параметр запроса order, который задает направление, в котором результирующий список будет отсортирован по полю init_time_gmt.

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

Имя	Тип	Обязательный	Значение по умолчанию
`start_datetime`	YYYY-MM-DD HH:MM:SS	да
`end_datetime`	YYYY-MM-DD HH:MM:SS	да
`order`	`asc or desc`	нет	`desc`

Поля записей разговора

Поля ресурса "Запись разговора" совпадают с полями ресурса CDR, но в отличие от CDR, поля record_uuid и record_file_size никогда не принимают значения null.

Имя	Тип	Описание
`client_owner_id`	`integer`	Идентификатор клиента-владельца записи
`dealer_owner_id`	`integer`	Идентификатор дилера-владельца записи
`dest_domain`	`string`	Домен назначения вызова
`dest_number`	`string`	Номер назначения вызова
`did_domain`	`string`	Домен внешнего номера
`did_number`	`string`	Внешний номер
`duration`	`integer`	Длительность вызова
`ext_number_reg`	`string`	Зарегистрированный внешний номер
`extension_group_owner_id`	`integer`	Идентификатор группы добавочных, владеющей записью
`extension_id`	`integer`	Идентификатор добавочного
`extension_name`	`string`	Имя добавочного
`extension_type`	`string`	Тип добавочного
`flow`	`string`	Направление вызова. Может принимать значение "in" или "out"
`from_domain`	`string`	Исходный домен звонящего
`from_screen_name`	`string`	Исходное отображаемое имя звонящего
`from_username`	`string`	Исходное имя пользователя звонящего
`hangup_cause`	`string`	Причина окончания вызова
`hangup_time_gmt`	`string`	Время окончания вызова
`init_time_gmt`	`string`	Время инициализации вызова
`record_file_size`	`integer`	Размер файла записи в байтах
`record_uuid`	`string`	Идентификатор записи разговора
`result`	`string`	Результат вызова
`source_domain`	`string`	Домен источника вызова
`source_number`	`string`	Номер источника вызова
`start_time_gmt`	`string`	Время начала вызова
`to_domain`	`string`	Исходный домен назначения
`to_username`	`string`	Исходный имя пользователя назначения

Получение статистики записей разговора

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

Имя	Тип	Обязательный	Значение по умолчанию
`start_datetime`	YYYY-MM-DD HH:MM:SS	да
`end_datetime`	YYYY-MM-DD HH:MM:SS	да

Поля статистики записей разговора

Имя	Тип	Описание
`files_size`	`integer`	Суммарный размер файлов записей
`records_count`	`integer`	Количество файлов записей

Получение файлов записей разговора

Для непосредственного получения файла записи разговора нужно совершить 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/{record_uuid}/storage_url/

В ответ API вернёт URL для получения записи из хранилища. Получение записи из хранилища не требует аутентификации. Ссылка является постоянной. Пример:

Запрос:

GET https://hostname/api/ver1.0/client/@me/record/30-624835FEEE0E11E6A19D331E4D6A0606/storage_url/

Ответ:

{

"record_url": "http://storage.hostname.ru/bd7zzrXD5395gn7FMgzKtB8zhZnNoYx8BdkX_HgNdeE2lnJjPMLcOR_1hQprGf-dW94wuTCNRAY6MDjMZ0zWIg=="

}

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

`GET /client/{client_id}/record/`

Получить список записей разговора клиента в интервале

Параметры URL

Имя	Тип
`client_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`
`order`	`string`

Поля ответа

Имя	Тип
`client_owner_id`	`integer`
`dealer_owner_id`	`integer`
`dest_domain`	`string`
`dest_number`	`string`
`did_domain`	`string`
`did_number`	`string`
`duration`	`integer`
`ext_number_reg`	`string`
`extension_group_owner_id`	`integer`
`extension_id`	`integer`
`extension_name`	`string`
`extension_type`	`string`
`flow`	`string`
`from_domain`	`string`
`from_screen_name`	`string`
`from_username`	`string`
`hangup_cause`	`string`
`hangup_time_gmt`	`string`
`init_time_gmt`	`string`
`record_file_size`	`integer`
`record_uuid`	`string`
`result`	`string`
`source_domain`	`string`
`source_number`	`string`
`start_time_gmt`	`string`
`to_domain`	`string`
`to_username`	`string`

`DELETE /client/{client_id}/record/`

Удалить записи разговора клиента в интервале

Параметры URL

Имя	Тип
`client_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`

`GET /client/{client_id}/record/stats/`

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

Параметры URL

Имя	Тип
`client_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`

Поля ответа

Имя	Тип
`files_size`	`integer`
`records_count`	`integer`

`GET /client/{client_id}/record/{record_uuid`}

Получить файл записи разговора

Параметры URL

Имя	Тип
`record_uuid`	`string`
`client_id`	`string`

`DELETE /client/{client_id}/record/{record_uuid`}

Удалить запись разговора

Параметры URL

Имя	Тип
`record_uuid`	`string`
`client_id`	`string`

Ресурсы раздела "Группа добавочных"

`GET /extension_group/{ext_group_id}/record/`

Получить список записей разговора группы добавочных в интервале

Параметры URL

Имя	Тип
`ext_group_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`
`order`	`string`

Поля ответа

Имя	Тип
`to_username`	`string`
`source_number`	`string`
`result`	`string`
`duration`	`integer`
`hangup_time_gmt`	`string`
`dealer_owner_id`	`integer`
`to_domain`	`string`
`record_file_size`	`integer`
`from_username`	`string`
`start_time_gmt`	`string`
`ext_number_reg`	`string`
`hangup_cause`	`string`
`extension_group_owner_id`	`integer`
`init_time_gmt`	`string`
`dest_domain`	`string`
`record_uuid`	`string`
`from_domain`	`string`
`source_domain`	`string`
`extension_type`	`string`
`did_domain`	`string`
`from_screen_name`	`string`
`extension_name`	`string`
`flow`	`string`
`dest_number`	`string`
`extension_id`	`integer`
`did_number`	`string`
`client_owner_id`	`integer`

`GET /extension_group/{ext_group_id}/record/stats/`

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

Параметры URL

Имя	Тип
`ext_group_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`

Поля ответа

Имя	Тип
`files_size`	`integer`
`records_count`	`integer`

`GET /extension_group/{ext_group_id}/record/{record_uuid`}

Получить файл записи разговора

Параметры URL

Имя	Тип
`record_uuid`	`string`
`ext_group_id`	`string`

Ресурсы раздела "Добавочный"

`GET /extension/{extension_id}/record/`

Получить список записей разговора добавочного в интервале

Параметры URL

Имя	Тип
`extension_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`order`	`string`
`end_datetime`	`string`

Поля ответа

Имя	Тип
`to_username`	`string`
`source_number`	`string`
`result`	`string`
`duration`	`integer`
`hangup_time_gmt`	`string`
`dealer_owner_id`	`integer`
`to_domain`	`string`
`record_file_size`	`integer`
`from_username`	`string`
`start_time_gmt`	`string`
`ext_number_reg`	`string`
`hangup_cause`	`string`
`extension_group_owner_id`	`integer`
`init_time_gmt`	`string`
`dest_domain`	`string`
`record_uuid`	`string`
`from_domain`	`string`
`source_domain`	`string`
`extension_type`	`string`
`did_domain`	`string`
`from_screen_name`	`string`
`extension_name`	`string`
`flow`	`string`
`dest_number`	`string`
`extension_id`	`integer`
`did_number`	`string`
`client_owner_id`	`integer`

`DELETE /extension/{extension_id}/record/`

Удалить записи разговора добавочного в интервале

Параметры URL

Имя	Тип
`extension_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`

`GET /extension/{extension_id}/record/stats/`

Получить статистику по записям разговора добавочного в интервале

Параметры URL

Имя	Тип
`extension_id`	`string`

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

Имя	Тип
`start_datetime`	`string`
`end_datetime`	`string`

Поля ответа

Имя	Тип
`files_size`	`integer`
`records_count`	`integer`

`GET /extension/{extension_id}/record/{record_uuid`}

Получить файл записи разговора

Параметры URL

Имя	Тип
`record_uuid`	`string`
`extension_id`	`string`

Записи разговоров (/record/)

Получение списка записей разговора

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

Поля записей разговора

Получение статистики записей разговора

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

Поля статистики записей разговора

Получение файлов записей разговора

Пример

Получение файлов через базовую 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

Похожие разделы

`GET /client/{client_id}/record/`

`DELETE /client/{client_id}/record/`

`GET /client/{client_id}/record/stats/`

`GET /client/{client_id}/record/{record_uuid`}

`DELETE /client/{client_id}/record/{record_uuid`}

`GET /extension_group/{ext_group_id}/record/`

`GET /extension_group/{ext_group_id}/record/stats/`

`GET /extension_group/{ext_group_id}/record/{record_uuid`}

`GET /extension/{extension_id}/record/`

`DELETE /extension/{extension_id}/record/`

`GET /extension/{extension_id}/record/stats/`

`GET /extension/{extension_id}/record/{record_uuid`}