Files
tonehaus/docs/04-spotify-integration.md
boris 1c98a634c3
All checks were successful
CI - Build Tonehaus Docker image / tonehaus-ci-build (push) Successful in 1m57s
eerrrrrr
2025-11-27 23:42:17 +00:00

527 B

Spotify Integration

Credentials

  • Prefer configuring via /admin/settings (stored in DB).
  • Fallback to environment variables SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET.

API client

  • src/Service/SpotifyClient.php
    • Client Credentials token fetch (cached)
    • searchAlbums(q, limit)
    • getAlbum(id) and getAlbums([ids])
  • The search page builds Spotify fielded queries:
    • album:"...", artist:"...", year:YYYY or year:YYYY-YYYY
    • Optional free-text added to the query