如何写出优秀的API?

Question

RESTful?
Safety?
Stability?
Reusable?

Answer 1

• HTTP API 设计指南
• 用 JSON 构建 API 的标准指南

Answer 2

大量使用别人的API，然后把每一次抓狂的经历记下来，自己设计API的时候把这些抓狂的地方都解决掉，就行了。

最烦的就是一票从来没用过API的人在那讨论哪种方式的API用着更舒服。

Answer 3

試玩下可編輯的API apigility

Answer 4

借鉴已有的库。一种特定功能的项目，肯定是以一种既定的模式发展下来的，你再去更改它的使用方式，别人就不习惯了。就比如说像wps之类的办公软件，其快捷键和界面布局完全是参照msoffice的。