GetInfo

Метод GetInfo

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

Точка подключения:

POST: https://api.exolve.ru/media/v1/GetInfo

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Имя Тип Описание
Authorization string API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

Входные параметры

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

Параметр Тип Описание
resource_ids Array of uint64 уникальные идентификаторы загруженных аудиофайлов

Выходные параметры

Параметр Тип Описание
media_records array список с информацией об аудиофайлах
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 string дата загрузки аудиофайла в формате RFC-3339 / ISO-8601

FileType

Значение ID Описание
FILE_TYPE_IVR 200 IVR (интерактивное голосовое меню)
FILE_TYPE_PREMEDIA 201 премедиа (аудиосообщение, которое воспроизводится клиенту до ответа оператора)

Возможные ошибки

Код Статус Пример сообщения Описание
401 Unauthorized malformed token не указан / не правильно указан API-ключ приложения
400 Bad Request proto: syntax error (line 3:9): invalid character ‘\r’ in string синтаксическая ошибка

Примеры

Входные параметры:

{
    "resource_ids": [
        "138517",
        "152817"
    ]
}

Выходные параметры:

{
    "media_records": [
        {
            "file_id": "1885716233567862784",
            "resource_id": "138517",
            "size": "26375",
            "duration": 3,
            "name": "Test audio",
            "extension": "mp3",
            "description": "Тестовый аудиофайл",
            "application_uuid": "178ec145-6898-4b06-a92a-75f63cb57046",
            "application_name": "Test",
            "file_type": 201,
            "date_upload": "2023-02-09T13:03:04.996514Z"
        },
        {
            "file_id": "1931072746905665536",
            "resource_id": "152817",
            "size": "121087",
            "duration": 5,
            "name": "test5",
            "extension": "mp3",
            "description": "",
            "application_uuid": "178ec145-6898-4b06-a92a-75f63cb57046",
            "application_name": "Test",
            "file_type": 201,
            "date_upload": "2023-06-14T16:53:40.459735Z"
        }
    ]
}

Содержание статьи