- Document all exported types, functions, methods, and constants across 52 files - Add package-level doc comments to client, models, utils, and ynison packages - Document HTTP method and endpoint path for each API client method - Document model struct fields and DeJSON/DeList/ToJSON/ToMap methods - Fix duplicate package doc comment in internal/models/base.go Co-Authored-By: Claude Code <noreply@anthropic.com>
142 lines
4.4 KiB
Go
142 lines
4.4 KiB
Go
// Package client provides methods for interacting with Yandex Music API endpoints.
|
|
package client
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
|
|
"gitea.mrixs.me/Mrixs/yandex-music-api-go/internal/models"
|
|
)
|
|
|
|
// LikeTrack likes a track (POST /users/me/likes/tracks/add-multiple).
|
|
func (c *Client) LikeTrack(ctx context.Context, trackID string) error {
|
|
params := map[string]string{
|
|
"track-ids": trackID,
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/tracks/add-multiple", params, &result)
|
|
}
|
|
|
|
// UnlikeTrack unlikes a track (POST /users/me/likes/tracks/remove).
|
|
func (c *Client) UnlikeTrack(ctx context.Context, trackID string) error {
|
|
params := map[string]string{
|
|
"track-ids": trackID,
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/tracks/remove", params, &result)
|
|
}
|
|
|
|
// LikeAlbum likes an album (POST /users/me/likes/albums/add-multiple).
|
|
func (c *Client) LikeAlbum(ctx context.Context, albumID string) error {
|
|
params := map[string]string{
|
|
"album-ids": albumID,
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/albums/add-multiple", params, &result)
|
|
}
|
|
|
|
// UnlikeAlbum unlikes an album (POST /users/me/likes/albums/remove).
|
|
func (c *Client) UnlikeAlbum(ctx context.Context, albumID string) error {
|
|
params := map[string]string{
|
|
"album-ids": albumID,
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/albums/remove", params, &result)
|
|
}
|
|
|
|
// LikeArtist likes an artist (POST /users/me/likes/artists/add-multiple).
|
|
func (c *Client) LikeArtist(ctx context.Context, artistID string) error {
|
|
params := map[string]string{
|
|
"artist-ids": artistID,
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/artists/add-multiple", params, &result)
|
|
}
|
|
|
|
// UnlikeArtist unlikes an artist (POST /users/me/likes/artists/remove).
|
|
func (c *Client) UnlikeArtist(ctx context.Context, artistID string) error {
|
|
params := map[string]string{
|
|
"artist-ids": artistID,
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/artists/remove", params, &result)
|
|
}
|
|
|
|
// LikePlaylist likes a playlist (POST /users/me/likes/playlists/add-multiple).
|
|
func (c *Client) LikePlaylist(ctx context.Context, kind int) error {
|
|
params := map[string]string{
|
|
"playlist-ids": fmt.Sprintf("%d", kind),
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/playlists/add-multiple", params, &result)
|
|
}
|
|
|
|
// UnlikePlaylist unlikes a playlist (POST /users/me/likes/playlists/remove).
|
|
func (c *Client) UnlikePlaylist(ctx context.Context, kind int) error {
|
|
params := map[string]string{
|
|
"playlist-ids": fmt.Sprintf("%d", kind),
|
|
}
|
|
var result map[string]any
|
|
return c.request.Post(ctx, "/users/me/likes/playlists/remove", params, &result)
|
|
}
|
|
|
|
// GetLikedTracks gets the user's liked tracks (GET /users/me/likes/tracks).
|
|
func (c *Client) GetLikedTracks(ctx context.Context) ([]*models.Track, error) {
|
|
var result []models.Track
|
|
if err := c.request.Get(ctx, "/users/me/likes/tracks", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
tracks := make([]*models.Track, len(result))
|
|
for i := range result {
|
|
result[i].SetClient(c)
|
|
tracks[i] = &result[i]
|
|
}
|
|
return tracks, nil
|
|
}
|
|
|
|
// GetLikedAlbums gets the user's liked albums (GET /users/me/likes/albums).
|
|
func (c *Client) GetLikedAlbums(ctx context.Context) ([]*models.Album, error) {
|
|
var result []models.Album
|
|
if err := c.request.Get(ctx, "/users/me/likes/albums", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
albums := make([]*models.Album, len(result))
|
|
for i := range result {
|
|
result[i].SetClient(c)
|
|
albums[i] = &result[i]
|
|
}
|
|
return albums, nil
|
|
}
|
|
|
|
// GetLikedArtists gets the user's liked artists (GET /users/me/likes/artists).
|
|
func (c *Client) GetLikedArtists(ctx context.Context) ([]*models.Artist, error) {
|
|
var result []models.Artist
|
|
if err := c.request.Get(ctx, "/users/me/likes/artists", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
artists := make([]*models.Artist, len(result))
|
|
for i := range result {
|
|
result[i].SetClient(c)
|
|
artists[i] = &result[i]
|
|
}
|
|
return artists, nil
|
|
}
|
|
|
|
// GetLikedPlaylists gets the user's liked playlists (GET /users/me/likes/playlists).
|
|
func (c *Client) GetLikedPlaylists(ctx context.Context) ([]*models.Playlist, error) {
|
|
var result []models.Playlist
|
|
if err := c.request.Get(ctx, "/users/me/likes/playlists", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
playlists := make([]*models.Playlist, len(result))
|
|
for i := range result {
|
|
result[i].SetClient(c)
|
|
playlists[i] = &result[i]
|
|
}
|
|
return playlists, nil
|
|
}
|