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