Upload
Метод Upload
Примените этот метод для загрузки аудиофайла к приложению. Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.
Точка подключения:
POST: https://api.exolve.ru/media/v1/Upload
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
Параметр | Тип | Описание |
---|---|---|
file | bytes (Base64) | аудиофайл |
full_name | string | имя файла |
file_type | enum FileType | тип аудиофайла |
FileType
Значение | ID | Описание |
---|---|---|
FILE_TYPE_IVR | 200 | IVR (интерактивное голосовое меню) |
FILE_TYPE_PREMEDIA | 201 | премедиа (аудиосообщение, которое воспроизводится клиенту до ответа оператора) |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
file_id | uint64 | внутренний ID аудиофайла |
resource_id | uint64 | уникальный идентификатор ресурса загруженного аудиофайла |
size | uint64 | размер аудиофайла в байтах |
duration | uint32 | длительность аудиофайла в секундах |
name | string | имя файла |
extension | string | расширение aудиофайла |
description | string | описание к аудиофайлу |
application_uuid | string | уникальный идентификатор приложения, к которому загружен аудиофайл |
file_type | enum FileType | тип аудиофайла |
date_upload | RFC-3339 / ISO-8601 | дата загрузки аудиофайла |
Примеры
Входные параметры:
{
"file": "SUQzAwAAAAAfdlRZRVIAAAAFAAAAMjAyMVRJVDIAAABHAAAB//4TBDgEQgQwBEAEMAQgADwENQQ7BD4ENAQ4BE8EIABABD4EO",
"file_type": "FILE_TYPE_PREMEDIA",
"full_name": "test.mp3"
}
Выходные параметры:
{
"fileId": "1864178824816623616",
"resourceId": "789360",
"size": "25747",
"duration": 1,
"name": "qq12",
"extension": "mp3",
"applicationUuid": "0356dc59-deeb-4546-b314-fbc31bd778fc",
"fileType": "FILE_TYPE_PREMEDIA",
"dateUpload": "2022-12-12T02:41:06.604854519Z"
}