當你寫完一支 RESTful API,你會怎麼測試它?
手動輸入 URL?自己寫前端串接?用 curl 試半天?
別再這麼辛苦了,Postman 是專為開發者設計的 API 測試利器,幫你快速發送請求、管理測試案例、模擬授權流程,甚至還能自動化 API 測試與產生文件。
這篇文章將從最基本的 GET 測試開始,一步步教你掌握 Postman 的常見功能與實務應用。
一、什麼是 Postman?
Postman 是一款提供 GUI 操作的 API 測試工具,支援:
-
發送 HTTP/HTTPS 請求(GET、POST、PUT、DELETE 等)
-
設定 Headers、Body、Params、Auth 等細節
-
儲存與管理測試組合
-
支援環境變數、測試腳本、自動化流程
無論你是寫 API 的後端工程師,還是串接 API 的前端或行動開發者,Postman 都能讓你更高效工作。
二、安裝 Postman
你可以選擇:
-
官方網站下載桌面版:https://www.postman.com/downloads/
-
使用 Postman Web 版(需註冊帳號)
建議使用桌面版,功能完整且反應速度快。
三、第一個請求:發送 GET
以 JSONPlaceholder 測試 API 為例:
步驟:
-
打開 Postman,點選「+」新增一個請求
-
輸入 URL:
https://jsonplaceholder.typicode.com/users -
方法選擇 GET
-
點擊「Send」
你會看到一串 JSON 資料,這就是從遠端伺服器拿到的回應。
四、發送 POST 請求:新增一筆資料
-
URL:
https://jsonplaceholder.typicode.com/posts -
方法:POST
-
點選「Body」,選擇「raw」+「JSON」格式
-
填入以下內容:
{
"title": "Hello",
"body": "This is a test post",
"userId": 1
}
-
點擊「Send」即可看到新增結果與 ID
五、設定 Headers、Params、Auth
-
Headers:常用來設定 Content-Type、Token 等
-
Params:可視化管理 URL 查詢參數(例如
?id=1&name=John) -
Authorization:支援 Bearer Token、Basic Auth、OAuth 等常見機制
你不需要手動拼接字串,Postman 幫你全部做好。
六、建立 Collection:管理你的 API 測試清單
你可以將所有相關 API 整理進一個 Collection,方便管理與重複測試:
-
支援拖曳排序
-
可一鍵執行多組請求
-
支援夾帶環境變數(如 dev、prod API)
這對團隊開發與自動化測試極有幫助。
七、自動化測試與斷言(Tests)
在每個請求下方的「Tests」分頁中,你可以寫 JavaScript 檢查回應內容,例如:
pm.test("Status code is 200", function () {
pm.response.to.have.status(200);
});
pm.test("Response has userId", function () {
var jsonData = pm.response.json();
pm.expect(jsonData).to.have.property("userId");
});
這樣可以在你發送請求後,立即驗證 API 是否正確回應。
八、結語:Postman 是你寫 API 時最好的幫手
如果你每天都要測 API,Postman 能幫你節省大量時間。
從單一請求測試、Header 與 Body 管理,到自動化測試與文件產出,它都是開發過程中不可或缺的工具之一。
不要再用 curl 拼字串,Postman 幫你把一切流程變得更簡單、更直覺、更專業。
評論