當談到 API 請求與響應時,這四種基本方法各自承擔著不同的角色,以下是對每種方法的詳細說明和常見使用情境:
GET
用途:從伺服器獲取資料。
特點:
不會改變伺服器上的任何數據。
可以在網址中附加查詢參數,例如 ?id=123。
一般用於檢索資源,如用戶資料、商品列表等。
範例:你在瀏覽器中輸入一個網址,這會發送一個 GET 請求來獲取該頁面的內容。
POST
用途:向伺服器提交資料,通常用於創建新資源。
特點:
會改變伺服器上的數據(如新增用戶)。
資料通常包含在請求的主體中,而不是網址中。
常用於提交表單、上傳文件等。
範例:填寫一個註冊表單並提交,這會發送一個 POST 請求,將用戶資訊發送到伺服器。
PUT
用途:用於更新已有資源。
特點:
通常需要提供完整的資源資料,並覆蓋原有的內容。
在更新時,通常需要指定要更新的資源的識別碼。
如果資源不存在,部分 API 也允許使用 PUT 創建新的資源。
範例:編輯你的個人資料,發送一個 PUT 請求來更新資料,如姓名和電子郵件地址。
DELETE
用途:刪除伺服器上的資源。
特點:
直接影響伺服器上的數據,通常會移除指定的資源。
常用於用戶刪除帳戶、移除商品等情況。
範例:選擇刪除某個評論,這會發送一個 DELETE 請求,從伺服器中移除該評論。
總結
這四種 HTTP 方法共同構成了 RESTful API 的基本操作,讓我們能夠輕鬆地與伺服器進行數據交互。理解這些概念有助於在開發或使用 API 時更有效地管理資源。