iT邦幫忙

2024 iThome 鐵人賽

DAY 7
0
生成式 AI

API: Swagger, Postman系列 第 7

API 請求與響應的基本概念(GET、POST、PUT、DELETE)

  • 分享至 

  • xImage
  •  

當談到 API 請求與響應時,這四種基本方法各自承擔著不同的角色,以下是對每種方法的詳細說明和常見使用情境:

  1. GET
    用途:從伺服器獲取資料。
    特點:
    不會改變伺服器上的任何數據。
    可以在網址中附加查詢參數,例如 ?id=123。
    一般用於檢索資源,如用戶資料、商品列表等。
    範例:你在瀏覽器中輸入一個網址,這會發送一個 GET 請求來獲取該頁面的內容。

  2. POST
    用途:向伺服器提交資料,通常用於創建新資源。
    特點:
    會改變伺服器上的數據(如新增用戶)。
    資料通常包含在請求的主體中,而不是網址中。
    常用於提交表單、上傳文件等。
    範例:填寫一個註冊表單並提交,這會發送一個 POST 請求,將用戶資訊發送到伺服器。

  3. PUT
    用途:用於更新已有資源。
    特點:
    通常需要提供完整的資源資料,並覆蓋原有的內容。
    在更新時,通常需要指定要更新的資源的識別碼。
    如果資源不存在,部分 API 也允許使用 PUT 創建新的資源。
    範例:編輯你的個人資料,發送一個 PUT 請求來更新資料,如姓名和電子郵件地址。

  4. DELETE
    用途:刪除伺服器上的資源。
    特點:
    直接影響伺服器上的數據,通常會移除指定的資源。
    常用於用戶刪除帳戶、移除商品等情況。
    範例:選擇刪除某個評論,這會發送一個 DELETE 請求,從伺服器中移除該評論。

總結
這四種 HTTP 方法共同構成了 RESTful API 的基本操作,讓我們能夠輕鬆地與伺服器進行數據交互。理解這些概念有助於在開發或使用 API 時更有效地管理資源。


上一篇
Swagger UI 界面簡介:面板和功能介紹。
下一篇
使用 Postman 發送一個 GET 請求。
系列文
API: Swagger, Postman30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言