This took some finding but I read your question and remembered coming across one particular article which made a lot of things clear for me when I was looking into building the API for my startup.

Check out "Get Your API Right" by Trek - http://wonderfullyflawed.com/2009/07/02/get-your-api-right.h...