# HTTP API 設計指南
> 原文:https://github.com/ZhangBohan/http-api-design-ZH_CN
> 翻譯自?`HTTP API Design Guide`?[https://github.com/interagent/http-api-design](https://github.com/interagent/http-api-design)
## 前言
這篇指南介紹描述了 HTTP+JSON API 的一種設計模式,最初摘錄整理自 Heroku 平臺的 API 設計指引[Heroku 平臺 API 指引](https://devcenter.heroku.com/articles/platform-api-reference)。
這篇指南除了詳細介紹現有的 API 外,Heroku 將來新加入的內部 API 也會符合這種設計模式,我們希望非 Heroku 員工的API設計者也能感興趣。
我們的目標是保持一致性,專注業務邏輯同時避免過度設計。我們一直試圖找出一種良好的、一致的、顯而易見的 API 設計方法,而并不是所謂的"最終/理想模式"。
我們假設你熟悉基本的 HTTP+JSON API 設計方法,所以本篇指南并不包含所有的 API 設計基礎。
我們歡迎你為這篇指南做[貢獻](https://github.com/interagent/http-api-design/blob/master/CONTRIBUTING.md)。