## 更細(xì)節(jié)的接口設(shè)計(jì)指南
這里還有一些其他參考資料：
* 推薦參考文檔?[HTTP API Design Guide](https://github.com/interagent/http-api-design/)?來(lái)設(shè)計(jì) REST 風(fēng)格的 API ，只有以下兩點(diǎn)我個(gè)人并不建議參考：
* [Use consistent path formats](https://github.com/interagent/http-api-design/#use-consistent-path-formats)?還是不建議將動(dòng)作寫(xiě)在 URL 中，像文檔中的情況，可以將這個(gè)行為抽象成一個(gè)事務(wù)資源?`POST /runs/:run_id/stop-logs`?或者?`POST /runs/:run_id/stoppers`?來(lái)解決
* [Paginate with Ranges](https://github.com/interagent/http-api-design/#paginate-with-ranges)?確實(shí)是一個(gè)巧妙的設(shè)計(jì)，但似乎并不符合?`Content-Range`?的設(shè)計(jì)意圖，而且有可能和需要使用到?`Content-Range`?的正常場(chǎng)景沖突（雖然幾乎不可能），所以不推薦
* [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/)
