Uploading song
URI: https://icarus-demo.com/api/v1/song/data
Method: Post
Content type: multipart/form-data
Authorization: Bearer token
File: @file=/path/to/song/you/wish/to/upload.mp3
Response body:
{
"id" : 12,
"title" : "Wood Would",
"artist" : "Young Thug",
"album" : "Slime Season",
"genre" : "Hip-Hop",
"track": 17,
"disc": 1,
"year" : 2015,
"duration" : 209
}
Downloading song
URI: https://icarus-demo.com/api/v1/song/data/id
Method: Get
Authorization: Bearer token
Streaming song
URI: https://icarus-demo.com/api/v1/song/stream/id
Method: Get
Authorization: Bearer token
Delete song
URL: https://icarus-demo.com/api/v1/song/id
Method: Delete
Authorization: Bearer token
Updating song metadata
URI: https://icarus-demo.com/api/v1/song/id
Method: Update
Content type: application/json
Authorization: Bearer token
Request body:
{
"title" : "updated title",
"artist" : "updated artist",
"album" : "updated album",
"genre" : "updated genre",
"year" : "updated year"
}
Retrieve song metadata
URI: https://icarus-demo.com/api/v1/song/id
Method: Get
Content type: application/json
Authorization: Bearer token
Response body:
{
"id" : 4,
"title" : "King",
"artist" : "XXXTentacion",
"album" : "Revenge",
"genre" : "Hip-Hop/R&B",
"track": 5,
"disc": 1,
"year" : 2017,
"duration" : 113
}
Retrieve all song metadata
URI: https://icarus-demo.com/api/v1/song
Method: Get
Content type: application/json
Authorization: Bearer token
Response body:
[
{
"id" : 1,
"title" : "Two Steppin'",
"artist" : "Gerald Albright",
"album" : "Giving Myself To You",
"genre" : "Jazz",
"track": 5,
"disc": 1,
"year" : 1995,
"duration" : 387
},
{
"id" : 2,
"title" : "Look Thru My Eyes",
"artist" : "DMX",
"album" : "It's Dark and Hell Is Hot",
"genre" : "Hip-Hop",
"track": 5,
"disc": 1,
"year" : 1998,
"duration" : 231
},
{
"id" : 3,
"title" : "The Patient",
"artist" : "Tool",
"album" : "Lateralus",
"genre" : "Progressive Metal",
"track": 5,
"disc": 1,
"year" : 2001,
"duration" : 434
},
{
"id" : 4,
"title" : "King",
"artist" : "XXXTentacion",
"album" : "Revenge",
"genre" : "Hip-Hop/R&B",
"track": 5,
"disc": 1,
"year" : 2017,
"duration" : 113
}
]
Icarus