how to write a good api

个人觉得一套好的API应该在三个方面做到最好，注意是同时满足而不牺牲任何一个：

1. 精确的实现功能，不多不少；

2. 简洁明了，方便用户使用，不让他们迷糊；

3. 具备良好的可扩展性，遵循open-close原则；

当然最近我又学到一点，API应该易于理解和交流，过于深奥的设计是很容易被抛弃的。