General Advice


 * http://37signals.com/svn/posts/3018-api-design-for-humans
 * http://blog.programmableweb.com/2010/08/13/api-anti-patterns-how-to-avoid-common-rest-mistakes/
 * http://readwrite.com/2010/08/19/the-new-api-movement-may#awesm=~ohDK8Da9fWHQp4
 * http://techcrunch.com/2009/11/08/the-top-10-most-common-api-pitfalls/
 * http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api (most of these fairly good - some not so much).
 * http://martinfowler.com/articles/richardsonMaturityModel.html
 * http://brandur.org/accessible-apis
 * http://t.co/B27lYbFqxV (https://twitter.com/CodenvyHQ/status/389385046185869313)