https://chihhung.github.io/Blog/tags/postman/Recent content in Postman on Eric 個人部落格Hugo -- 0.151.0zh-TWTue, 19 May 2026 00:00:00 +0800https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/%E5%B7%A5%E5%85%B7/postman%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/Tue, 19 May 2026 00:00:00 +0800https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/%E5%B7%A5%E5%85%B7/postman%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/<blockquote> <p><strong>版本</strong>：2.0<br> <strong>最後更新</strong>：2026 年 5 月 19 日 <strong>適用對象</strong>：後端工程師、前端工程師、QA 工程師、系統架構師、DevOps 工程師<br> <strong>定位</strong>：企業內部標準教材<br> <strong>文件維護</strong>：內部技術團隊<br> <strong>適用於</strong>：Postman v12.x（2026 年最新穩定版，向下相容 v11.x）<br> <strong>Created by</strong>：Eric Cheng</p></blockquote> <h1 id="postman-教學手冊">Postman 教學手冊</h1> <h2 id="-教學大綱">📋 教學大綱</h2> <ol> <li><a href="#1-postman-%E7%B0%A1%E4%BB%8B%E8%88%87%E6%A6%82%E8%A7%80">Postman 簡介與概觀</a> <ul> <li><a href="#11-postman-%E6%98%AF%E4%BB%80%E9%BA%BC">1.1 Postman 是什麼？</a></li> <li><a href="#12-%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E7%B8%BD%E8%A6%BD">1.2 核心功能總覽</a></li> <li><a href="#13-postman-%E5%B9%B3%E5%8F%B0%E6%9E%B6%E6%A7%8B">1.3 Postman 平台架構</a></li> <li><a href="#14-%E7%89%88%E6%9C%AC%E8%88%87%E6%8E%88%E6%AC%8A%E6%96%B9%E6%A1%88">1.4 版本與授權方案</a></li> <li><a href="#15-%E8%88%87%E5%90%8C%E9%A1%9E%E5%B7%A5%E5%85%B7%E6%AF%94%E8%BC%83">1.5 與同類工具比較</a></li> <li><a href="#16-%E9%81%A9%E7%94%A8%E5%A0%B4%E6%99%AF%E8%88%87%E4%B8%8D%E9%81%A9%E7%94%A8%E5%A0%B4%E6%99%AF">1.6 適用場景與不適用場景</a></li> </ul> </li> <li><a href="#2-%E5%AE%89%E8%A3%9D%E8%88%87%E7%92%B0%E5%A2%83%E8%A8%AD%E5%AE%9A">安裝與環境設定</a> <ul> <li><a href="#21-%E6%A1%8C%E9%9D%A2%E6%87%89%E7%94%A8%E7%A8%8B%E5%BC%8F%E5%AE%89%E8%A3%9D">2.1 桌面應用程式安裝</a></li> <li><a href="#22-%E7%B6%B2%E9%A0%81%E7%89%88%E8%88%87-vs-code-extension">2.2 網頁版與 VS Code Extension</a></li> <li><a href="#23-%E5%B8%B3%E8%99%9F%E8%A8%BB%E5%86%8A%E8%88%87%E7%99%BB%E5%85%A5">2.3 帳號註冊與登入</a></li> <li><a href="#24-%E4%BB%8B%E9%9D%A2%E5%B0%8E%E8%A6%BD">2.4 介面導覽</a></li> <li><a href="#25-%E4%BC%81%E6%A5%AD%E7%B6%B2%E8%B7%AF%E8%A8%AD%E5%AE%9Aproxy--ssl">2.5 企業網路設定（Proxy / SSL）</a></li> <li><a href="#26-%E5%9C%98%E9%9A%8A%E5%88%9D%E5%A7%8B%E5%8C%96%E8%A8%AD%E5%AE%9A">2.6 團隊初始化設定</a></li> </ul> </li> <li><a href="#3-%E6%A0%B8%E5%BF%83%E6%A6%82%E5%BF%B5">核心概念</a> <ul> <li><a href="#31-workspaces%E5%B7%A5%E4%BD%9C%E5%8D%80">3.1 Workspaces（工作區）</a></li> <li><a href="#32-collections%E9%9B%86%E5%90%88">3.2 Collections（集合）</a></li> <li><a href="#33-environments-%E8%88%87-variables">3.3 Environments 與 Variables</a></li> <li><a href="#34-authorization%E8%AA%8D%E8%AD%89%E8%88%87%E6%8E%88%E6%AC%8A">3.4 Authorization（認證與授權）</a></li> <li><a href="#35-postman-console">3.5 Postman Console</a></li> </ul> </li> <li><a href="#4-%E7%99%BC%E9%80%81-api-%E8%AB%8B%E6%B1%82">發送 API 請求</a> <ul> <li><a href="#41-%E5%BB%BA%E7%AB%8B%E8%88%87%E7%99%BC%E9%80%81-http-%E8%AB%8B%E6%B1%82">4.1 建立與發送 HTTP 請求</a></li> <li><a href="#42-request-body-%E6%A0%BC%E5%BC%8F">4.2 Request Body 格式</a></li> <li><a href="#43-response-%E6%AA%A2%E8%A6%96%E8%88%87%E5%88%86%E6%9E%90">4.3 Response 檢視與分析</a></li> <li><a href="#44-graphql-%E8%AB%8B%E6%B1%82">4.4 GraphQL 請求</a></li> <li><a href="#45-grpc-%E8%88%87-websocket">4.5 gRPC 與 WebSocket</a></li> <li><a href="#46-cookie-%E8%88%87-certificate-%E7%AE%A1%E7%90%86">4.6 Cookie 與 Certificate 管理</a></li> </ul> </li> <li><a href="#5-%E8%AE%8A%E6%95%B8%E8%88%87%E7%92%B0%E5%A2%83%E7%AE%A1%E7%90%86">變數與環境管理</a> <ul> <li><a href="#51-%E8%AE%8A%E6%95%B8%E4%BD%9C%E7%94%A8%E5%9F%9F%E8%88%87%E5%84%AA%E5%85%88%E9%A0%86%E5%BA%8F">5.1 變數作用域與優先順序</a></li> <li><a href="#52-%E5%8B%95%E6%85%8B%E8%AE%8A%E6%95%B8">5.2 動態變數</a></li> <li><a href="#53-%E7%92%B0%E5%A2%83%E5%88%87%E6%8F%9B%E7%AD%96%E7%95%A5">5.3 環境切換策略</a></li> <li><a href="#54-postman-vault%E6%95%8F%E6%84%9F%E8%B3%87%E6%96%99%E7%AE%A1%E7%90%86">5.4 Postman Vault（敏感資料管理）</a></li> <li><a href="#55-%E8%B3%87%E6%96%99%E6%AA%94%E6%A1%88%E9%A9%85%E5%8B%95csv--json">5.5 資料檔案驅動（CSV / JSON）</a></li> </ul> </li> <li><a href="#6-%E8%85%B3%E6%9C%AC%E9%96%8B%E7%99%BCtests--scripts">腳本開發（Tests &amp; Scripts）</a> <ul> <li><a href="#61-pre-request-script">6.1 Pre-request Script</a></li> <li><a href="#62-post-response-script%E6%B8%AC%E8%A9%A6%E6%96%B7%E8%A8%80">6.2 Post-response Script（測試斷言）</a></li> <li><a href="#63-pm-api-%E5%AE%8C%E6%95%B4%E5%8F%83%E8%80%83">6.3 pm API 完整參考</a></li> <li><a href="#64-chai-assertion-library">6.4 Chai Assertion Library</a></li> <li><a href="#65-%E8%AB%8B%E6%B1%82%E9%8F%88%E7%B5%90chaining-requests">6.5 請求鏈結（Chaining Requests）</a></li> <li><a href="#66-%E5%B8%B8%E8%A6%8B%E6%B8%AC%E8%A9%A6%E7%AF%84%E4%BE%8B">6.6 常見測試範例</a></li> <li><a href="#67-%E5%8F%AF%E9%87%8D%E7%94%A8%E8%85%B3%E6%9C%ACpackage-library">6.7 可重用腳本（Package Library）</a></li> </ul> </li> <li><a href="#7-collection-runner-%E8%88%87%E8%87%AA%E5%8B%95%E5%8C%96%E6%B8%AC%E8%A9%A6">Collection Runner 與自動化測試</a> <ul> <li><a href="#71-collection-runner-%E4%BD%BF%E7%94%A8">7.1 Collection Runner 使用</a></li> <li><a href="#72-%E5%9F%B7%E8%A1%8C%E9%A0%86%E5%BA%8F%E6%8E%A7%E5%88%B6">7.2 執行順序控制</a></li> <li><a href="#73-data-driven-testing">7.3 Data-Driven Testing</a></li> <li><a href="#74-%E6%95%88%E8%83%BD%E6%B8%AC%E8%A9%A6">7.4 效能測試</a></li> <li><a href="#75-%E6%95%B4%E5%90%88%E6%B8%AC%E8%A9%A6%E8%88%87%E5%9B%9E%E6%AD%B8%E6%B8%AC%E8%A9%A6">7.5 整合測試與回歸測試</a></li> </ul> </li> <li><a href="#8-postman-cli-%E8%88%87-cicd-%E6%95%B4%E5%90%88">Postman CLI 與 CI/CD 整合</a> <ul> <li><a href="#81-postman-cli-%E5%AE%89%E8%A3%9D%E8%88%87%E8%A8%AD%E5%AE%9A">8.1 Postman CLI 安裝與設定</a></li> <li><a href="#82-%E5%91%BD%E4%BB%A4%E5%88%97%E5%9F%B7%E8%A1%8C-collection">8.2 命令列執行 Collection</a></li> <li><a href="#83-newman%E5%82%B3%E7%B5%B1-cli">8.3 Newman（傳統 CLI）</a></li> <li><a href="#84-github-actions-%E6%95%B4%E5%90%88">8.4 GitHub Actions 整合</a></li> <li><a href="#85-jenkins--azure-devops-%E6%95%B4%E5%90%88">8.5 Jenkins / Azure DevOps 整合</a></li> </ul> </li> <li><a href="#9-api-%E8%A8%AD%E8%A8%88%E8%88%87%E6%96%87%E4%BB%B6">API 設計與文件</a> <ul> <li><a href="#91-spec-hubopenapi--asyncapi">9.1 Spec Hub（OpenAPI / AsyncAPI）</a></li> <li><a href="#92-mock-server-%E8%A8%AD%E5%AE%9A">9.2 Mock Server 設定</a></li> <li><a href="#93-api-%E6%96%87%E4%BB%B6%E7%94%A2%E7%94%9F%E8%88%87%E7%99%BC%E5%B8%83">9.3 API 文件產生與發布</a></li> <li><a href="#94-%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%E8%88%87-native-git">9.4 版本管理與 Native Git</a></li> <li><a href="#95-sdk-generationsdk-%E7%94%A2%E7%94%9F">9.5 SDK Generation（SDK 產生）</a></li> <li><a href="#96-api-catalogenterprise">9.6 API Catalog（Enterprise）</a></li> </ul> </li> <li><a href="#10-postman-flows">Postman Flows</a> <ul> <li><a href="#101-flows-%E6%A6%82%E5%BF%B5%E8%88%87%E7%94%A8%E9%80%94">10.1 Flows 概念與用途</a></li> <li><a href="#102-%E5%BB%BA%E7%AB%8B%E8%A6%96%E8%A6%BA%E5%8C%96%E5%B7%A5%E4%BD%9C%E6%B5%81">10.2 建立視覺化工作流</a></li> <li><a href="#103-%E5%AF%A6%E5%8B%99%E6%A1%88%E4%BE%8B">10.3 實務案例</a></li> </ul> </li> <li><a href="#11-ai-%E5%8A%9F%E8%83%BDagent-mode">AI 功能（Agent Mode）</a> <ul> <li><a href="#111-postman-ai-%E5%8A%9F%E8%83%BD%E7%B8%BD%E8%A6%BD">11.1 Postman AI 功能總覽</a></li> <li><a href="#112-agent-mode-%E6%B7%B1%E5%BA%A6%E6%8C%87%E5%8D%97">11.2 Agent Mode 深度指南</a></li> <li><a href="#113-mcp-server-%E8%88%87-mcp-client-%E6%95%B4%E5%90%88">11.3 MCP Server 與 MCP Client 整合</a></li> <li><a href="#114-ai-credits-%E7%AE%A1%E7%90%86%E8%88%87%E6%9C%80%E4%BD%B3%E5%8C%96">11.4 AI Credits 管理與最佳化</a></li> </ul> </li> <li><a href="#12-%E5%9C%98%E9%9A%8A%E5%8D%94%E4%BD%9C">團隊協作</a> <ul> <li><a href="#121-%E5%9C%98%E9%9A%8A%E5%BB%BA%E7%AB%8B%E8%88%87%E7%AE%A1%E7%90%86">12.1 團隊建立與管理</a></li> <li><a href="#122-%E8%A7%92%E8%89%B2%E8%88%87%E6%AC%8A%E9%99%90">12.2 角色與權限</a></li> <li><a href="#123-version-controlfork--pull-request--merge">12.3 Version Control（Fork / Pull Request / Merge）</a></li> <li><a href="#124-%E5%9C%98%E9%9A%8A%E5%B7%A5%E4%BD%9C%E5%8D%80%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">12.4 團隊工作區最佳實務</a></li> </ul> </li> <li><a href="#13-%E5%AE%89%E5%85%A8%E6%B2%BB%E7%90%86%E8%88%87-api-governance">安全治理與 API Governance</a> <ul> <li><a href="#131-postman-secret-scanner">13.1 Postman Secret Scanner</a></li> <li><a href="#132-postman-vault-%E8%88%87%E7%AC%AC%E4%B8%89%E6%96%B9%E6%95%B4%E5%90%88">13.2 Postman Vault 與第三方整合</a></li> <li><a href="#133-api-governance-rules">13.3 API Governance Rules</a></li> <li><a href="#134-sso--scim--audit-log">13.4 SSO / SCIM / Audit Log</a></li> <li><a href="#135-byok-%E8%88%87-data-residency">13.5 BYOK 與 Data Residency</a></li> </ul> </li> <li><a href="#14-%E7%9B%A3%E6%8E%A7%E8%88%87%E6%95%88%E8%83%BD">監控與效能</a> <ul> <li><a href="#141-monitor-%E8%A8%AD%E5%AE%9A%E8%88%87%E6%8E%92%E7%A8%8B">14.1 Monitor 設定與排程</a></li> <li><a href="#142-%E6%95%88%E8%83%BD%E6%8C%87%E6%A8%99%E8%88%87%E5%91%8A%E8%AD%A6">14.2 效能指標與告警</a></li> <li><a href="#143-insightsenterprise">14.3 Insights（Enterprise）</a></li> </ul> </li> <li><a href="#15-%E6%95%B4%E5%90%88%E8%88%87%E6%93%B4%E5%85%85">整合與擴充</a> <ul> <li><a href="#151-%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B7%A5%E5%85%B7%E6%95%B4%E5%90%88">15.1 第三方工具整合</a></li> <li><a href="#152-postman-api-%E4%BD%BF%E7%94%A8">15.2 Postman API 使用</a></li> <li><a href="#153-webhook-%E8%88%87%E8%87%AA%E8%A8%82%E6%95%B4%E5%90%88">15.3 Webhook 與自訂整合</a></li> </ul> </li> <li><a href="#16-%E4%BC%81%E6%A5%AD%E5%B0%8E%E5%85%A5%E7%AD%96%E7%95%A5">企業導入策略</a> <ul> <li><a href="#161-%E8%A9%95%E4%BC%B0%E8%88%87%E5%B0%8E%E5%85%A5%E8%B7%AF%E7%B7%9A%E5%9C%96">16.1 評估與導入路線圖</a></li> <li><a href="#162-%E6%96%B9%E6%A1%88%E9%81%B8%E6%93%87%E8%88%87%E5%9C%98%E9%9A%8A%E5%9F%B9%E8%A8%93">16.2 方案選擇與團隊培訓</a></li> <li><a href="#163-%E6%A8%99%E6%BA%96%E5%8C%96%E8%A6%8F%E7%AF%84">16.3 標準化規範</a></li> </ul> </li> <li><a href="#17-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99%E8%88%87%E5%8F%8D%E6%A8%A1%E5%BC%8F">最佳實務與反模式</a> <ul> <li><a href="#171-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">17.1 最佳實務</a></li> <li><a href="#172-%E5%B8%B8%E8%A6%8B%E5%8F%8D%E6%A8%A1%E5%BC%8F">17.2 常見反模式</a></li> </ul> </li> <li><a href="#18-%E5%B8%B8%E8%A6%8B%E5%95%8F%E9%A1%8C%E8%88%87%E9%99%A4%E9%8C%AFfaq">常見問題與除錯（FAQ）</a></li> <li><a href="#19-%E9%99%84%E9%8C%84">附錄</a> <ul> <li><a href="#191-pm-api-%E9%80%9F%E6%9F%A5%E8%A1%A8">19.1 pm API 速查表</a></li> <li><a href="#192-chai-assertion-%E9%80%9F%E6%9F%A5%E8%A1%A8">19.2 Chai Assertion 速查表</a></li> <li><a href="#193-http-status-code-%E9%80%9F%E6%9F%A5%E8%A1%A8">19.3 HTTP Status Code 速查表</a></li> <li><a href="#194-%E5%BF%AB%E6%8D%B7%E9%8D%B5%E9%80%9F%E6%9F%A5%E8%A1%A8">19.4 快捷鍵速查表</a></li> <li><a href="#195-%E6%96%B0%E4%BA%BA%E4%B8%8A%E6%89%8B-checklist">19.5 新人上手 Checklist</a></li> <li><a href="#196-api-%E6%B8%AC%E8%A9%A6-checklist">19.6 API 測試 Checklist</a></li> <li><a href="#197-%E5%AE%89%E5%85%A8%E6%80%A7-checklist">19.7 安全性 Checklist</a></li> </ul> </li> </ol> <hr> <h2 id="1-postman-簡介與概觀">1. Postman 簡介與概觀</h2> <h3 id="11-postman-是什麼">1.1 Postman 是什麼？</h3> <p>Postman 是全球領先的 <strong>AI 原生 API 平台</strong>，為超過 4,000 萬開發者與 50 萬以上的組織提供 API 開發、測試、文件化、監控與協作的統一解決方案。Fortune 500 企業中有 98% 使用 Postman 作為其 API 開發流程的核心工具。根據 2025 年 State of the API 報告，90% 的開發者正在使用 API，74% 已採用 API-First 策略，而 AI 驅動的 API 流量在 2024 年增長了 73%。</p>