Good REST API - http://horicky.blogspot.com/2012/03/designing-robust-web-api.html http://www.infoq.com/presentations/Building-a-Great-Web-API

Discussion of page object - http://martinfowler.com/bliki/PageObject.html

Difference API document tools - http://www.infoq.com/research/api-documentation