Skip to content

Latest commit

 

History

History
147 lines (99 loc) · 3.23 KB

README.md

File metadata and controls

147 lines (99 loc) · 3.23 KB

Wukong

Wukong is a web-based music sharing platform which is implemented in C# and JavaScript. The application allows users to share and listen their favorite songs together.

Build Status Code Climate license GitHub release

Authentication

  • We currently only support Google OAuth. More will be added soon.
  • Google OAuth /oauth/google

HTTP Endpoint /api

Using APIs under /api endpoint requires authentication.

Section /channel

The APIs under channel section controls the main logic of Wukong service.

POST /join/:channelId

Join a channel using channel ID. Joining a new channel will leave the previous channel automatically.

POST /updateNextSong/:channelId

Parameter

  • siteId
  • songId

POST /downVote/:channelId

If half of the listeners have downvoted, the current song will be stopped and play next song immediately.

POST /finished/:channelId

The frontend should report when the current song finishes.

Section /song

The APIs under /song sections serves as a middleware between Wukong backend and Wukong providers so that provider can be added effortlessly without modifying any backend logic.

POST /search

Parameter

  • key

Response

  • list
    • artist
    • album
    • artwork
    • title
    • siteId
    • songId

Section /user

GET /userinfo

Response

  • userName
  • id
  • avatar

GET /songList/:id

Response

  • name
  • list
    • artist
    • album
    • artwork
    • title
    • siteId
    • songId
    • length

POST /songList[/:id]

Parameter

  • name
  • list
    • songId
    • siteId

Response

  • [id]

WebSocket Endpoint /

WebSocket endpoint is used to create an interactive communication between clients and backends.

Server to Client

Play

  • eventName - "Play"
  • song
    • artist
    • album
    • artwork
    • title
    • siteId
    • songId
    • length - double
    • file
  • elapsed - double
  • user

A client should always stop the already playing track and start playing another when 'Play' event is received.

UserListUpdated

  • eventName - "UserListUpdated"
  • users - list
    • userName
    • id
    • avarta

NextSongUpdated

  • eventName = "NextSongUpdated"
  • song
    • artist
    • album
    • artwork
    • title
    • siteId
    • songId
    • length - double
    • file

Notes

  • HTTP status code 401 will be sent in response to unauthenticated requests.
  • Clients should connect the WebSocket endpoint immediately after joining a channel to receive messages from it. Clients that being disconnected for a period of time will be removed from the channel.