Get User's Favourite Albums
Add the current user as a favourite of one or more albums.
Request
GET /favourite/v1/albums
Parameter
HEADER PARAMETER | VALUE |
---|---|
Content-Type | Required Set to application/json |
Accept-Language | Such as zh-CN,en-US... default en |
app_id | Required The app ID provided to you by Boomplay when you register your application. |
Authorization | Required Access Token (The access token from ImplicitGrant or RefreshToken ) |
Responses Body
Body
code (integer) required
desc (string)
counts (integer) count of data
data (object)album_id (integer) The Boomplay ID for the album.
album_title (string) The Boomplay title for the album.
album_type (string) The Boomplay type for the album.
upc (string) The Boomplay upc for the album.
release_date (string) The album Release date.
label (string) Record label.
genres (string) The album genres.
available_markets (string) Release country .
web_url (string) web url.
mobile_url (string) mobile url.
artwork objectwidth (integer) image width
height (integer) image height
url (string) coverartists (array of objects)
artist_id (integer) The Boomplay ID for the artist.
artist_name (string) The Boomplay name for the artis
Request Sample
GET /favourite/v1/albums
Authorization: ${authorization}
app_id: ${app_id}
Host: openapi.boomplay.com
Response Example
{
"desc": null,
"code": 0,
"counts": 1,
"data": [
{
"album_id": 40002743,
"album_title": "TestOT001",
"album_type": "EP",
"upc": "",
"release_date": "2022-03-18",
"label": "10/10 Records",
"genres": "World Music,World Music",
"available_markets": "OT,CN",
"web_url": "https://test.boomplay.com/albums/40002743?srModel=openapi_hb66",
"mobile_url": "https://test.boomplay.com/share/album/40002743?srModel=openapi_hb66",
"artwork": {
"width": 464,
"height": 464,
"url": "https://testsource.boomplaymusic.com/test_group10/M00/03/17/a5d36d70a1ee4bc6be2f8205b123199b_464_464.jpg"
},
"artists": [
{
"artist_id": 21884682,
"artist_name": "Jake zhou"
},
{
"artist_id": 21876670,
"artist_name": "YYYsmIconIDBigIconID"
}
]
}
]
}