Usable REST APIs
About Javier Ramirez
Javier is a web developer working mainly in Ruby on Rails projects since 2006 and one of the founders of teowaki, a web service designed to make software development teams happier.
He is also the author of the book “Aptana RadRails: An IDE for Rails Development” and an active member of the Ruby scene, being a founding member of the Spanish Rails Conference, the Spanish Ruby Users Group (SRUG), madrid-rb, the Ruby users group in Madrid, and the Spanish Railscamp.
He is currently based in London —with regular trips to Madrid. In the past he’s worked in Zaragoza, Brescia, New York, Barcelona and Madrid.
Rails or Sinatra make really easy to create a (kinda) RESTful API but, in many occassions, these APIs are designed without really thinking on the developers that will have to use them.
I want to talk about some of the points that can help making your API more developer-friendly. Some of the areas I’ll cover will be discoverability, authentication, headers, formats, parameters, documentation and tools.
I will also provide a few tips about how to build your application first as a service, then adding the web/mobile/presentation layer.