Звуковые файлы (/sound/)

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

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

Загрузка звуковых файлов

Поддерживаются звуковые файлы в форматах wav и mp3. Максимальный размер файла – 10 мегабайт.

Замена контента звукового файла

Замена контента звукового файла возможна с помощью ресурса

POST /client/{client_id}/sound/{sound_id}

_{Content-Type при загрузке файлов}
_{При загрузке файлов с помощью метода POST следует установить заголовок}_Content-Type_{в значение}_{multipart/form-data}_{с указанием параметра}_boundary_{, который содержит последовательность символов, разделяющую части тела запроса. Параметры звукового файла и сам файл передаются как поля формы. Во всех остальных методах, в том числе при обновлении информации о звуковом файле, следует использовать обычный}_{Content-Type: application/json}_{и передавать информацию в JSON-формате. Стоит отметить, что в большинстве случаев различные библиотеки для работы с веб-ресурсами генерируют тело запроса и заголовок}_Content-Type_{с параметром}_boundary_{автоматически.}

Описание полей запроса

Параметр	Тип	Обяза-тельный	Значение по умолчанию	Описание
title	string	да		Название звукового файла
file	file	да		Звуковой файл в формате wav или mp3. Максимальный размер файла – 10 мегабайт. Не поддерживаются wav-файлы с кодированием типа Float. Не поддерживаются wav-файлы, в которых нет информации о формате: кодировании, количестве каналов, битрейте, частоте и т.д.

В случае успешной загрузки файла возвращается ресурс "Звуковой файл", содержащий в том числе идентификатор звукового файла (поле id), который используется для указания звука в ресурсах очереди, голосового приветствия и т.п.

Пример

Загрузка звукового файла test_sound.wav c именем “Файл приветствия”.

Получение списка звуковых файлов

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

Описание полей

Параметр	Тип	Описание
id	integer	Идентификатор звукового файла
title	string	Название звукового файла
client_id	integer	Идентификатор клиента, владеющего звуковым файлом. Может иметь значение null, если звук не принадлежит клиенту
dealer_id	integer	Идентификатор дилера, владеющего звуковым файлом. Может иметь значение null, если звук не принадлежит дилеру клиента
filename	string	Системное имя файла, которое может быть использовано, в частности, для проигрывания звука через функцию голосового меню “Call Interactive”

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

POST /client/{client_id}/sound/

POST /client/{client_id}/sound/

Добавить звуковой файл

Параметры URL

Имя	Тип
client_id	string

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

Параметр

Тип

Описание

title

string

Название звукового файла, обязательный параметр

file

file

Звуковой файл в формате wav или mp3. Максимальный размер файла – 10 мегабайт. Обязательный параметр.
Не поддерживаются wav-файлы с кодированием типа Float. Не поддерживаются wav-файлы, в которых нет информации о формате: кодировании, количестве каналов, битрейте, частоте и т.д.

Поля ответа

Имя	Тип
dealer_id	long
id	long
client_id	long
title	string
filename	string

GET /client/{client_id}/sound/

GET /client/{client_id}/sound/

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

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

Имя	Тип
id	array [integer]
own_only	boolean
title	array [string]

Поля ответа

Имя	Тип
dealer_id	long
id	long
client_id	long
title	string
filename	string

POST /client/{client_id}/sound/{sound_id}

POST /client/{client_id}/sound/{sound_id}

Заменить контент звукового файла

Параметры URL

Имя	Тип
client_id	string
sound_id	integer

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

title	string	Название звукового файла, не обязательное поле, если не указан- сохранится старый title
file	file	Звуковой файл в формате wav или mp3. Максимальный размер файла – 10 мегабайт. Не поддерживаются wav-файлы с кодированием типа Float. Не поддерживаются wav-файлы, в которых нет информации о формате: кодировании, количестве каналов, битрейте, частоте и т.д.

Поля ответа

Имя	Тип
dealer_id	long
id	long
client_id	long
title	string
filename	string

PUT /client/{client_id}/sound/{sound_id}

PUT /client/{client_id}/sound/{sound_id}

Обновить информацию о звуковом файле

Параметры URL

Имя	Тип
client_id	string
sound_id	integer

Параметры JSON

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

Поля ответа

Имя	Тип
dealer_id	long
id	long
client_id	long
title	string
filename	string

GET /client/{client_id}/sound/{sound_id}

GET /client/{client_id}/sound/{sound_id}

Получить информацию о звуковом файле

Параметры URL

Имя	Тип
client_id	string
sound_id	integer

Поля ответа

Имя	Тип
dealer_id	long
id	long
client_id	long
title	string
filename	string

DELETE /client/{client_id}/sound/{sound_id}

DELETE /client/{client_id}/sound/{sound_id}

Удалить звуковой файл

Параметры URL

Имя	Тип
client_id	string
sound_id	integer

GET /client/{client_id}/sound/{sound_id}/download/

GET /client/{client_id}/sound/{sound_id}/download/

Получить звуковой файл

Параметры URL

Имя	Тип
client_id	string
sound_id	integer

Ресурсы раздела "Внутренний номер"

GET /extension/{extension_id}/sound/

GET /extension/{extension_id}/sound/

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

Параметры URL

Имя	Тип
extension_id	string

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

Имя	Тип
title	array [string]
id	array [integer]

Поля ответа

Имя	Тип
dealer_id	long
id	long
client_id	long
title	string
filename	string

GET /extension/{extension_id}/sound/{sound_id}/download/

GET /extension/{extension_id}/sound/{sound_id}/download/

Получить звуковой файл

Параметры URL

Имя	Тип
extension_id	string
sound_id	integer