Re:So you want to offer a public API …
by Bjoern on Wednesday July 25, 2012 @01:30PM
(#4292001)
The best API design I have come across so far is from Zencoder [1]. Their documentation is spot on and they also have a nice little API builder. I found it interesting to study while doing designs for our own API.
[1] http://zencoder.com/api/
EDIT: After reading http://thereisnorightway.blogspot.jp/2011/02/versioning-and-... I am not so sure anymore. They still have quite an awesome set of examples though.