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

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

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

• 推薦參考文檔?HTTP API Design Guide?來(lái)設(shè)計(jì) REST 風(fēng)格的 API ，只有以下兩點(diǎn)我個(gè)人并不建議參考：
  • 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?確實(shí)是一個(gè)巧妙的設(shè)計(jì)，但似乎并不符合?Content-Range?的設(shè)計(jì)意圖，而且有可能和需要使用到?Content-Range?的正常場(chǎng)景沖突（雖然幾乎不可能），所以不推薦
• Best Practices for Designing a Pragmatic RESTful API
• Thoughts on RESTful API Design
• The RESTful CookBook