2.5. Github 的 Restful HTTP API 设计分解
什么是 RESTful
RESTful 是一种软件设计风格,由 Roy Fielding 在他的 论文 中提出,全称为 Representational State Transfer
,直译为表现层状态转移
,或许可以解释为用 URL 定位资源,用 HTTP 动词描述操作
,不用太纠结于定义,接下来我们会详细讨论。
RESTful 风格的接口,目前来看,实现的最好的就是 Github API,经常被效仿。接下来我们通过分析 Github API 来引出我们的 API 设计原则。
为什么选择 RESTful
我认为一套接口应该尽量满足以下几个原则:
- 安全可靠,高效,易扩展。
- 简单明了,可读性强,没有歧义。
- API 风格统一,调用规则,传入参数和返回数据有统一的标准。
我们当然可以根据自己的经验,或者参考知名公司的接口总结设计出一套满足要求的接口,但是...