postman中文版（bǎn）(接口測試工具)

postman接（jiē）口測試工具是專（zhuān）門用（yòng）於調試網頁和api的軟件，postman工具以前（qián）還有個穀歌瀏覽器插件版（bǎn），但是（shì）已經不能（néng）使用了，所以（yǐ）大家現在隻能安（ān）裝postman客戶端來進行調試了，此為綠色漢化版，使用教程大家可以看內容中的詳（xiáng）細介（jiè）紹（shào）。

官（guān）方（fāng）簡（jiǎn）介

postman是一個（gè）商業化的接（jiē）口測試工具，有收（shōu）費版本pro和免費版本的，這裏使用的是免費（fèi）版本（其實免費版本已（yǐ）經夠用了）。

postman分為chrome插（chā）件版和native版本，插（chā）件版（bǎn）官方已（yǐ）經不維護了，而且插件版的有很多功能（néng）都（dōu）受限製，比（bǐ）如，native必須（xū）要安裝擴展才可以操作（zuò）cookie，headers設置（zhì）受限製，沒有native版（bǎn）本的Postman console，非常不方便調試。

postman漢化教程

1.首（shǒu）先要（yào）安裝原版postman(ps：綠色（sè）資源（yuán）網提供的為綠（lǜ）色版，打開就可（kě）以（yǐ）直接運行)

2.下載（zǎi）小編提供的漢化包（bāo）app.zip，將"app.zip"壓縮包複製到postman安裝（zhuāng）目錄下麵的resources文件（jiàn）夾中解壓（yā）出來，會（huì）出現（xiàn）一個app文（wén）件夾

默認安裝地址：C:/Users/用戶名/AppData/Local/Postman

小編測試示例地址（zhǐ）：C:\Users\NINGMEI\AppData\Local\Postman\app-9.3.1\resources

注：如果不知道安裝目錄，桌麵找到Postman應用程序圖標右鍵（jiàn） -> 打開（kāi）文件所在位置，再進（jìn）入app-版本號/resources

3.重啟（qǐ）軟件後就是中文的了，如下圖所示

postman使（shǐ）用（yòng）教程

postman接口測試教程

1.數據（變量（liàng））

postman的數據包括全局變量，環境變量，外部文件和局部變量

全（quán）局變量（liàng）：作用域（yù）是全局，比如我們要設置（zhì）的token

環境變量：配置之後，讓測試用例既能夠（gòu）在測試環（huán）境中執行，也能在正式環境中執行

局（jú）部（bù）變（biàn）量：比（bǐ）如（rú）tests中定義的變量，作用域隻能在這個tests中

外部文件變量：在run collections的時候（hòu）可以設置循環（huán）次（cì）數，指定外部數據文件。外部（bù）文件可以（yǐ）是csv格式的，也可以是json格（gé）式的（de）。

Json data 文件（jiàn）格（gé）式（shì）：

csv data 文件格（gé）式（shì）

變量（liàng）優（yōu）先級：外部文件變量> 環（huán）境變量> 全局變量，也（yě）就是說（shuō），在變量名（míng）相（xiàng）同的情況（kuàng）下，外（wài）部文件的變量（liàng）優先級最高

變量的定（dìng）義

方法1：在postman的ui上（shàng）進行定義

方法2：使用腳本定義

變量的使用

方式1：Builder中的（de）使用（yòng）：{{varname}}

方式（shì）2：腳本中的使用（yòng）

變（biàn）量的衝突（tū）

如果Global和environment都設置（zhì）了一個名字（zì）相（xiàng）同（tóng）的（de）變量，environment的（de）變量會將global的覆蓋

2.sandbox

sandbox可以理解為（wéi）一個測試沙箱，專門用（yòng）來（lái）postman執行js代碼的環境，可以通（tōng）過js腳本來編寫pre-request和tests腳本

sandbox沙箱集成了（le）幾（jǐ）個工具庫，比如loadsh，tv4等，還有一（yī）些內（nèi）置函數，比如xml2JSON等

sandbox可以操作的對象（xiàng）

公共庫（kù）

