HTTP 與 REST

這是最常見的請求類型：一切以 HTTP 溝通的對象，首先就是 REST API。

在樹狀結構中按右鍵 ▸ 新增 ▸ HTTP 請求。

方法

GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS 與 QUERY。

URL

URL 的任何位置都接受 {{variables}} — 協定、主機、連接埠、路徑、查詢字串都可以。 解析後的值會顯示在欄位下方。

三份清單為 URL 補上細節：

• 查詢參數（?key=value）；
• 路徑參數，用來取代路徑中的具名區段；
• 標頭。

每一列都有啟用核取方塊、值的類型與說明。

內文

共有四類：

類型	用途
文字	JSON、XML、純文字 — 附語法高亮與重新格式化
檔案	傳送磁碟上某個檔案的內容
表單（multipart/form-data）	具名欄位，可夾帶檔案
x-www-form-urlencoded	編碼於內文中的具名欄位

選項

• 逾時：以毫秒為單位，僅套用於這個請求；未設定時則採用全域值。
• 跟隨重新導向：預設啟用。停用它即可觀察 3xx 本身及其 Location 標頭。

回應

狀態、時間、大小、標頭，以及依內容類型呈現的內文：可折疊的 JSON 檢視器、縮排過的 XML、圖片預覽、純文字。歷史記錄分頁則可取用先前的執行結果。

身分驗證

為請求附加一條身分驗證路由，標頭就會自動注入，權杖也會自動更新。請參閱 身分驗證。

伺服器模式

Restorm 也可以託管一個 HTTP 伺服器，用來測試用戶端如何消費它 — 通常就是您自己 應用程式的程式碼，暫時把它指向 localhost 試一試。

透過新增 ▸ HTTP 伺服器加入一個：它會在 localhost:<port><path> 上針對某個 方法與路徑的組合監聽，並以您在其中設定的狀態、標頭與內文回應。其他協定也以相同 方式託管 — 請參閱伺服器模式與 模擬 HTTP API。

程式碼片段

Code Snippets 分頁提供二十四種語言與程式庫：cURL、JavaScript（Fetch、Axios）、 TypeScript、Python（Requests、http.client、aiohttp）、原生 Node.js、Go、 Rust（reqwest）、Java（HttpClient、OkHttp）、C#（HttpClient）、PHP（cURL、Guzzle）、 Ruby（Net::HTTP、Faraday）、Swift（URLSession）、Kotlin（OkHttp）、Dart、R（httr）、 PowerShell、Elixir（HTTPoison）、Clojure（clj-http）。

用匯入取代手動輸入

您手上有 OpenAPI 規格、Postman 集合、HAR 檔案，或只是一行 curl 命令嗎？ 檔案 ▸ 匯入會替您重建整棵樹。請參閱 匯入與匯出。