13.7K ·GitHub
这是什么？
这是一份 HTTP+JSON API 设计实践指南，提炼自 Heroku Platform API 的工作经验，涵盖资源命名、版本控制、错误处理和分页等内容。
这是一份 HTTP+JSON API 设计实践指南，提炼自 Heroku Platform API 的工作经验，涵盖资源命名、版本控制、错误处理和分页等内容。这是一个库，还是只是文档？这是一份文字指南（一本书或一份文档），不是需要安装或运行的代码。
这是一份文字指南（一本书或一份文档），不是需要安装或运行的代码。我该怎么阅读？想获得最佳阅读体验，可以通过 GitBook 在线阅读；也可以从仓库中的 Summary 目录开始，浏览 Markdown 源文件。
想获得最佳阅读体验，可以通过 GitBook 在线阅读；也可以从仓库中的 Summary 目录开始，浏览 Markdown 源文件。这是设计 API 的“唯一正确方式”吗？不是。作者明确表示，这只是一种统一且文档完善的方法，不一定是唯一的或最理想的方法。
不是。作者明确表示，这只是一种统一且文档完善的方法，不一定是唯一的或最理想的方法。这份指南适合谁看？API 设计人员。这份指南最初为 Heroku 的内部及平台 API 编写，但也希望对任何 HTTP+JSON API 的设计人员有所帮助。
API 设计人员。这份指南最初为 Heroku 的内部及平台 API 编写，但也希望对任何 HTTP+JSON API 的设计人员有所帮助。学习本指南前，我需要先了解 HTTP/JSON 吗？需要。本指南假定读者已熟悉 HTTP+JSON API 的基础知识，不会讲解这些基础内容。
需要。本指南假定读者已熟悉 HTTP+JSON API 的基础知识，不会讲解这些基础内容。这份指南有英文以外的语言版本吗？有。社区提供了多种译本，包括意大利语、简体中文、繁体中文、韩语、葡萄牙语、西班牙语和土耳其语。
有。社区提供了多种译本，包括意大利语、简体中文、繁体中文、韩语、葡萄牙语、西班牙语和土耳其语。当初为什么要创建这份指南？它提炼自 Heroku Platform API 的实际设计决策，旨在让各个 API 保持一致，同时避免没完没了地纠结设计细节。
它提炼自 Heroku Platform API 的实际设计决策，旨在让各个 API 保持一致，同时避免没完没了地纠结设计细节。What are similar projects?git-flight-rules, docker-cheat-sheet, api-guidelines, naming-cheatsheet, github-cheat-sheet, python-cheatsheet, learnxinyminutes-docs, rust-learning
git-flight-rules, docker-cheat-sheet, api-guidelines, naming-cheatsheet, github-cheat-sheet, python-cheatsheet, learnxinyminutes-docs, rust-learning