1.應該場景
restful 是目前最流行的 api 設計規範[風格, 不是強制要求]，用於 web 資料介面的設計。
2.學習/操作
restful api 大原則容易把握，但是細節不容易做對。
本文總結 restful 的設計細節，介紹如何設計出易於理解和使用的 api。
restful api 設計指南 - 阮一峰的網路日誌 // 阮一峰 - restful api 設計指南簡潔 restful api 設計規範！整個人都清爽了！
rest - 廖雪峰的官方** // 廖雪峰 - rest
rest架構風格與restful api設計最佳實踐 // rest架構風格與restful api設計最佳實踐 - 2018-02-23
學院君 - 編寫 json api —— restful 風格 api 設計原則與最佳實踐
介紹就暫時不說了，仔細看下上面提供的文件，就大概明白了～mac後續補充lumen
tbd
3.問題/補充
一直沒有搞明白，微服務架構中，服務之間相互通訊，是通過呼叫api， 而且推薦時rest api
每個服務可以單獨部署，這裡是用什麼寫的，比如是採用web 框架，如：lumen 來寫？
解惑之道，tbd
4.參考
restful api 設計指南 - 阮一峰的網路日誌 // 阮一峰 - restful api 設計指南
簡潔 restful api 設計規範！整個人都清爽了！
rest - 廖雪峰的官方** // 廖雪峰 - rest
後續補充
RESTful API 最佳實踐
日期 2018年10月 3日 restful 是目前最流行的 api 設計規範，用於 web 資料介面的設計。它的大原則容易把握，但是細節不容易做對。本文總結 restful 的設計細節，介紹如何設計出易於理解和使用的 api restful 的核心思想就是，客戶端發出的資料操作指令都是 動詞 賓語...
最佳實踐 Restful API
本文介紹如何設計出易於理解和使用的api,restful api最佳實戰 restful的核心思想就是，客戶端發出的資料操作指令都是 動詞 賓語 的結構。比如，get articles這個命令，get是動詞，articles是賓語。動詞通常就是五種 http 方法，對應 crud 操作 根據 htt...
RESTful API 最佳實踐
本文首發於二 實戰小貼士 本節給出了有關 restful api 介面設計技巧速查表，可助你快速了解如何設計出最佳的 api 介面。三 http 請求方法 重點 本節講解 http 請求方法在 restful api 介面設計時的使用方法。四 api 命名規範 重點 本節講解如何設計出優秀的 api...