RESTful?
Safety?
Stability?
Reusable?
大量使用别人的API,然后把每一次抓狂的经历记下来,自己设计API的时候把这些抓狂的地方都解决掉,就行了。
最烦的就是一票从来没用过API的人在那讨论哪种方式的API用着更舒服。
借鉴已有的库。一种特定功能的项目,肯定是以一种既定的模式发展下来的,你再去更改它的使用方式,别人就不习惯了。就比如说像wps之类的办公软件,其快捷键和界面布局完全是参照msoffice的。
- HTTP API 设计指南
- 用 JSON 构建 API 的标准指南
試玩下可編輯的API apigility