Stuff and things Calum writes things of questionable importance here.

This list of common mistakes made in web APIs is excellent; many of the points apply equally well to APIs in general, especially remote ones.