Shoudio API v1

1,522 views

Published on

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

Shoudio is the Location Based Audio Platform.

Published in: Self Improvement
0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
1,522
On SlideShare
0
From Embeds
0
Number of Embeds
270
Actions
Shares
0
Downloads
0
Comments
0
Likes
2
Embeds 0
No embeds

No notes for slide

Shoudio API v1

  1. 1. the Location Based Audio Network API launch MHD Berlin ’11
  2. 2. Record, Share & Explore
  3. 3. Mission:Gather, index and share all Location Based Audio
  4. 4. 51°N15 4°W23@roelandp: ‘Celebrating Ajax’ 2011 soccer leaguechampionship #partystrong’
  5. 5. 51°N15 3°W23@roelandp: ‘Stranded in Zeeland #summer’
  6. 6. The Distribution EcoSystem API mobile apps website social networks widgets rss/itunes
  7. 7. SHOUDIO APIs json api public feedsoembed widgets
  8. 8. JSON API v1https://shoudio.com/api/v1 signed/authorized access only
  9. 9. METHODS GET POST/user/user-followings/user-followers /post/channel/place/geo
  10. 10. authorization1. Register your app athttp://shoudio.com/developer/newapp2. Redirect user to:https://shoudio.com/oauth2/authorize?client_id=your_client_id3. User grants access, we redirect to:http://yourcall.ba/ck.php?code=XYZ
  11. 11. authorization4. Exchange ‘code’ for long-lived oauth_tokenhttps://shoudio.com/oauth2/tokenpost:‘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}
  12. 12. example call | Nearby Shoudioshttps://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}}
  13. 13. 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 }
  14. 14. error codes
  15. 15. important urlssetup new app:http://shoudio.com/developer/newappfull api docshttp://bit.ly/shoudioapi
  16. 16. oEmbedoEmbed api endpoint:http://shoudio.com/api/oembed?url=XXX JSON & RSShttp://shoudio.com/-/XXXhttp://shoud.io/XXXhttp://shoudio.com/user/XXXhttp://shoudio.com/channel/XXX
  17. 17. API ideasWhats the PartehGet audio impressions of what you can expect when you enter aclub at a given location.Last.fm + GoogleMaps + Foursquare + Lame + ShoudioNoicityMeasure the level of noisyness in the cityShoudio + Echonest
  18. 18. again, dze important urlssetup new app:http://shoudio.com/developer/newappfull api docshttp://bit.ly/shoudioapi@roelandp - roeland@shoudio.com

×