這份指南講述出自於 Heroku Platform API 的 HTTP + JSON API 設計方式，原本的點子來自 Wesley Beary 等人的 HTTP API Design Guide。
除了提到 API 本身之外，也介紹了 Heroku 內部 API，希望 Heroku 以外的 API 設計者也會感到興趣。
我們的目標是一致性並專注在商務邏輯，避免被瑣事耽擱。尋求的雖未必是 API 設計的終極之道，但卻是健全、一致，且有完整文件的方法。
我們假設您已熟悉基本的 HTTP + JSON API，因此本指南不會涵蓋所有的基本知識。