API通用设计原则

什么是好的API？

· 完备（Be Complete）

对确定重点支持的用户场景具有完备的功能支持。就是说，用户通过对一组API的调用能够完成预期的功能。

· 不冗余（Be Minimal）

在完备的前提下，API只提供最小的功能集合。不缺少、不冗余。

· 简单清晰（Be Simple & Clear）

接口设计简单清晰。每个接口都有自己明确的语义，并只专注于尽量单一的功能。产品概念简单、关系清楚。

· 易于学习（Be Easy to Learn & Use）

符合用户的直觉；接口设计有统一的范式，用户可以举一反三。极致是没有文档用户也知道怎样调用接口。

· 可扩展（Be Extensible）

设计具有扩展性，能够在一定程序上适应变化，API在发展中具有“后向兼容性”（backward-compatibility）。