This is a great summary of rules for generating APIs, including many points I have not considered before. github.com/stickfigu…