Download
Метод Download
Примените этот метод для получения загруженного файла по идентификатору ресурса. Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.
Точка подключения:
POST: https://api.exolve.ru/media/v1/Download
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
Параметр | Тип | Описание |
---|---|---|
resource_id | uint64 | уникальный идентификатор ресурса загруженного аудиофайла |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
file | bytes | аудиофайл |
full_name | string | полное имя аудиофайла |
resource_id | uint64 | уникальный идентификатор ресурса загруженного аудиофайла |
file_type | enum FileType | тип аудиофайла |
FileType
Значение | ID | Описание |
---|---|---|
FILE_TYPE_IVR | 200 | IVR (интерактивное голосовое меню) |
FILE_TYPE_PREMEDIA | 201 | премедиа (аудиосообщение, которое воспроизводится клиенту до ответа оператора) |
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
401 | Unauthorized | malformed token | не указан / не правильно указан API-ключ приложения |
500 | Internal Server Error | Application [ID] does not own resource [661352] | файл принадлежит другому приложению |
Примеры
Входные параметры:
{
"resource_id": "6088"
}
Выходные параметры:
{
"file": "SUQzAwAAAAAfdlRZRVIAAAAFAAAAMjAyMVRJVDIAAABHAAAB//4TB",
"full_name": "19999tgb.mp3",
"resource_id": "6088",
"file_type": 201
}