This is the Shoudio API introduction slides, held at Music HackDay 2011 in Berlin. Shoudio is the Location Based Audio Platform.

1. the Location Based
Audio Network
API launch
MHD Berlin ’11

2. Record, Share & Explore

3. Mission:
Gather, index and share all
Location Based Audio

5. 51°N15' 4°W23'
@roelandp: ‘Celebrating Ajax’ 2011 soccer league
championship #partystrong’

6. 51°N15' 3°W23'
@roelandp: ‘Stranded in Zeeland #summer’

7. The Distribution EcoSystem
API
mobile apps
website
social networks
widgets
rss/itunes

8. SHOUDIO APIs
json api
public feeds
oembed widgets

9. JSON API v1
https://shoudio.com/api/v1
signed/authorized access only

10. METHODS
GET POST
/user
/user-followings
/user-followers /post
/channel
/place
/geo

11. authorization
1. Register your app at
http://shoudio.com/developer/newapp
2. Redirect user to:
https://shoudio.com/oauth2/authorize?
client_id=your_client_id
3. User grants access, we redirect to:
http://yourcall.ba/ck.php?code=XYZ

12. authorization
4. Exchange ‘code’ for long-lived oauth_token
https://shoudio.com/oauth2/token
post:
‘code = ‘XYZ’,
‘grant_type = ‘authorization_code’
‘client_id‘ = ‘your app id’
‘client_secret‘ = ‘your app secret’
‘redirect_uri‘ = ‘your redirect uri’
5. Response: json object:
{“oauth_token”:”xyzs234176”,”expires_in”:123412344}

13. example call | Nearby Shoudios
https://shoudio.com/api/v1/geo
?oauth_token=XYZ123&lat=52.3333&lon=3.11111
{
status: { code: 200 OK, message: All ok, description},
shoudios: [{item1},{item2},{item3}],
oauth: {client_id, expires,userid}
}

14. the ‘shoudios’ object
{
id: "1004"
1
user: {
1 avatar: "http://noise.shoudio.com/avatars/100x100/1.jpg"
2 img_ext: "jpg"
3 username: "roelandp"
4 uid: "1"
2 }
3 uid: "1"
4 created_ago: "5 days ago"
5 created_at: "2011-05-21 19:09:04"
6 distance: "667.4835346968"
7 lat: "51.70311737"
8 lon: "3.74137235"
9 published: "1"
10 speed: "-1"
11 altitude: "0"
12 heading: "-1"
13 locationAccuracy: "2499"
14 altitudeAccuracy: "-1"
15 locationTimestamp: "1305894821"
16 placeid: "0"
17 channelid: "0"
18 message: "Gestrand"
19 duration: "68.596"
20 nearby: "Duinoordweg 6, 4328 Burgh-Haamstede, Netherlands"
21 hasmp3: "1"
22 -
audio: {
1 mp3: "http://noise.shoudio.com/mp3/shoudio_1004.mp3"
2 wav: "http://noise.shoudio.com/wav/shoudio_1004.wav"
23 }
24 hasimg: "1"
2 }

15. error codes

16. important urls
setup new app:
http://shoudio.com/developer/newapp
full api docs
http://bit.ly/shoudioapi

17. oEmbed
oEmbed api endpoint:
http://shoudio.com/api/oembed?url=XXX
JSON & RSS
http://shoudio.com/-/XXX
http://shoud.io/XXX
http://shoudio.com/user/XXX
http://shoudio.com/channel/XXX

18. API ideas
Whats the Parteh
Get audio impressions of what you can expect when you enter a
club at a given location.
Last.fm + GoogleMaps + Foursquare + Lame + Shoudio
Noicity
Measure the level of noisyness in the city
Shoudio + Echonest

19. again, dze important urls
setup new app:
http://shoudio.com/developer/newapp
full api docs
http://bit.ly/shoudioapi
@roelandp - roeland@shoudio.com