API设计原则

• API必须要提供充分的功能，以供调用者完成自己的任务。
• API应该是最精简的，不要为调用者带来多余的不便。
• 如果没有理解API的使用环境的话，那也就不能去设计它。
• 通用性的API应当是与具体使用场景无关的，而特定用途的API则要充分考虑使用策略。
• API应该从调用者的角度来进行设计。
• 好的API绝不推卸责任，把自己该做的事情留给别人。
• 在实现API之前，就应该把API文档化。
• 好的API应当符合工效学（Ergonomic）。