Home

Awesome

HTTP API 設計指南

簡介

這份指南講述出自於 Heroku Platform API 的 HTTP + JSON API 設計方式,原本的點子來自 Wesley Beary 等人的 HTTP API Design Guide

除了提到 API 本身之外,也介紹了 Heroku 內部 API,希望 Heroku 以外的 API 設計者也會感到興趣。

我們的目標是一致性並專注在商務邏輯,避免被瑣事耽擱。尋求的雖未必是 API 設計的終極之道,但卻是健全、一致,且有完整文件的方法

我們假設您已熟悉基本的 HTTP + JSON API,因此本指南不會涵蓋所有的基本知識。

歡迎一同為這份指南貢獻心力,本書的貢獻者見此

版本