跳到內容

快速上手(5 分鐘)

目標:從全新安裝出發,做到一個已驗證的請求,其 URL 與權杖都來自變數。大約需要 五分鐘。

檔案 ▸ 新增Ctrl+N),然後用檔案 ▸ 另存新檔Ctrl+Shift+S)為它 命名,例如 demo.restorm

一個專案就是您磁碟上的一個普通檔案。您現在就可以把它放進 git 儲存庫 — Restorm 正是為此而設計的。

在側邊樹狀清單中按右鍵 ▸ 新增 ▸ 環境資料夾

環境資料夾(也稱為變數資料夾)是承載各個環境的容器 — localstagingproduction — 因此也承載您的 {{variables}}。它底下的所有請求都會繼承目前選取 的環境。

請開啟它,建立一個 local 環境,並在其中新增一個變數:

類型
baseUrl字串https://api.exemple.test

某個環境資料夾的分頁,停在「環境」子分頁上:左側是選取的環境,右側是它的 baseUrl 變數

在該資料夾上按右鍵 ▸ 新增 ▸ HTTP 請求。在開啟的分頁裡:

  • 方法保持在 GET
  • URL 輸入 {{baseUrl}}/health — 解析後的值會顯示在欄位下方,這是您的安全網;
  • 點選 Send

回應會在下方展開:狀態、耗時、大小、標頭,以及以可折疊的 JSON 檢視器呈現的 內文。

一個 URL 使用 {{baseUrl}} 的 HTTP 請求,右側開啟著回應面板 — 狀態、耗時、大小與 JSON 內文

比起把權杖硬寫進去,更好的做法是建立一個驗證請求:按右鍵 ▸ 新增 ▸ HTTP 驗證請求。設定用來取得權杖的那個呼叫(例如一個 POST /oauth/token),然後在它的設定分頁中宣告它會產生什麼:

產生的標頭
Authorization{{token_type}} {{access_token}}

這個值是一個針對驗證請求回應內文求值的運算式。順手把逾期運算式也填上 (例如 {{expires_in}}),Restorm 就會自動續發權杖。

回到您的 GET 請求,在上方的列中選擇這條驗證路由。從此每次送出都會注入該 標頭,而一個 401 會自動觸發續發並重試。

詳情:身分驗證

  • 已經有規格或集合了嗎?檔案 ▸ 匯入Ctrl+I)會重建整棵樹:請參閱 匯入與匯出
  • 用一個情境串接多個呼叫並驗證結果。
  • 讓這個情境在您的 CI 中執行: headless 執行