Музыка

Эндпоинты для работы с музыкой, плейлистами и историей прослушивания.

GET /v1/music Public

Получить список песен с пагинацией.

Параметры:
Параметр Тип Описание
limit integer Количество записей (по умолчанию 20)
offset integer Сдвиг для пагинации
Пример запроса:
curl -X GET "https://api.neoswift.site/v1/music?limit=10"
GET /v1/music/{id} Public

Получить информацию о песне по ID.

Пример запроса:
curl -X GET "https://api.neoswift.site/v1/music/1"
GET /v1/music/popular Public

Получить список популярных песен.

Пример запроса:
curl -X GET "https://api.neoswift.site/v1/music/popular"
POST /v1/music/play Protected

Записать прослушивание песни (увеличивает счетчик и добавляет в историю).

Параметры:
Параметр Тип Описание
song_id integer ID песни
Пример запроса:
curl -X POST "https://api.neoswift.site/v1/music/play" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"song_id": 1}'
GET /v1/music/playlists Protected

Получить список плейлистов пользователя.

Пример запроса:
curl -X GET "https://api.neoswift.site/v1/music/playlists" \
  -H "Authorization: Bearer YOUR_TOKEN"
POST /v1/music/playlists Protected

Создать новый плейлист.

Параметры:
Параметр Тип Описание
name string Название плейлиста
Пример запроса:
curl -X POST "https://api.neoswift.site/v1/music/playlists" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Мой плейлист"}'
POST /v1/music/add-to-playlist Protected

Добавить песню в плейлист.

Параметры:
Параметр Тип Описание
playlist_id integer ID плейлиста
song_id integer ID песни
Пример запроса:
curl -X POST "https://api.neoswift.site/v1/music/add-to-playlist" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"playlist_id": 1, "song_id": 1}'