環境（jìng）變量和全局（jú）變量（liàng）

動態變量

操作cookie

獲取和（hé）查（chá）看請求和響應（yīng）

讀取數據文（wén）件

pre-request 可以（yǐ）用來修改（gǎi）一些默認參數或者設置一些測試需要（yào）的測試永久（jiǔ），tests可以用來做斷言

關於更多tests操作，可以查看幫助（zhù）文（wén）檔

同（tóng）時postman還有一（yī）個（gè）叫SNIPPETS的模塊，裏麵防（fáng）止了（le）常用的一些test斷言，直接（jiē）點擊就可以使用了（le），如果這裏（lǐ）沒有你需要的，可以查看幫助文檔

3.collections

集合的功能

組（zǔ）織業務邏輯（jí）：分類和存（cún）儲你的（de）測試用例

導入導出：導入（rù）測試用例文件進行runner，導出json文件，使用newman在命（mìng）令行執行（導（dǎo）入導出的collections就隻是collections，不包含環境變量等（děng）），導出的時（shí）候記得勾選V2版本的格式，也是官方建議

一鍵（jiàn）運行測（cè）試用例：你可以選（xuǎn）擇你要運行的collection或者裏麵的文件夾進行運行（háng）

share：share一個link，然後將這個（gè）link分享（xiǎng）給其他人（rén），或者用於（yú）newman執行測試（shì）

4.collections run

建議：

delay：不（bú）能為0，每個接口之間都（dōu）應該加入一個（gè）delay

數據文件：可以（yǐ）是json格式的（de），也可以是csv格式的，官方建（jiàn）議json，更快

5.newman

newman是一個命令行（háng）工（gōng）具，可以（yǐ）用（yòng）於（yú）將我們的接口測試用例（lì）在命令行運行（háng）並生成測試報告（測試報告多種多（duō）樣）

為什麽要在命令行裏（lǐ）麵運行

可（kě）以在無界麵的（de）服務器上運行（háng）我們的測（cè）試用例

可以在CI持續集成係統上運行

運（yùn）行準備

導出collection

安裝nodejs和npm，可能（néng）安（ān）裝npm不（bú）好（hǎo）安裝，我（wǒ）們使用cnpm來進行（háng）安裝，百度搜索一（yī）下（xià）cnpm 淘寶源

安裝newman（nodejs寫的一個小應（yīng）用）

newman可（kě）以生成多種（zhǒng）測試報（bào）告

GIL reporter：控製台輸出

json reporter：可以放（fàng）到mongdb中做持久化（huà）

html reporter：方便發送郵件

junit reporter：可（kě）以無（wú）縫集成到jenkins，有（yǒu）一個（gè）插件（jiàn）可以把junit reporter自（zì）動解析，並放到jenkins裏麵（miàn），也就是可以（yǐ）直接在界麵中使用了

# 運（yùn）行postman生成的（de）collection的url，使（shǐ）用env.json作為環境變量，globals.json作為全局（jú）變量，並使用外部的data.csv作為外部（bù）數據，最後設置（zhì）了接（jiē）口請求超時時間為5s

newman run https://www.getpostman.com/collections/cb0cea0af1467c8008fb --environment env.json --iteration-data data.csv --globals globals.json

# 運行postman導出的collection的json文件，並（bìng）生成多種測試（shì）報告

newman run c:\test1.json --reporters cli,html,json,junit --reporter-json-export jsonOut.json --reporter-junit-export xmlOut.xml --reporter-html-export htmlOut.html

6.集成到jenkins

首先，下載jenkins的war包，使用java -jar jenkins.war --httpPort=8080啟動,配置jenkins完（wán）成

第一步:新（xīn）建job

第二步:添加構建（jiàn）步驟,你自己決定輸入什麽,我這裏（lǐ）指定newman執行某個（gè）文（wén）件件（jiàn）下的（de）json文件（jiàn）,並以junit的報告形式輸出到當前工作目錄

第（dì）三步:添加（jiā）構建後的操作並（bìng）保存

