refactor: switch to official Spotify developer API with client credentials flow

- Replaced deprecated web token endpoint with POST to accounts.spotify.com/api/token
- Integrated client credentials OAuth flow using client ID and secret
- Adjusted request headers to use Bearer token
This commit is contained in:
KaNaDaAT 2025-05-15 20:23:49 +02:00
parent 98e4d46a31
commit fbaf329872
2 changed files with 245 additions and 68 deletions

4
server/credentials.json Normal file
View file

@ -0,0 +1,4 @@
{
"client_id": "",
"client_secret": ""
}

View file

@ -1,14 +1,18 @@
package spotify package spotify
import ( import (
"bytes"
"encoding/json"
"errors" "errors"
"fmt" "fmt"
"io" "io"
"math" "math"
"net/http" "net/http"
"net/url"
"regexp" "regexp"
"strings" "strings"
"time" "time"
"os"
"github.com/tidwall/gjson" "github.com/tidwall/gjson"
) )
@ -24,30 +28,120 @@ type Track struct {
Duration int Duration int
} }
const ( const (
tokenEndpoint = "https://open.spotify.com/get_access_token?reason=transport&productType=web-player" tokenURL = "https://accounts.spotify.com/api/token"
trackInitialPath = "https://api-partner.spotify.com/pathfinder/v1/query?operationName=getTrack&variables=" credentialsPath = "credentials.json"
playlistInitialPath = "https://api-partner.spotify.com/pathfinder/v1/query?operationName=fetchPlaylist&variables=" cachedTokenPath = "token.json"
albumInitialPath = "https://api-partner.spotify.com/pathfinder/v1/query?operationName=getAlbum&variables="
trackEndPath = `{"persistedQuery":{"version":1,"sha256Hash":"e101aead6d78faa11d75bec5e36385a07b2f1c4a0420932d374d89ee17c70dd6"}}`
playlistEndPath = `{"persistedQuery":{"version":1,"sha256Hash":"b39f62e9b566aa849b1780927de1450f47e02c54abf1e66e513f96e849591e41"}}`
albumEndPath = `{"persistedQuery":{"version":1,"sha256Hash":"46ae954ef2d2fe7732b4b2b4022157b2e18b7ea84f70591ceb164e4de1b5d5d3"}}`
) )
type credentials struct {
ClientID string `json:"client_id"`
ClientSecret string `json:"client_secret"`
}
type tokenResponse struct {
AccessToken string `json:"access_token"`
TokenType string `json:"token_type"`
ExpiresIn int `json:"expires_in"`
}
type cachedToken struct {
Token string `json:"token"`
ExpiresAt time.Time `json:"expires_at"`
}
func loadCredentials() (*credentials, error) {
file, err := os.Open(credentialsPath)
if err != nil {
if os.IsNotExist(err) {
absPath, _ := os.Getwd()
return nil, fmt.Errorf("credentials.json not found. Please create it in the same directory:\n%s/%s", absPath, credentialsPath)
}
return nil, err
}
defer file.Close()
var creds credentials
if err := json.NewDecoder(file).Decode(&creds); err != nil {
return nil, fmt.Errorf("failed to parse credentials.json: %w", err)
}
return &creds, nil
}
func saveToken(token string, expiresIn int) error {
ct := cachedToken{
Token: token,
ExpiresAt: time.Now().Add(time.Duration(expiresIn) * time.Second),
}
data, err := json.MarshalIndent(ct, "", " ")
if err != nil {
return err
}
return os.WriteFile(cachedTokenPath, data, 0644)
}
func loadCachedToken() (string, error) {
data, err := os.ReadFile(cachedTokenPath)
if err != nil {
return "", err
}
var ct cachedToken
if err := json.Unmarshal(data, &ct); err != nil {
return "", err
}
if time.Now().After(ct.ExpiresAt) {
return "", errors.New("token expired")
}
return ct.Token, nil
}
func accessToken() (string, error) { func accessToken() (string, error) {
resp, err := http.Get(tokenEndpoint) // Try using cached token
token, err := loadCachedToken()
if err == nil {
return token, nil
}
// Fallback: request a new token
creds, err := loadCredentials()
if err != nil {
return "", err
}
data := url.Values{}
data.Set("grant_type", "client_credentials")
data.Set("client_id", creds.ClientID)
data.Set("client_secret", creds.ClientSecret)
req, err := http.NewRequest("POST", tokenURL, bytes.NewBufferString(data.Encode()))
if err != nil {
return "", err
}
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
resp, err := http.DefaultClient.Do(req)
if err != nil { if err != nil {
return "", err return "", err
} }
defer resp.Body.Close() defer resp.Body.Close()
body, err := io.ReadAll(resp.Body) if resp.StatusCode != http.StatusOK {
if err != nil { body, _ := io.ReadAll(resp.Body)
return "", errors.New("token request failed (have a look at credentials.json): " + string(body))
}
var tr tokenResponse
if err := json.NewDecoder(resp.Body).Decode(&tr); err != nil {
return "", err return "", err
} }
accessToken := gjson.Get(string(body), "accessToken") if err := saveToken(tr.AccessToken, tr.ExpiresIn); err != nil {
return accessToken.String(), nil return "", err
}
return tr.AccessToken, nil
} }
/* requests to playlist/track endpoints */ /* requests to playlist/track endpoints */
@ -89,86 +183,165 @@ func isValidPattern(url, pattern string) bool {
} }
func TrackInfo(url string) (*Track, error) { func TrackInfo(url string) (*Track, error) {
trackPattern := `^https:\/\/open\.spotify\.com\/track\/[a-zA-Z0-9]{22}\?si=[a-zA-Z0-9]{16}$` re := regexp.MustCompile(`open\.spotify\.com\/track\/([a-zA-Z0-9]{22})`)
if !isValidPattern(url, trackPattern) { matches := re.FindStringSubmatch(url)
return nil, errors.New("invalid track url") if len(matches) != 2 {
return nil, errors.New("invalid track URL")
} }
id := matches[1]
id := getID(url) endpoint := fmt.Sprintf("https://api.spotify.com/v1/tracks/%s", id)
endpointQuery := EncodeParam(fmt.Sprintf(`{"uri":"spotify:track:%s"}`, id))
endpoint := trackInitialPath + endpointQuery + "&extensions=" + EncodeParam(trackEndPath)
statusCode, jsonResponse, err := request(endpoint) statusCode, jsonResponse, err := request(endpoint)
if err != nil { if err != nil {
return nil, fmt.Errorf("error on getting track info: %w", err) return nil, fmt.Errorf("error getting track info: %w", err)
}
if statusCode != 200 {
return nil, fmt.Errorf("non-200 status code: %d", statusCode)
} }
if statusCode != 200 { var result struct {
return nil, fmt.Errorf("received non-200 status code: %d", statusCode) Name string `json:"name"`
Duration int `json:"duration_ms"`
Album struct {
Name string `json:"name"`
} `json:"album"`
Artists []struct {
Name string `json:"name"`
} `json:"artists"`
}
if err := json.Unmarshal([]byte(jsonResponse), &result); err != nil {
return nil, err
} }
var allArtists []string var allArtists []string
for _, a := range result.Artists {
if firstArtist := gjson.Get(jsonResponse, "data.trackUnion.firstArtist.items.0.profile.name").String(); firstArtist != "" { allArtists = append(allArtists, a.Name)
allArtists = append(allArtists, firstArtist)
} }
if artists := gjson.Get(jsonResponse, "data.trackUnion.otherArtists.items").Array(); len(artists) > 0 { return (&Track{
for _, artist := range artists { Title: result.Name,
if profile := artist.Get("profile").Map(); len(profile) > 0 { Artist: allArtists[0],
if name := profile["name"].String(); name != "" {
allArtists = append(allArtists, name)
}
}
}
}
durationInSeconds := int(gjson.Get(jsonResponse, "data.trackUnion.duration.totalMilliseconds").Int())
durationInSeconds = durationInSeconds / 1000
track := &Track{
Title: gjson.Get(jsonResponse, "data.trackUnion.name").String(),
Artist: gjson.Get(jsonResponse, "data.trackUnion.firstArtist.items.0.profile.name").String(),
Artists: allArtists, Artists: allArtists,
Duration: durationInSeconds, Album: result.Album.Name,
Album: gjson.Get(jsonResponse, "data.trackUnion.albumOfTrack.name").String(), Duration: result.Duration / 1000,
} }).buildTrack(), nil
return track.buildTrack(), nil
} }
func PlaylistInfo(url string) ([]Track, error) { func PlaylistInfo(url string) ([]Track, error) {
playlistPattern := `^https:\/\/open\.spotify\.com\/playlist\/[a-zA-Z0-9]{22}\?si=[a-zA-Z0-9]{16}$` re := regexp.MustCompile(`open\.spotify\.com\/playlist\/([a-zA-Z0-9]{22})`)
if !isValidPattern(url, playlistPattern) { matches := re.FindStringSubmatch(url)
return nil, errors.New("invalid playlist url") if len(matches) != 2 {
return nil, errors.New("invalid playlist URL")
}
id := matches[1]
var allTracks []Track
offset := 0
limit := 100
for {
endpoint := fmt.Sprintf("https://api.spotify.com/v1/playlists/%s/tracks?offset=%d&limit=%d", id, offset, limit)
statusCode, jsonResponse, err := request(endpoint)
if err != nil {
return nil, fmt.Errorf("request error: %w", err)
}
if statusCode != 200 {
return nil, fmt.Errorf("non-200 status: %d", statusCode)
} }
totalCount := "data.playlistV2.content.totalCount" var result struct {
itemsArray := "data.playlistV2.content.items" Items []struct {
tracks, err := resourceInfo(url, "playlist", totalCount, itemsArray) Track struct {
if err != nil { Name string `json:"name"`
Duration int `json:"duration_ms"`
Album struct {
Name string `json:"name"`
} `json:"album"`
Artists []struct {
Name string `json:"name"`
} `json:"artists"`
} `json:"track"`
} `json:"items"`
Total int `json:"total"`
}
if err := json.Unmarshal([]byte(jsonResponse), &result); err != nil {
return nil, err return nil, err
} }
return tracks, nil for _, item := range result.Items {
track := item.Track
var artists []string
for _, a := range track.Artists {
artists = append(artists, a.Name)
}
allTracks = append(allTracks, *(&Track{
Title: track.Name,
Artist: artists[0],
Artists: artists,
Duration: track.Duration / 1000,
Album: track.Album.Name,
}).buildTrack())
}
offset += limit
if offset >= result.Total {
break
}
}
return allTracks, nil
} }
func AlbumInfo(url string) ([]Track, error) { func AlbumInfo(url string) ([]Track, error) {
albumPattern := `^https:\/\/open\.spotify\.com\/album\/[a-zA-Z0-9-]{22}\?si=[a-zA-Z0-9_-]{22}$` re := regexp.MustCompile(`open\.spotify\.com\/album\/([a-zA-Z0-9]{22})`)
if !isValidPattern(url, albumPattern) { matches := re.FindStringSubmatch(url)
return nil, errors.New("invalid album url") if len(matches) != 2 {
return nil, errors.New("invalid album URL")
}
id := matches[1]
endpoint := fmt.Sprintf("https://api.spotify.com/v1/albums/%s/tracks?limit=50", id)
statusCode, jsonResponse, err := request(endpoint)
if err != nil {
return nil, fmt.Errorf("error getting album info: %w", err)
}
if statusCode != 200 {
return nil, fmt.Errorf("non-200 status: %d", statusCode)
} }
totalCount := "data.albumUnion.discs.items.0.tracks.totalCount" var result struct {
itemsArray := "data.albumUnion.discs.items" Items []struct {
tracks, err := resourceInfo(url, "album", totalCount, itemsArray) Name string `json:"name"`
if err != nil { Duration int `json:"duration_ms"`
Artists []struct {
Name string `json:"name"`
} `json:"artists"`
} `json:"items"`
}
if err := json.Unmarshal([]byte(jsonResponse), &result); err != nil {
return nil, err return nil, err
} }
var tracks []Track
for _, item := range result.Items {
var artists []string
for _, a := range item.Artists {
artists = append(artists, a.Name)
}
tracks = append(tracks, *(&Track{
Title: item.Name,
Artist: artists[0],
Artists: artists,
Duration: item.Duration / 1000,
Album: "", // You can fetch full album info if needed
}).buildTrack())
}
return tracks, nil return tracks, nil
} }
/* returns playlist/album slice of tracks */ /* returns playlist/album slice of tracks */
func resourceInfo(url, resourceType, totalCount, itemList string) ([]Track, error) { func resourceInfo(url, resourceType, totalCount, itemList string) ([]Track, error) {
id := getID(url) id := getID(url)
@ -212,10 +385,10 @@ func jsonList(resourceType, id string, offset, limit int64) (string, error) {
var endpoint string var endpoint string
if resourceType == "playlist" { if resourceType == "playlist" {
endpointQuery = EncodeParam(fmt.Sprintf(`{"uri":"spotify:playlist:%s","offset":%d,"limit":%d}`, id, offset, limit)) endpointQuery = EncodeParam(fmt.Sprintf(`{"uri":"spotify:playlist:%s","offset":%d,"limit":%d}`, id, offset, limit))
endpoint = playlistInitialPath + endpointQuery + "&extensions=" + EncodeParam(playlistEndPath) endpoint = endpointQuery
} else { } else {
endpointQuery = EncodeParam(fmt.Sprintf(`{"uri":"spotify:album:%s","locale":"","offset":%d,"limit":%d}`, id, offset, limit)) endpointQuery = EncodeParam(fmt.Sprintf(`{"uri":"spotify:album:%s","locale":"","offset":%d,"limit":%d}`, id, offset, limit))
endpoint = albumInitialPath + endpointQuery + "&extensions=" + EncodeParam(albumEndPath) endpoint = endpointQuery
} }
statusCode, jsonResponse, err := request(endpoint) statusCode, jsonResponse, err := request(endpoint)