Метод 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 | аудиофайл в формате Base64 |
| full_name | string | название аудиофайла |
| resource_id | uint64 | идентификатор ресурса аудиофайла |
| file_type | enum FileType | тип аудиофайла |
FileType
| Параметр | Тип | Эмоция |
|---|---|---|
| 201 | enum | аудиофайл, загруженный из локального хранилища в библиотеку приложения |
Возможные ошибки
| Код | Статус | Пример сообщения | Описание |
|---|---|---|---|
| 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
}