Hacker News Reader

While this doesn't directly answer your question, I've found this to be helpful in the past: The Little Manual of API Design - http://chaos.troll.no/~shausman/api-design/api-design.pdf

I also like this josh bloch google tech talk video "How to design a good API and why it matters.": http://www.youtube.com/watch?v=aAb7hSCtvGw

awesome. I've been looking for something that talks about api design...