listen-history-api.md

Listen History API

Create a token

PUT /api/users/USER_ID

Headers

Content-Type: application/json

Parameters

secret=USER_SECRET

Response

{
  "user": {
    "id": USER_ID,
    "name": USER_NAME,
    "display": USER_DISPLAY_NAME,
    ...
  },
  "token": TOKEN,
  "exp": TIME_OF_EXPIRATION,
  ...
}

Submit a play log

PUT /api/users/USER_ID/play

Headers

Authorization: Bearer TOKEN
Content-Type: application/json

Parameters

song=SONG_NAME
artist=ARTIST_NAME
album=ALBUM_NAME

Response

{
  "play_id": PLAY_ID,
  ...
}