| VIP |
|---|
Subscribe to become a VIP member of 1980s.FM!
· Request More Often
· Unshared Requests
· Request Countdown Timer
· Request Ready Indicator
· Your Request History
· Access To The VIP Forum
· Add More Favorites
:: Click Here To Upgrade ::
:: Give VIP as a Gift :: |
|
|
|
View previous topic ::
View next topic
|
| Author |
Message |
 Muriel 
Admiral (Administrator)
Joined: Nov 27, 2007
Member#: 10
Posts: 1
Location: Norway
     
|
 Posted:
Tue Jul 08, 2008 2:15 pm Post subject: New feature: Developer API |
 
|
Some of you have done a great job developing gadgets and widgets and whatnot. I've recently developed a new feature for all the websites in the 24seven.fm network that should make your development a lot easier.
You will no longer need to parse the websites to get the queue, history and what's playing. I've put a webservice on all the sites that give you all the information you need in one go.
Those of you who are not software developers or have no idea what this is all about need not worry. This is technical stuff 
The webservice definition can be found here:
http://1980s.fm/soap/FM24seven.wsdl
The webservice can be found on all the sites using /soap/FM24seven.wsdl
Methods provided:
GetCurrentlyPlaying(boolean GetCover)
This method returns an object with all the information about the currently playing track. It's the same information that can be found in playing.php. If you call the method with the GetCover parameter set to "true" the webservice will return the binary data for the currently playing song. "false" puts NULL in the binary data, but you still have the URL to the cover in the message.
GetQueue(int NoOfEntries, boolean GetCover)
GetHistory(int NoOfEntries, boolean GetCover)
Here you will get an array of an object that contains information about the songs in the queue or history. The information in the object is the same as can be found on the Queue/Played page.
The NoOfEntries parameter lets you control how many entries is returned. The maximum number of entries returned is 20.
The GetCover parameter behaves in the same way as for GetCurrentlyPlaying().
We would appreciate if you would limit your requests to the webservice. Use it only when a song has changed. The GetCurrentlyPlaying() includes the length of the currently playing track (in milliseconds), when the track started playing (dateTime) and what the time was on the server when you invoked the webservice. That should make it easy enough to calculate a countdown timer so that you know when the track has finished playing.
_________________
"Anything one man can imagine,
other men can make real."
- Jules Verne |
|
 |
 petshopboy
Cadet 4
Joined: Mar 11, 2008
Member#: 112
Posts: 17
Location: Maryland
|
|
Posted:
Fri Jul 11, 2008 1:38 pm Post subject: |
|
Excellent, thanks for doing this! I'll have to try it out. |
|
|
|
|
|
|
|
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
|
|
|
|
|
|
|