講newman生成的（de）junit格式的report整合進jenkins的junit report插件中（zhōng）,可以更好的（de）隊報告（gào）進行展（zhǎn）示

第四步:點擊手動構建(當然這裏你可以根據項目（mù）需要設置自動構建時間,比如每天（tiān）晚上的12點鍾執行構建)

第五步:查看構建結果

7.其他

get請求的參數（shù）怎麽填寫：可以直接在url中構（gòu）建，也可以單獨點（diǎn）擊params進行構建

post方法傳遞json格式的數據：首（shǒu）先設置headers，Content-Type = application/json，然後將json串寫入raw的body模式下（xià）

post方法傳遞（dì）form格式的數據：首先設（shè）置headers：application/x-www-form-urlencoded,body選擇form-data或（huò）者x-www-form-urlencoded,至於是哪（nǎ）種，可（kě）以都（dōu）試一下，肯定是其中之一

auth：常用的有basic auth和OAuth2.0，如果是basic auth，直接輸入用戶名和密碼（mǎ）就（jiù）可（kě）以了，如果是OAuth2.0,有兩（liǎng）種方法，第一（yī），找（zhǎo）開（kāi）發拿token，設（shè）置token，方（fāng）法2，登錄的時（shí）候（hòu）獲取token，然（rán）後每次訪問（wèn）豆漿token放在headers裏麵（miàn）就可以了

調試：postman中有一個叫postman console的工具（jù），該工具可以在我們（men）寫Script的時候（hòu）使用，通過console.log("this is demo")輸出數據（jù）到console中

參考help文檔：https://www.getpostman.com/docs/

軟（ruǎn）件特色

使用（yòng）Postman更快地構建更好的API。Mac，Windows，Linux和Chrome應用程式。

專業功能和協作，以便更好地測試，記錄和監控API。

企（qǐ）業級（jí）支（zhī）持（chí），安全和（hé）管理

更快，更容易API開發

強（qiáng）大的GUI平台，使您的API開發更快，更輕鬆，從構建API請求到測試（shì），文檔和（hé）共享（xiǎng）。

我們推（tuī）薦的免費（fèi）應用程序郵（yóu）差為蘋果，視窗，Linux的或Chrome瀏覽器

多重（chóng）集成，包括對Swagger和RAML格式的支持

API開發的完（wán）整工（gōng）具鏈

Postman是從（cóng）頭（tóu）開始設計的，以支持API開發的所有方麵。Postman的應用程序建立在（zài）一個（gè）單一（yī）的底層，確保一致（zhì）的性能和用（yòng）戶體（tǐ）驗。

鏡像您現有的API開發工作流

旨在（zài）支持每個（gè）API開發人員

API監控正常（cháng）運行（háng）時間，性能和準確性

無限（xiàn）集合，環境，測（cè）試（shì）和共享

郵遞員為開發（fā）人員在每個人的選（xuǎn）擇（zé）：

Mac，Windows和Chrome應用程式

個（gè）人和團隊選擇（zé）

Postman具有運（yùn）行，測試，文（wén）檔和監視功能，旨（zhǐ）在（zài）一起無縫工作。Postman旨在使（shǐ）您（nín）當前的工作流程（chéng）更（gèng）快更（gèng）好。

軟件（jiàn）亮點

Postman是一款功（gōng）能強大的網（wǎng）頁調試與發（fā）送網頁（yè）HTTP請（qǐng）求（qiú）的Chrome插件。

用（yòng）戶（hù）在開發或（huò）者調試網絡程序或者（zhě）是網（wǎng）頁B/S模式的程（chéng）序的時候是需要一些方（fāng）法來跟蹤網頁（yè）請求的，用戶可以（yǐ）使用一些網絡的監視工具（jù）比如著名（míng）的（de）Firebug等網頁調試（shì）工（gōng）具。今（jīn）天給大（dà）家介紹的（de）這款（kuǎn）網（wǎng）頁調試工具（jù）不僅可以調試簡單的css、html、腳本等（děng）簡單的網頁基本信息（xī），它還可以（yǐ）發送幾乎所有類（lèi）型的HTTP請求！Postman在發送網絡HTTP請求方麵可（kě）以說是Chrome插件類產品中的代表（biǎo）產（chǎn）品之一。

