[SatyajitSarangi]

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.