可快速瀏覽的每個 HTTP 請求方法參考——GET、POST、PUT、PATCH、DELETE 等,加上 WebDAV——一目了然地顯示每個方法是否安全、冪等和可快取、是否接受主體,以及典型範例。在瀏覽器中、免費使用。

每個標準 HTTP 請求方法及其語意並列呈現。一切都從內建參考在您的瀏覽器中執行——不向伺服器傳送任何內容。

方法 用途 安全 冪等 可快取 主體 典型用途
沒有符合您搜尋的方法。
請嘗試其他名稱或詞彙——例如 PATCH、idempotent 或 cache。
視情況 選用 不建議

關於 HTTP 方法

這份 HTTP 方法參考資料,將每一個標準請求方法──GET、HEAD、POST、PUT、PATCH、DELETE、CONNECT、OPTIONS 和 TRACE──加上常見的 WebDAV 擴充方法,整理成一份易於瀏覽的表格。針對每個方法,它都會回答開發者實際會思考的問題:是否安全(safe)、是否幂等(idempotent)、是否可快取,是否帶有請求主體,以及一個典型用法範例。

這三項語意屬性會直接影響實際的設計決策。安全方法屬於唯讀操作,可以自由地預先擷取;幂等方法可以在網路故障後重試而不會產生副作用,這正是代理伺服器與 HTTP 客戶端所假設的行為;而可快取性則決定回應是否可以被儲存並重複使用。

搜尋可比對方法名稱、屬性與使用情境──PATCH、idempotent 和 cache 都能篩選出對應的表格列──並有一個群組切換開關,用來區分標準方法與 WebDAV 方法集合。每個方法名稱都能一鍵複製到剪貼簿。

如何使用 HTTP 方法

  1. 瀏覽表格,比較各方法在「安全」、「幂等」、「可快取」和「主體」欄位上的差異。
  2. 依名稱、屬性或使用情境搜尋──例如 PUT、idempotent 或 upload。
  3. 切換「標準」與「WebDAV」群組,以納入或排除擴充方法。
  4. 將滑鼠停留在欄位標題上,查看每個屬性的白話說明。
  5. 點擊複製按鈕,為你的 API 規格或測試取得方法名稱。

常見問題

安全表示該請求完全不會改變伺服器狀態──GET 和 HEAD 都是唯讀的。幂等則表示重複發送同一個請求,效果與只發送一次相同──DELETE 是幂等的,但不是安全的,因為第一次呼叫確實會改變狀態。

PUT 會用你傳送的內容整個取代整份資源,並且是幂等的。PATCH 則套用局部修改──只有你包含的欄位會改變──且不保證幂等。完整替換時使用 PUT,針對性更新則使用 PATCH。

因為客戶端、代理伺服器和 SDK 會在逾時或連線中斷後自動重試幂等請求。若盲目重試非幂等的 POST,可能會建立重複的訂單或紀錄,這也是為什麼付款 API 通常會搭配使用幂等金鑰(idempotency key)。

GET 和 HEAD 的回應預設可快取。POST 的回應只有在明確的新鮮度標頭允許時才可能被快取,這種情況在實務上很少見。其他方法都不可快取──它們的回應不應被儲存並重複使用。

WebDAV 擴充了 HTTP 以支援遠端檔案管理,新增了 PROPFIND、MKCOL、COPY、MOVE、LOCK 和 UNLOCK 等方法。當你使用 WebDAV 伺服器、以此為基礎建構的行事曆/聯絡人協定,或是網路磁碟機整合時,就會遇到這些方法。

是的。整份表格完全免費,並且在你的瀏覽器中依內建資料集運作──搜尋與篩選不會傳送任何內容到伺服器。

需要協助?
使用此工具時遇到問題?請告訴我們的團隊。
回報問題

將此免費工具新增到你自己的網站 — 複製並貼上下面的程式碼。