HTTP API 设计指南

本指南描述了一组 HTTP+JSON API 设计实践，最初是从Heroku 平台 API 上的工作中提取的。

本指南介绍了该 API 的新增内容，并指导了 Heroku 的新内部 API。我们希望 Heroku 之外的 API 设计人员也会对它感兴趣。

我们在这里的目标是一致性和专注于业务逻辑，同时避免设计轮子。我们正在寻找一种良好、一致、有据可查的API设计方式，但不一定是“最终/理想模式”。

我们假设您熟悉 HTTP+JSON API 的基础知识，但不会涵盖本指南中的所有基础知识。

可在 gitbook 上以多种格式在线阅读。

我们欢迎对本指南的贡献。

目录见摘要。