API设计
一、优秀的API具有哪些特征：
1、易学易记；
2、可读性高；
3、不容易用错；
4、容易扩展；
5、具有完整性：用户通过API能去做想做的事情，但是这是比较困难的。即便如此，至少也应该方便扩展和定制化（例如通过继承等等）。当然，设计一个完整的API这可能需要一个过程，但起码得保证有一个清晰的设计思路，或者在朝着正确的方向迈出的一步，因为并不是每一个API从最开始就是很完美的。
二、设计过程
1、了解需求
在设计或实现一个API之前，你应该有一个good idea of the requirements。有时，需求相当明确，但在大多数情况下，您将需要梳理并分析这些需求。一个很好的着手点是让尽可能多的人知道（尤其是你的老板，你的同事，和潜在用户）他们想要看到的特性。
2、开始写任何代码前先描述用例
在写代码的时候，一个最常见的错误是先实现功能，然后再设计API，并最终发布API。用例反应需求，首先考虑做什么，然后才是考虑怎么做。在设计API时，不要去考虑实现的过程有多么复杂，而是去考虑是否能满足用户的需求和体验。
3、在同一个库中查找类似的API
在一个库中有多个API实现相同或者相近的功能是一件很糟糕的事情。
4、在实现API之前请先定义他
同开始写任何代码前请先描述用例一样。当我们在实现API之前也请先定义这个API。
5、让你的同事review你的API
6、写几个API的例子
7、准备用于扩展
8、不要发布未经过review的内部API
9、如果你对你的API存在疑问或者顾虑，请不要发布，或者标记为内部API或者稍后再重新思考
三、设计指南
1、观其名而知其意
2、名称不要有二义性，即使没有参考API的文档的前提下
3、不要让不相近的API，让人感觉他们相近——提防虚假的一致性
4、避免缩写
5、选择一个好的默认值
6、避免你的API过度智能
7、注意边缘的场景
8、The best API is no API