Design API 需要做到的事情

公有API所要具备的特性

1. 稳定

这是让客户和合作伙伴投入产品的必要条件，

2. 可维护性

已开发的API 再次使用时不应该需要做特殊配置，理想化的状态是从读取系统中元数据并自动配置, UI配置尤其呀做到这点。

3. 可测试性

API 一定要支持测试驱动开发，已开发的API最好能支持自动化的测试用例， eg: 用junit等写自动测试用例

4.可升级性

一个稳定的API所必须的，现在大多数APIs需要被修改已达到更新的目的，所以得保证旧的程序不破坏新的程序中其他API。 这同时也反映出代码的兼容性，数据兼容性和功能的兼容性。

此外 API 最好还能支持支持不同的安全身份验证模型，例如流行的SSO，降低复杂度。

当然开发API还需要结合服务器和客户端，对平台有所区分。