Get User's Favourite Tracks

Get the current user as a favourite of one or more tracks.

Request

GET /favourite/v1/tracks

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 )

REQUEST PARAMETER	VALUE
offset	Required integer The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
limit	Required integer The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

Responses Body

Body

code (integer) required
desc (string)
counts (integer) count of data
data (object)

track_id (integer) The Boomplay ID for the track.
track_title (string) The Boomplay title for the track.
track_number (integer) Ranking of track in the album.
isrc (string) isrc
duration (string) Track duration
genres (string) The album genres.
available_markets (string) Release country .
web_url (string) web url.
mobile_url (string) mobile url.
artwork (object)

width (integer) image width
height (integer) image height
url (string) cover

artists (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/tracks HTTP/1.1
Authorization: ${authorization}
app_id: ${app_id}
Host: openapi.boomplay.com

Response Example

{
  "desc": null,
  "code": 0,
  "counts": 1,
  "data": [
    {
        "track_id": 54230705,
        "track_title": "Shakira - Try Everything (《疯狂动物城》电影主题曲)",
        "track_number": 1,
        "isrc": "",
        "duration": "00:03:16",
        "album_id": 40035180,
        "album_title": "webplayer-cms",
        "genres": "Pop,Pop",
        "available_markets": "PS,PT,PW,PY,QA,AD,AE,AF,AG,AL,AM,AO,AR,AS,AT,AU,AZ,RO,BA,BB,RS,BD,BE,RU,BF,BG,RW,BH,BI,BJ,BN,BO,SA,SB,SC,BR,SD,BS,SE,BT,SG,BW,SI,BY,SK,BZ,SL,SM,SN,SO,CA,SR,SS,CD,ST,CF,SV,CG,CH,CI,SY,SZ,CK,CL,CM,CN,CO,CR,TD,CU,CV,TG,TH,CY,TJ,CZ,TK,TL,TM,TN,TO,TR,TT,DE,TV,TW,DJ,TZ,DK,DM,DO,UA,UG,DZ,US,EC,EE,EG,UY,UZ,VA,ER,VC,ES,ET,VE,VN,VU,FI,FJ,FK,FM,FR,WF,GA,GB,WS,GD,GE,GF,GH,GM,GN,GQ,GR,GS,GT,GU,GW,GY,XO,HN,HR,YE,HT,HU,ID,IE,IL,IN,ZA,IQ,IR,IS,IT,ZM,ZW,JM,JO,JP,KE,KG,KH,KI,KM,KN,KP,KR,KW,KZ,LB,LC,LI,LK,LR,LS,LT,LU,LV,LY,MA,MC,MD,ME,MG,MH,MK,ML,MM,MN,MP,MR,MT,MU,MV,MW,MX,MY,MZ,NA,NC,NE,NF,NG,NI,NL,NO,NP,NR,NU,NZ,OM,OT,PA,PE,PF,PG,PH,PK,PL,PN",
        "web_url": "https://test.boomplay.com/songs/54230705?srModel=openapi_hb1",
        "mobile_url": "https://test.boomplay.com/share/music/54230705?srModel=openapi_hb1",
        "artwork": {
            "width": 464,
            "height": 464,
            "url": "https://testsource.boomplaymusic.com/test_group10/M00/05/29/3cf272153b844744980bef85cc06053c_464_464.jpg"
        },
        "artists": [
            {
                "artist_id": 21876369,
                "artist_name": "xiaoxiao"
            }
        ]
    }
  ]
}

results matching ""

No results matching ""