更細(xì)節(jié)的接口設(shè)計指南

這里還有一些其他參考資料：

• 推薦參考文檔?HTTP API Design Guide?來設(shè)計 REST 風(fēng)格的 API ，只有以下兩點(diǎn)我個人并不建議參考：
  • Use consistent path formats?還是不建議將動作寫在 URL 中，像文檔中的情況，可以將這個行為抽象成一個事務(wù)資源?POST /runs/:run_id/stop-logs?或者?POST /runs/:run_id/stoppers?來解決
  • Paginate with Ranges?確實(shí)是一個巧妙的設(shè)計，但似乎并不符合?Content-Range?的設(shè)計意圖，而且有可能和需要使用到?Content-Range?的正常場景沖突（雖然幾乎不可能），所以不推薦
• Best Practices for Designing a Pragmatic RESTful API
• Thoughts on RESTful API Design
• The RESTful CookBook