MrixsandClaude Code
0456ca0665
- 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>
91 lines
3.0 KiB
Go
91 lines
3.0 KiB
Go
// Package client provides methods for interacting with Yandex Music API endpoints.
|
|
package client
|
|
|
|
import (
|
|
"context"
|
|
|
|
"gitea.mrixs.me/Mrixs/yandex-music-api-go/internal/models"
|
|
)
|
|
|
|
// GetAccountSettings gets account settings (current user's settings from /account/settings).
|
|
func (c *Client) GetAccountSettings(ctx context.Context) (*models.UserSettings, error) {
|
|
var result models.UserSettings
|
|
if err := c.request.Get(ctx, "/account/settings", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// UpdateAccountSettings updates account settings (PUT /account/settings).
|
|
func (c *Client) UpdateAccountSettings(ctx context.Context, settings *models.AccountSettings) (*models.AccountSettings, error) {
|
|
var result models.AccountSettings
|
|
if err := c.request.Put(ctx, "/account/settings", settings, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// GetSubscription gets user subscription info (GET /account/subscription).
|
|
func (c *Client) GetSubscription(ctx context.Context) (*models.Subscription, error) {
|
|
var result models.Subscription
|
|
if err := c.request.Get(ctx, "/account/subscription", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// GetPlusInfo gets Plus subscription info (GET /account/plus).
|
|
func (c *Client) GetPlusInfo(ctx context.Context) (*models.PlusInfo, error) {
|
|
var result models.PlusInfo
|
|
if err := c.request.Get(ctx, "/account/plus", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// GetPromoCodeStatus gets promo code status (GET /promo-code-status).
|
|
func (c *Client) GetPromoCodeStatus(ctx context.Context, code string) (*models.PromoCodeStatus, error) {
|
|
params := map[string]string{
|
|
"code": code,
|
|
}
|
|
var result models.PromoCodeStatus
|
|
if err := c.request.Get(ctx, "/promo-code-status", params, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// ActivatePromoCode activates a promo code (POST /promo-code/activate).
|
|
func (c *Client) ActivatePromoCode(ctx context.Context, code string) (*models.PromoCodeStatus, error) {
|
|
params := map[string]string{
|
|
"code": code,
|
|
}
|
|
var result models.PromoCodeStatus
|
|
if err := c.request.Post(ctx, "/promo-code/activate", params, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// GetUserSettings gets user settings for a specific user (GET /user/settings).
|
|
func (c *Client) GetUserSettings(ctx context.Context, userID string) (*models.UserSettings, error) {
|
|
params := map[string]string{
|
|
"user_id": userID,
|
|
}
|
|
var result models.UserSettings
|
|
if err := c.request.Get(ctx, "/user/settings", params, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|
|
|
|
// GetAccountStatus fetches account status (GET /account/status).
|
|
// It returns the account status including account info and Plus subscription status.
|
|
func (c *Client) GetAccountStatus(ctx context.Context) (*Status, error) {
|
|
var result Status
|
|
if err := c.request.Get(ctx, "/account/status", nil, &result); err != nil {
|
|
return nil, err
|
|
}
|
|
return &result, nil
|
|
}
|