Postman適用於（yú）不同的操作係統（tǒng），Postman Mac、Windows X32、Windows X64、Linux係（xì）統，還支持（chí）Postman瀏（liú）覽器擴展程序、Postman chrome應用程序等。

優缺點分析

優點（diǎn）：

優點（diǎn）:腳本語言是js

優點:門檻低,上（shàng）手快

優點:跨平台

優點:自帶各種代碼模塊

優點:免費（fèi）版就已經非常強大了（le）,支持http,https協議

優（yōu）點:有命（mìng）令行版本,newman,方便放在服務器上運行,或者jenkins做持續集（jí）成

優點:支持抓包,保存曆史（shǐ）記錄,多終端（duān）同步用例

優點:支持抓包,保存（cún）曆史記錄（lù）,多（duō）終端同步用例

優點:支（zhī）持讀取數據（jù）文（wén）件（jiàn）,json,csv

優（yōu）點:支（zhī）持（chí）json Schema校（xiào）驗

優點:如果項（xiàng）目有Swagger生成API文檔,JSON文件可以（yǐ）直接導（dǎo）入Postman來生成用例

缺點：

不（bú）支持:通過url搜索用例,通過命令行（háng）傳參修改環境變量,不能指定執行（háng）失敗（bài）的測試用例

不理想:不能操作文件相關的操作,不能讀寫數據庫,不能（néng）使（shǐ）用非HTTP協（xié）議

不理想:封裝（zhuāng）公共（gòng）函數,引入第（dì）三方,自己寫的js庫,用例間的（de）跳轉（zhuǎn）,重試等（děng）.

更新（xīn）日誌（zhì）

1.通（tōng）用導航

1.1家

在頂部導航（háng）中介紹所有新的“主頁”部分。概述團隊中（zhōng）發生（shēng）的（de）一切-團隊成員的活動，新警（jǐng）報（bào），通知等。從這裏，您可以快（kuài）速導航到工作（zuò）區，API網絡（luò），集成或（huò）Postman學（xué）習中心-無論您要去哪（nǎ）裏，都是（shì）從家開始的地（dì）方（fāng）。

1.2工作區

我們有（yǒu）一個（gè）全新的工作區（qū）選擇器，使（shǐ）您（nín）可以在最（zuì）近使用的工（gōng）作區之間（jiān）快速切換（huàn）。現在，您可以搜索（suǒ）不同類型的工（gōng）作空間，而不必切換（huàn）選項卡。隻需鍵入您要轉到的（de）工作（zuò）區的名（míng）稱。

哦！現在，我們有了公（gōng）共工作區，這些工作區與其他任何工（gōng）作（zuò）區一樣，但是對互聯網（wǎng）上（shàng）的每（měi）個（gè）人都（dōu）是可見（jiàn）的，可（kě）以通（tōng）過Postman API網絡輕鬆訪問。創建一個新的公共工作區，並與全球數百萬郵遞員（yuán）用戶共享（xiǎng）您（nín）的API。

1.3報告

可在企業和業務層（céng），報告 幫助您了解您（nín）的組織如何構建（jiàn）和消費（fèi）的API。獲（huò）取有（yǒu）關請（qǐng）求（qiú），收集運行（háng）和測試失敗的見解（jiě）。管理員還可以使（shǐ）用報告來（lái）分析在整個組織中如何使用Postman。

1.4探索

一站式解決方（fāng）案（àn），可（kě）探索Postman API網絡中發布的所有API。瀏覽不同的團隊（duì）及其公共工作區以發現新的（de）API。請繼（jì）續閱讀以了解更多信息。

1.5通用搜（sōu）索

通用搜（sōu）索使搜索和發現任何私有（yǒu）或公共（gòng）API元素變（biàn）得異（yì）常容易。它會查看您帳戶中的所有API元素，私有API網絡和公共（gòng）API網絡，以幫助您單擊幾（jǐ）下（xià）即可（kě）上手。