MeeMix API
From MeeMixWiki
Contents |
Overview
MeeMix Web Service enables partners to synchronize their own media libraries with the MeeMix database, and subsequently suggest musical recommendations and playlists to their users, whether unregistered or registered users.
Once the partner has created their media libraries and submitted music (synchronizing with MeeMix database), the web service allows two modes of operation:
1. Single Request Discovery Mode (for your unregistered users): suggest recommendations or a one-time playlist to an unknown user. User information and history are not saved in the MeeMix database. Tracks are suggested based on musical DNA similarity only. Should be used for unregistered guests or unrecognized users.
2. Taste Prediction and Discovery Mode (personalized, for your registered users): suggest personalized recommendations or playlists to a known and recognized user. Track and artist personalized recommendations are suggested based on musical DNA similarity and user information/history. User information and playlists are saved in MeeMix, thus allowing for continued and more precise recommendations over time.
MeeMix Web Service exposes SOAP and REST API in two environments:
1. Test and Integration Environment, endpoint: http://ws.shadow.meemix.com:8080/mxws/services/mxws
2. Production Environment, endpoint: http://ws.meemix.com:8080/mxws/services/mxws
WSDL file: http://ws.shadow.meemix.com:8080/mxws/services/mxws?wsdl
Web Service Data Types
Web Service Modes and Operations
Build your media library (synchronizing with MeeMix)
Creates a new media library in MeeMix (a partner can create several libraries).
Submits a track to a media library.
Delete a track from a media library.
Check submitted track status.
Attaches links to a previously-submitted artist using the lib.submitTrack.
Single Request Discovery Mode (for your unregistered users)
Searches for standalone artist recommendations according to a given artist name or MeeMix artist ID. Recommendations are based on musical DNA similarity.
Searches for standalone track recommendations according to a given artist name or MeeMix artist ID. Recommendations are based on musical DNA similarity.
Searches for standalone track recommendations according to a given track name or MeeMix track ID. Recommendations are based on musical DNA similarity.
Taste Prediction and Discovery Mode (for your registered users)
User operations
Registers a user from a partner in the MeeMix database using your assigned partner ID and a unique (in your partner namespace) user ID.
Retrieves the user`s personalized playlists.
Creates a personalized playlist based on artist name or by MeeMix artist ID.
Creates a personalized playlist based on track name or by MeeMix track ID.
Deletes a user personalized playlist (previously created with the user.createPlaylistBy* operations).
Notifies MeeMix about an action a specific user took regrading a specific track (purchased track, downloaded its ringtone etc.)
Retrieves personalized track recommendations for a specific user.
Retrieves a specific user's favorite tracks.
Notifies MeeMix about an action a specific user took regrading a specific artist (e.g, searched for artist event).
Retrieves personalized artist recommendations for a specific user.
Retrieves a specific user's favorite artists.
Personalized playlist operations
Requests the next track on a user`s personalized playlist.
Rates a track previously provided by the playlist.getTrack operation on this playlist.
Sets the personalized playlist's pulse level.
Sets the personalized playlist's atmosphere.
Sets the personalized playlist's surprise (exploration) level.
Blocks a specific track on this personalized playlist from playing for a period of time.
Blocks a specific artist on this personalized playlist from playing for a period of time.
Unblocks a previously blocked track.
Unblocks a previously blocked artist.
Adds a track to the personalized playlist.
Adds an artist to the personalized playlist.
