boris
1c98a634c3
All checks were successful
CI - Build Tonehaus Docker image / tonehaus-ci-build (push) Successful in 1m57s
19 lines
527 B
Markdown
19 lines
527 B
Markdown
# 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])`
|
|
|
|
## Advanced search
|
|
- The search page builds Spotify fielded queries:
|
|
- `album:"..."`, `artist:"..."`, `year:YYYY` or `year:YYYY-YYYY`
|
|
- Optional free-text added to the query
|
|
|
|
|