RESTful介紹

RESTful是一種常見的REST應用，是遵循REST風格的web服務，REST式的web服務是一種ROA（面向資源的架構）。

簡單的說：RESTful是一種架構的規範與約束、原則，符合這種規範的架構就是RESTful架構。

Restful風格api的特徵

1)基於“資源”，資料也好、服務也好，在RESTFul設計裡一切都是資源： URL中不能有動詞，都是名詞.
2)無狀態。一次呼叫一般就會返回結果，不存在類似於“開啟連線-訪問資料-關閉連線”這種依賴於上一次呼叫的情況。http請求一樣
3)URL中通常不出現動詞，只有名詞
4)URL語義清晰、明確
5)使用HTTP的GET(獲取)、POST(建立)、DELETE(刪除)、PUT(更新)來表示對於資源的增刪改查
6)出參使用JSON不使用XML.

7)URL中首先小寫字母。

8)URL路徑名詞均為複數

7)可選：HTTP狀態碼，在REST中都有特定的意義：200，201,202,204,400,401,403,500。比如401表示使用者身份認證失敗，403表示你驗證身份通過了，但這個資源你不能操作。

常見RestFul風格的api示例

http://api.config.net.cn/v1/books //GET: 獲取所有書籍

http://api.config.net.cn/v1/books?page=2&page_size=10 //GET: 獲取每頁10條第二頁中的書籍

http://api.config.net.cn/v1/books/ID //GET:獲取指定Id的書

http://api.config.net.cn/v1/orders //POST: 建立一個訂單

http://api.config.net.cn/v1/books //PUT: 更新一個書籍

http://api.config.net.cn/v1/orders/20210628 //DELETE:刪除一個訂單