Blogs

Entity Track new feature: Embedded Player

Track entity has a new feature: we added the HTML code of the Play.me flash player to stream the track within the embeddedPlayer attribute.
When calling an API returning a track or a track list, you will find within track entity the new attribute, that looks something as follows (JSON):


"embeddedPlayer" : "<object type=\"application/x-shockwave-flash\" data=\"http://embed2.dada.net/swf/vdet.swf\" width=\"420px\" height=\"30px\" ><param name=\"quality\" value=\"high\" /> <param name=\"wmode\" value=\"transparent\" /> <param name=\"menu\" value=\"false\" /> <param name=\"allowscriptaccess\" value=\"always\" /> <param name=\"flashvars\" value=\"cid=1042321&domain=it&conf=P00XXX\" /> <param name=\"movie\" value=\"http://embed2.dada.net/swf/vdet.swf\" /></object>"

You can use the HTML code to show the play.me flash player and so allowing track streaming.

Read more
OAuth on Play.me

Play.me API now support OAuth authentication protocol.
OAuth allows third parties applications to delegate playme user authentication to playme.com itself, so that they can avoid to make themselves responsible for related security issues.

Take a look at Play.me API OAuth implementation starting from here.

The Playme API Team

Read more
New API: playlist.replaceTrackList

This new API allows you to replace an existing playlist contents: it clears previous contents and insert the track list you supply in just one step! Useful for supporting kind of "playlist of the week" stuff, i.e. playlists that users modify periodically.
 
Find (and read before use) the API documentation at the playlist.replaceTrackList API page.
 
The Playme API Team

Read more
New Feature API track.search track.searchByName

Now it is possible to refine track searching (both full text and by track name), using genre.
 
Example:
this call retrieves tracks whose title contain the word night:

track.searchByName?query=night&apikey=12345...

To filter only reggae tracks you have just to append reggae genre indentifier (968):

track.searchByName?query=night&genreCode=968&apikey=12345...

The same holds for the track.search API.

The Playme API Team

Read more
New Feature API track.searchByName

Now it is possible to refine track search by track name, using artist identifier.
 
Example:
this call retrieves tracks whose title contain the word sun:

track.searchByName?query=sun&apikey=12345...

To filter only Placebo's tracks you have just to append Placebo's indentifier (1275):

track.searchByName?query=sun&artistCode=1275&apikey=12345...

The Playme API Team

Read more
New API: playlist.addTrackList

This new API allows you to insert a list of tracks into an existing playlist: a further step into the down with API call loops road!
 
Find (and read before use) the API documentation at the playlist.addTrackList API page.
 
The Playme API Team

Read more
New API: track.new

Here we are with a brand new API, that returns the new entries in our catalogue.
 
Its use is straightforward, as it needs no specific parameter (apart from your apikey, as usual).
 
Try it out and discover what's new within playme catalogue. And, as usual, remember to read the documentation page.
 
The Playme API Team

Read more
New API: track.getRandom

Sure, this may not be the API you were thinking about, but nonetheless here it is!
 
It extracts a random track from the catalogue and you should try it, just to have some fun.
Read the API documentation page and enjoy it.
 
The Playme API Team

Read more
New API: playlist.copy

This new API allows you to copy the whole contents of an existing playlist (source) to a newly created one (destination).
You just need to supply the source playlistCode and the destination playlist owner's User Authentication Token.
 
Find (and read before use) the API documentation at the playlist.copy API page.
 
The Playme API Team

Read more
New API : track.getList

Many of you have been asking for that: an API that retrieves a collection of tracks by their ids, so avoiding to execute calls to track.get from within a loop.
Now that's it!
With track.getList you retrieve the track list with one and only call: just supply it with a comma separated list of trackCodes.
For further details about the API, read the documentation page.
 
Enjoy it.
 
The Playme API Team

Read more