## 更細節的接口設計指南 這里還有一些其他參考資料： * 推薦參考文檔?[HTTP API Design Guide](https://github.com/interagent/http-api-design/)?來設計 REST 風格的 API ，只有以下兩點我個人并不建議參考： * [Use consistent path formats](https://github.com/interagent/http-api-design/#use-consistent-path-formats)?還是不建議將動作寫在 URL 中，像文檔中的情況，可以將這個行為抽象成一個事務資源?`POST /runs/:run_id/stop-logs`?或者?`POST /runs/:run_id/stoppers`?來解決 * [Paginate with Ranges](https://github.com/interagent/http-api-design/#paginate-with-ranges)?確實是一個巧妙的設計，但似乎并不符合?`Content-Range`?的設計意圖，而且有可能和需要使用到?`Content-Range`?的正常場景沖突（雖然幾乎不可能），所以不推薦 * [Best Practices for Designing a Pragmatic RESTful API](http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api) * [Thoughts on RESTful API Design](http://restful-api-design.readthedocs.org/en/latest/) * [The RESTful CookBook](http://restcookbook.com/)