REST API：HTTP 方法（PUT、DELETE、POST、GET）的重要性

在RESTful API 領域，一個基本的問題出現了：為什麼要使用多種HTTP 請求類型，例如PUT、DELETE、POST 和GET？重要的是要了解 REST 的目的不僅僅是使用最簡單的方法存取資料。

REST 的角色

「表徵狀態轉移」(REST)架構提供了一種有意義的與資料互動的方式。發出 REST 請求時，應立即傳達要執行的預期操作。

範例：GET 請求

考慮以下REST 端點：

GET: /cars/make/chevrolet

此端點可能返回雪佛蘭汽車列表。透過使用 GET 請求，使用者明確指定他們想要檢索數據，而不是修改數據。

POST 請求：建立資料

用於建立新數據，通常使用 POST 請求。例如：

POST: /cars/
{ make:chevrolet, model:malibu, colors:[red, green, blue, grey] }

此 POST 請求發送資料以建立具有指定顏色的新雪佛蘭 Malibu。 API 不一定與底層資料庫結構綁定，而是提供一個屏蔽介面來保護真實資料。

冪等性與 HTTP 方法

HTTP 方法，如 GET 、PUT、DELETE遵循冪等性原則。這意味著重複呼叫這些方法應該會導致相同的伺服器狀態。另一方面，POST 通常被認為是非冪等的，因為它可能導致不同的伺服器狀態。

實現冪等性

為了確保POST 請求的冪等性，請考慮使用以下模式：

POST: /cars/oldest?action=delete

此端點明確定義要執行的操作（刪除），使其具有冪等性。相反，像這樣的請求：

Delete: /cars/oldest

可能是不明確且非冪等的。

總而言之，在REST API 不是任意的。它們用於傳達預期的操作（創建、讀取、更新、刪除）並確保系統的冪等性。透過遵守這些約定，REST API 提供了一種有意義且結構化的資料操作和互動方法。