Медиафайлы

Получение списка медиафайлов

Метод	get.media_files
Описание	Получение списка медиафайлов
Кому доступен	Агент, Клиент

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

Название	Тип	Обязательный	Описание
access_token	string	да	Ключ сессии аутентификации
user_id	number	нет	Уникальный идентификатор пользователя клиента агента от имени которого делается запрос Является обязательным для агента Для получения списка пользователей клиента необходимо использовать метод "get.customer_users"
limit	number	нет	Количество возвращаемых записей. См. раздел Постраничный вывод
offset	number	нет	Сдвиг, определяет с какого номера записи возвращать limit записей. По умолчанию 0. См. раздел Постраничный вывод
filter	object	нет	См. раздел Критерии фильтрации
fields	array	нет	См. раздел Представление возвращаемых данных
sort	array	нет	См. раздел Сортировка данных

Параметры Ответа

Название	Тип	Допустимые значения	Фильтрация	Сортировка	Описание
id	number		Да	Да	ID медиафайла
name	string		Да	Да	Название медиафайла. Уникально в рамках одного клиента.
duration	number		Да	Да	Длительность медиафайла в секундах
play_link	string				Ссылка для прослушивания медиафайла
normalization	boolean		Да	Да	Нормализация медиафайла.
size	number		Да	Да	Размер медиафайла в байтах
type	enum	system user	Да	Да	system - системные медиа файлы (запрещены к редактированию); user - пользовательские медиа файлы;

JSON структура запроса

{
  "jsonrpc":"2.0",
  "id":"number",
  "method":"get.media_files",
  "params":{
    "access_token":"string",
    "user_id":"number",
    "offset":"number",
    "limit":"number",
    "filter":{

    },
    "sort":[
      {
        "field":"string",
        "order":"string"
      }
    ],
    "fields":[
      "string"
    ]
  }
}

JSON структура ответа

{
  "id": "number",
  "jsonrpc": "2.0",
  "result": {
    "data": [
      {
        "id": "number",
        "name": "string",
        "duration": "number",
        "play_link": "string",
        "normalization": "boolean",
        "size": "number",
        "type" : "enum"

      }
    ],
    "metadata": {
    }
  }
}

Список возвращаемых ошибок

Смотрим раздел "Список ошибок для методов с глаголом get"