Postman 是一個強大的 API 開發、測試和文檔化工具,廣泛用于開發者、測試人員和 API 設計者。以下是 Postman 的核心使用指南,涵蓋基礎操作到進階功能:
一、基礎使用
-
安裝與界面
- 下載:官網下載(支持 Windows/macOS/Linux)
- 界面組成:
- 側邊欄:Collections(集合)、APIs(API 文檔)、Environments(環境變量)
- 主工作區:請求構建區、響應展示區
-
發送第一個請求
- 新建請求 → 選擇方法(GET/POST 等)→ 輸入 URL(如
https://jsonplaceholder.typicode.com/posts/1
)→ 點擊 Send。 - 查看響應:Body(數據)、Headers(頭信息)、Status Code(狀態碼)。
- 新建請求 → 選擇方法(GET/POST 等)→ 輸入 URL(如
-
管理請求集合(Collections)
- 創建集合:點擊 + → 命名集合(如 “項目API”)。
- 添加請求:右鍵集合 → Add Request → 保存請求到集合。
二、核心功能
1. 參數與身份認證
- Query Params:URL 后加
?key=value&key2=value2
- Headers:添加
Content-Type: application/json
等 - 認證(Authorization):
- Bearer Token:直接填入 Token
- Basic Auth:輸入用戶名/密碼
- OAuth 2.0:配置 Token 獲取流程
2. 請求體(Body)
- raw:JSON/XML 等格式(常用
application/json
)
{"title": "Postman Guide","body": "Hello API!","userId": 1
}
- form-data:上傳文件或表單數據
- x-www-form-urlencoded:標準表單編碼
3. 環境變量(Environments)
- 創建環境(如 “Dev” / “Prod”):
- 添加變量(如
base_url = https://api.dev.com
)
- 添加變量(如
- 使用變量:請求 URL 中寫
{{base_url}}/login
- 切換環境:右上角環境選擇器。
三、自動化測試
-
編寫測試腳本(Tests 標簽頁)
- 使用 JavaScript 驗證響應:
// 檢查狀態碼 pm.test("Status 200", () => pm.response.to.have.status(200));// 驗證 JSON 數據 pm.test("Check user ID", () => {const jsonData = pm.response.json();pm.expect(jsonData.userId).to.eql(1); });
-
預請求腳本(Pre-request Script)
- 在發送請求前執行(如生成簽名、時間戳):
// 設置變量 pm.environment.set("token", "temp_token");
四、高級功能
-
Mock 服務器
- 創建 Mock Server:為集合生成模擬 API,返回預設響應。
- 用途:前端開發無需等待后端完成。
-
監控(Monitors)
- 定時運行集合:每天檢查 API 健康狀態(需登錄賬戶)。
-
文檔生成
- 集合右鍵 → View Documentation:自動生成 API 文檔并分享鏈接。
-
工作流(Collection Runner)
- 批量運行集合中的請求:
- 設置迭代次數
- 使用數據文件(JSON/CSV)驅動測試
- 批量運行集合中的請求:
五、快捷鍵
Ctrl + Enter
/Cmd + Enter
:發送請求Ctrl + S
/Cmd + S
:保存請求Ctrl + B
:聚焦到 URL 輸入框
六、常見問題
-
變量不生效?
- 檢查環境是否選中 → 變量名拼寫(
{{name}}
)→ 作用域(全局/環境/集合)。
- 檢查環境是否選中 → 變量名拼寫(
-
跨域問題(CORS)?
- Postman 不受瀏覽器跨域限制,但測試時若遇到需后端配置 CORS 頭。
-
保存響應數據
- 響應區點擊 Save Response → 保存為文件。
七、學習資源
- 官方文檔:https://learning.postman.com/
- 模板庫:Template → 搜索 GitHub/Twitter 等 API 模板
通過 Postman,你可以高效管理 API 生命周期。遇到具體問題(如 OAuth 配置、腳本編寫)可進一步提問!