A good API reads like a good conversation: predictable, consistent and forgiving. Choose clear names, version carefully and return helpful errors.

Document with examples and keep changes backwards compatible whenever possible.

Your future self and your users will thank you.

本文来自: Notes on API Design