RESTAPI设计指南【转】

一段时间前,Heroku在其Github Repo发表了一篇关于HTTP API设计的经验和总结,这些经验都建立在Heroku Platform的开发和运维之上,非常值得借鉴。

Introduction

这篇文章展示了我们在Heroku Platform API 开发中具体HTTP+JSON API的设计实践。 同时,本文作为内部的设计指南也将继续规范Heroku的内部API开发,希望其他同仁也能对此感兴趣。 我们的目的是建立持久可靠的业务,并且只将精力集中于业务逻辑的开发,避免重复制造轮子。 我们一直在寻找一个优秀的,可靠的,文档齐全的API设计方法,但这种方法并不是最终的,唯一的。 在开始之前,我们假定你已经了解最基本的HTTP+JSON APIs,所以我们将不会赘述这些基本概念。

Read More