|
|
London Ruby User Group:Abstractions For Website APIs
Abstractions For Website APIs
Paul Mison is going to do a short talk on libraries and abstractions for website APIs. Specifically how he thinks they should be written (and how he thinks they shouldn't be). The talk will mostly focus on Flickr, so an understanding of Flickr's API and the existing abstractions might be of use.
Review:
In this LRUG session, Paul Mison talks about avoiding API library anti-patterns. Flickr, the photo sharing site, allows raw API documentation. Thankfully, people have written Fickr libraries to help further manipulation, but several of them have not been updated. Taking an example of one library that needs updating, Paul shows that it requires correcting each method individually - this is a problem with API abstractions. Updating involves a long and laborious process.
Thankfully there is a solution: first, the Request can be fixed from the convenience method (since all of them are documented). Then the response can be fixed. Flickr returns JSON (where O = Object) hence the response is an object. To return an API response in JSON format, one simply needs to send a parameter “format” in the request with a value “JSON”, and Flickr raw does that. Plus, you have the added benefit of getting extra parameters with JSON. The key is to offer simple access wrappers to users and make it well documented; to let Ruby do the work; and to use JSON, not XML, in your return format so you’ll always get something back.
Review by: Micky Mollallegn
ABOUT PAUL MISON
|
Paul is a web developer who's been using Macs since 1996. His servers run Linux. He only uses Windows when...
More about Paul Mison
|
ABOUT THE LONDON RUBY USER GROUP
|
LRUG is the London Ruby User Group; a community of ruby developers based in and around London. We meet up at least once a month; on the 2nd Wednesday of the month we have meetings with talks, demos and such-like and then we have pub-based meetups organised on an ad-hoc basis (roughly half-way between meetings).
More about the London Ruby User Group
|
|
PODCAST ABSTRACTIONS FOR WEBSITE APIS
This session took part at the LRUG January. You can view the other 1 podcast here.
|
JAVASCRIPT & HTML5 COURSES
|
JAVASCRIPT & HTML5 PODCASTS
|
OTHER JAVASCRIPT & HTML5 EVENTS
|
Progressive .NET Tutorials 2012
CONFERENCE (3 DAYS)
London, Tuesday, May 29th
BOOK NOW!
|
|
The London Python Group
FREE EVENT:
Python code review
London, Wednesday, June 6th
|
|
Dutch Mobile Conference
CONFERENCE (3 DAYS)
Amsterdam , Thursday, June 7th
BOOK NOW!
|
|
London Ruby User Group
FREE EVENT:
ElasticSearch
, Monday, June 11th
|
|
Gavin Bell's Social Applications
2 DAY COURSE. Featuring Gavin Bell
London, Thursday, June 14th
|
|
QCon New York 2012
CONFERENCE (3 DAYS)
New York, Monday, June 18th
BOOK NOW!
|
|
Typesafe's Fast Track to Play
1 DAY COURSE.
London, Friday, June 22nd
|
|
Damjan Vujnovic's Advanced JavaScript Workshop
2 DAY COURSE. Featuring Damjan Vujnovic
London, Monday, June 25th
|
|
|
|
