You might want to check out The Little Manual of API Design:

http://www4.in.tum.de/~blanchet/api-design.pdf