News for hackers. Stuff that matters.
Re:Your API Consumers Aren’t Who You Think They Are by SatyajitSarangi on Tuesday June 25, 2013 @02:05AM (#5937822)
Excellent post.

I created JustMigrate so I had to work with APIs of Tumblr and Posterous. Having had experience in building APIs and working with APIs of almost all the premium/famous/infamous services around, I was shocked when I came across Posterous API documentation.

Shocked in a beautiful way, as I couldn't believe how easy it was to understand. The API had realtime implementations right there, where you can enter values and check the response that you are getting.

Most API developers except users to use some scripting language or Poster to deal with the APIs to understand the response. Sometimes they give away code snippets, some of the times they will list down all the libraries that people built on top of the API, thus ensuring that the documentation bulk was the responsibility of the library developers. I was glad to see Posterous didnt' stick to that norm.

There are no comments on this comment yet.