Музыка
Методы для работы с аудиозаписями, плейлистами, загрузкой и управлением музыкой
GET
audio.get
Получение списка аудиозаписей пользователя или группы.
Параметры:
owner_id
*
— ID владельца (положительный - пользователь, отрицательный - группа)
count
— Количество аудиозаписей (макс. 100)
offset
— Смещение для постраничной навигации
Пример:
GET /method/audio.get.json?owner_id=1&count=20
Ответ:
{
"count": 150,
"items": [{
"id": 123456,
"owner_id": 1,
"artist": "Исполнитель",
"title": "Название трека",
"duration": 180,
"url": "https://...",
"lyrics_id": 789,
"genre_id": 1,
"date": 1609459200,
"album": {
"id": 123,
"title": "Название альбома",
"owner_id": 1
}
}]
}
POST
audio.add
Добавление аудиозаписи в свою коллекцию.
Параметры:
audio_id
*
— ID аудиозаписи
owner_id
— ID владельца аудиозаписи
Пример:
POST /method/audio.add.json?audio_id=123456
Ответ:
1 // Успешно
POST
audio.delete
Удаление аудиозаписи из своей коллекции.
Параметры:
audio_id
*
— ID аудиозаписи
owner_id
— ID владельца аудиозаписи
Пример:
POST /method/audio.delete.json?audio_id=123456
GET
audio.search
Поиск аудиозаписей по запросу.
Параметры:
q
*
— Поисковый запрос
count
— Количество результатов (макс. 300)
offset
— Смещение
genre
— ID жанра
sort
— Сортировка (2 - по популярности)
Пример:
GET /method/audio.search.json?q=Queen&count=50
Ответ:
{
"count": 150,
"items": [{
"id": 123456,
"owner_id": 1,
"artist": "Queen",
"title": "Bohemian Rhapsody",
"duration": 355,
"url": "https://...",
"genre_id": 1
}]
}
GET
audio.getPlaylists
Получение списка плейлистов пользователя или группы.
Параметры:
owner_id
*
— ID владельца плейлистов
count
— Количество плейлистов (макс. 50)
offset
— Смещение
Пример:
GET /method/audio.getPlaylists.json?owner_id=1&count=20
Ответ:
{
"count": 5,
"items": [{
"id": 123,
"owner_id": 1,
"title": "Мой плейлист",
"description": "Описание плейлиста",
"count": 25,
"photo": {
"photo_300": "https://...",
"photo_600": "https://..."
}
}]
}
POST
audio.createPlaylist
Создание нового плейлиста.
Параметры:
title
*
— Название плейлиста
description
— Описание плейлиста
audio_ids
— ID аудиозаписей через запятую
group_id
— ID группы для создания плейлиста группы
Пример:
POST /method/audio.createPlaylist.json?title=Моя музыка&audio_ids=123,456,789
Ответ:
{
"playlist_id": 123,
"owner_id": 1
}
POST
audio.edit
Редактирование информации об аудиозаписи.
Параметры:
audio_id
*
— ID аудиозаписи
artist
— Новый исполнитель
title
— Новое название
text
— Текст песни
genre_id
— ID жанра
Пример:
POST /method/audio.edit.json?audio_id=123456&artist=Новый исполнитель&title=Новое название
🎵 Обложки треков
Загрузка обложки: При загрузке аудиозаписи можно прикрепить изображение обложки через параметр
cover (multipart/form-data)
Изменение обложки: Используйте
audio.edit с новым файлом обложки
Форматы: Поддерживаются JPG, PNG, GIF (макс. размер 10MB)
Размеры: Рекомендуется квадратное изображение 500x500px или больше
