Started api design
parent
5287fd818e
commit
15d8879b75
|
@ -0,0 +1,26 @@
|
||||||
|
# Ideation
|
||||||
|
|
||||||
|
This file just serves as a central point for all the ideas I have for this
|
||||||
|
project.
|
||||||
|
|
||||||
|
## Used software/services
|
||||||
|
|
||||||
|
* Spotify API to look up album information
|
||||||
|
* YouTubeDL to download the videos
|
||||||
|
* Something to set the mp3 tags, not sure about this one yet
|
||||||
|
|
||||||
|
## API Design
|
||||||
|
|
||||||
|
### Endpoints
|
||||||
|
|
||||||
|
* `GET /search?q=`
|
||||||
|
* search for albums & tracks, given a search query
|
||||||
|
* returns a list of albums/tracks (basically the same as the API, just
|
||||||
|
cleaned up a bit)
|
||||||
|
* `GET /albums?ids=`: get detailed information about an album/a list of albums.
|
||||||
|
I'm not actually sure if I need this one.
|
||||||
|
* `GET /tracks?ids=`: get detailed information about a track/a list of tracks.
|
||||||
|
* `GET /tracks/videos?id=`: given a track, search YouTube for videos about the
|
||||||
|
track. Returns a list of youtube ids
|
||||||
|
* `POST /tracks/download`: download a track. The data should contain the wanted
|
||||||
|
metadata in the file & the id of the youtube video
|
Reference in New Issue