POSTMAN 教程
总体容
发送 api 请求
环境变量设置 脚编写
集合操作 Api 文档操作
认识 PostMan
模拟服务器 什 POSTMAN？什？
Postman 款功强网页调试发送网页 HTTP 请求 Chrome 插件
户开发者调试网络程序者网页 BS 模式程序时候需
方法踪网页请求户网络监视工具著名 Firebug
等网页调试工具天家介绍款网页调试工具仅调试简单 css
html脚等简单网页基信息发送类型 HTTP 请求
Postman 发送网络 HTTP 请求方面说 Chrome 插件类产品中代表产品
开发员需调试网页否运行正常简简单单调试网页
HTMLCSS脚等信息否运行正常更加重网页够正确处理种
HTTP 请求毕竟网页 HTTP 请求网站户间进行交互非常重
种方式动态网站中户部分数需通 HTTP 请求服务器进
行交互 Postman 插件充着种交互方式桥梁利 Chrome 插件
形式种模拟户 HTTP 请求数发送服务器便开发员够时
作出正确响应者产品发布前错误信息提前处理进保证产品
线稳定性安全性
Chrome 中安装 Postman 插件户需调试网站时候启动
Postman 插件进行项简单配置实现该网站基信息修改发送
种类型 HTTP 该网站中户发送 HTTP 数时候编写相关测试数
时候加入定量参数信息测试数更加准确切 Postman 会完美
支持
开发员 Postman 时候许需常调试网站者时调试
网站果次开 Postman 插件重新设置遍样会显非常麻烦
Postman 考虑户性化需求 Postman 配置页面中户
添加者理网站户启动 Postman 时候动开相应设置
POSTMAN 界面布局
postman 界面分两部分：左边 sidebar 右边 request builder ：快速创
建请求
HTTP 请求 4 部分 URL 请求 method headers body
POSTMAN 界面布局
构建请求 时您 请求体编辑器起工作 PostMan 发送类型
HTTP 请求身体编辑器分 4 区域根身体类型控制
关标题注意事项 ： 您通 HTTP 协议发送请求 时您 服务器会期
Content Type 头 Content Type 头允许服务器正确解析正文表单数 urlencoded
体类型 Postman 会动附加正确 Content Type 头 您必 设置 您选择 格
式化类型时设置原始模式标题 果您手动 Content Type 标头该值优先
Postman 设置 Postman 没二进制体类型设置头类型
REQUEST
REQUEST
REQUEST
Builder
Builder 选项卡请求构建 器允许您快速 创建类型 HTTP 请求
HTTP 请求四部分 URL 方法标头体 PostMan 您提供 工具处理
部分 REQUEST
URL 您 请求设置第件事 URL 输入字段存储先前 URL 您开始 输入
URL 时显示动完成拉列表
单击 Params 钮开输入 URL 参数数编辑 器您 单独添加键值
Postman 组合述查询字符串中容 果您 网址已具参数 例 果您
粘贴 源网址 Postman 会网址动分割成
注意 ： 您 URL 栏数编辑器中输入参数会动进行 URL 编码右键单击选文
然选择 EncodeURIComponent 手动编码参数值
注意： http 果没指定协议 Postman 动添加 URL 开头 REQUEST
Cookie
Cookie 理
器编辑域相关联
Cookie 机应
程序中理 Cookie
开模式请单击 发送
钮 Cookies 链接
进步解 理
Cooki e REQUEST
Header presets
您 标题预设中
常标题保存起根
头 选项 卡您 通选择
Manager presets 头
预设 添加您 请求 预设 右
侧拉列表 REQUEST
Headers
单击标题选项卡显示标题键值 编辑器您 字符串设置头名称
动完成拉列表 您输入 字段时提供常见 HTTP 标头建议 Content Type 标
题值动完成拉列表中
REQUEST
Method
控件拉
列表直接更改
请求方法请求
Body 编辑器区域
根方法否
附加 Body 改变
构建请求 时您 请求体编辑器起工作 PostMan 发送类型
HTTP 请求 Body 编辑器分 4 区域根身体类型控制
关标题注意事项 ： 您通 HTTP 协议发送请求 时您 服务器会期
Content Type 头 Content Type 头允许服务器正确解析正文表单数 urlencoded
体类型 Postman 会动附加正确 Content Type 头 您必 设置 您选择 格
式化类型时设置原始模式标题 果您手动 Content Type 标头该值优先
Postman 设置 Postman 没二进制体类型设置头类型
请求体（ Url Body ）
REQUEST
REQUEST
multipartform data Web 表单传输数默认编码样模拟网站填写表单
提交表单表单数编辑器数设置键值（数编辑器 ）您 文件附加密
钥注意： HTML 5 规范限制文件会存储历史记录集合中次发送请求 时您
需次选择该文件
支持 Content Type 载文件
Form data
REQUEST
编码 URL 参数中编码 相您需 输入键值 Postman 会正
确键值进行编码请 注意您法 通编码模式传文件形式数
urlencoded 间会混淆请务必先检查 API
url Code
REQUEST
raw
原始请求包含容换环境变量 PostMan 会触原始编辑器
中输入字符串您放文区域中否发送请求原始编辑器您设置格式化
类型您应该原始体发送正确标题您手动设置 Content Type 标题
覆盖 Postman 定义设置编辑器类型中选择 XML JSON 您请求体提供
语法突出显示设置 Content Type 头
提示： 编辑器中选择文 CMD CTRL + B 动 XML JSON 容进行
美化
REQUEST
binary
二进制数 允许您发送 法 Postman 中输入容例图
音频视频 文件您 发送文文件前面表单数部分
述果通历史记录集合加载请求必须重新连接文件
RESPONSE
确保 API 响应 正确您 API 时会做工作 PostMan 回复查器
您 务更容易
API 响应体标题状态代码组成 PostMan 标签中组织正文
标题状态代码完成 API 调需时间起显示选项卡 旁边您
鼠标悬停状态代码获取关代码更详细信息数情况
HTTP 规范规定默认描述 API 作者添加定义消息
RESPONSE
RESPONSE
Save Response
果请求已保存集合中保存该请求响应旦返回响应单击 保存响应 钮
输入名称呼保存响应保存请求中响应 您加载 请求时作 example
提供单击右角 examples 拉列表查选择保存示例
RESPONSE
查 response
PostMan Body 标签您提供 工具 帮助您快速 解事物 Body 三视
图中 Pretty Raw Preview
Pretty
RESPONSE
Pretty 模式格式化 JSON XML 响应便更容易查没想滚动
单行 JSON 响应寻找难捉摸字符串突出显示漂亮模式中
链接点击链接 URL Postman 中加载 GET 请求导航响应
单击左侧三角形（▼）折叠部分响应
PostMan 动格式化 Body 请确保返回适
Content Type 标题果 API 样做您
强制 JSON XML 进行格式化您通
detection language 拉菜单中选择 JSON
Setting 模式 General 选项卡强制
JSON 格式
响应中查找项目： CMD CTRL +
F 开搜索栏然 CMD CTRL + G 滚动结果
RESPONSE
Raw
原始视图响应体文区域 帮助您判断您 回应
否缩
RESPONSE Preview
预览选项卡会沙盒 iframe 中呈现响应 Web 框架默认情况返回 HTML 错误
预览模式里特 iframe 沙盒限制 JavaScript 图 iframe 中禁
您 化 body 占整 postman 窗口果算花费量时间应问
题走路
果您 API 端点返回图 Postman 动检测呈现二进制响应 类型您
应该 选择 Send and download 您 响应保存硬盘 然您 适
查器查 您 灵活测试音频文件 PDF zip 文件 API 抛出容
RESPONSE
Headers
Headers Headers 选项卡显示键值悬停标题名称根
HTTP 规范出标题描述 果您发送 HEAD 请求 Postman 默认显
示 Headers 标签
RESPONSE
Response TIme
Response Size
PostMan 动计算响应服务器达花费时间
性初步测试
PostMan 响应分解正文标题响应
似值
Response
状态
RESPONSE
Cookie
服务器发送 Cookie 专选项卡中显示 Postman
中理应程序 Cookie 请 理 COOKIES 模式
果您 Postman Chrom e 应程序中工作 Intercepto r
扩 展 帮助 理 Cooki e
Tests
请求服务器获容外查针
请求运行测试结果解更关 Postman 测试信息
HISTORY
HISTORY
您 PostMan 发送请求均 存储您 左边
栏访问历史记录 ( history ) 中历史 您快速 尝试种请求
会浪费时间头开始构建 请求您 通单击请求名
称加载先前请求
果您创建 帐户登录 PostMan 您 历史记录
服务器步实时备份 您 设备检索
果您退出您 PostMan 帐户然重新登录 10 请求
保留您 历史记录中 Postman Pro Enterprise 户
访问 100 请求相政策适收集运行请 记住
您 时收藏中保存请求
HISTORY
侧栏中 history 选项卡
浏览请求
单击选项卡中请求构建器中加载确切请求 配置您 键盘
箭头键浏览请求 PostMan 预览状态加载请求 Enter 键 确保请求
请求换
查找请求
请求时间排序面请求显示顶部 PostMan 避免历史记录中相
URL 复制 GET 请求 果您 请求历史记录变请搜索输入字段边栏中滤请求
PostMan 您 历史记录中请求网址搜索字词进行匹配
选择请求
住 CTRL(MAC 中 CMD ） 然单击选择 请求您 通列表顶部操作
启动请求保存 ( saving ) 享 ( sharing ) 记录 ( documenting ) 模拟 ( mocking ) 监
控 ( ) monitoring 删 ( deleting ) 等操作
HISTORY
组织常 请求您 历
史记录中保存集合中请求保存
集合中请鼠标悬停然单击
旁边显示加号图标（ + ）选择请求
时加号图标（ + ）显示侧栏顶部
点击加号图标（ + ）选择现集合
创建新集合请求保存集合
请求保存集合
HISTORY
删请求
果摆脱历史记录中请求请选
择边栏顶部 Delete All 删单请求
请鼠标悬停然单击旁边显示
垃圾桶 图标您 通点击边框顶部边
框旁边垃圾桶图标选择删请求然
次选择 删您想 历史记录中
请求
DEBUGGING AND LOGS
Debugging and logs
PostMan 应程序 PostMan 厂家进行广泛测试测试版说应
程序崩溃出现意外行情况果直法排问题
文件中问题 GitHub 踪访问 PostMan 支持中心果想包含机密数应程
序控制台日志包含报告中提供数进行障排
PostMan 控制台类似浏览器开发者控制台适 API 开发果 API API 测试
符合您期您调试时进行深度潜水方控制台窗口开
您 API 活动记录里查发生什事情
PostMan 控制台记录信息：
发送实际请求包括底层请求标头变量值等
Postman 处理服务器前发送确切响应请求代理配置证
书
测试预请求脚错误日志
consolelog()
脚中 consoleinfo() consolewarn()适位置助提取正起作确切代
码行果知道 consolelog() JavaScript 方式相似
DEBUGGING AND LOGS
DevTools 控制台日志
访问控制台日志请列步骤操作：
Mac Windows Linux 机应程序
转 View 应程序菜单然单击 show DevTools
DevTools 窗口中单击顶级控制台选项卡应显示应程序调试日志
DEBUGGING AND LOGS
网络通话 PostMan 控制台
Mac Windows Linux 机应程序
前 View 应程序菜单然单击 show PostMan console 键盘快捷键（
CMD CTRL + ALT + C ） DevTools 类似调头效载荷记录
Postman 控制台
AUTHORIZATION
授权（ Authorization ）
请求编辑器强足构建类型请求时 时您 需帮
助 PostMan helper 简化重复复杂务目前 助手您
轻松 处理身份验证 协议您 帮助器环境变量
您 选择帮助数保存收集请求导致次重新生成签名
助手甚会纽曼工作
AUTHORIZATION
基认证（ Basic Auth ）
输入户名密码字段点击 Update Request 生成授权头
AUTHORIZATION
Digest Auth
Digest auth 基认证更复杂
前请求中设置值
生成授权头生成标题前请
确保已正确设置 PostMan
果已存删现标题
AUTHORIZATION
OAuth 10a
PostMan OAuth 帮助器 您签署 支持基
OAuth 10a 身份验证请求目前 允许您获取
访问令牌 API 提供商需 OAuth 10 帮助器
头查询参数中设置值
OAuth 请求会期机值
果启动添加参数 Postman 发送请求
前刷新 OAuth 签名
OAuth 10 规范相复杂变化 Postman 包括
选项：
Add params to header
果启复选框 params 添加标题中
果没 GET 请求 URL 参数 POST PUT 请
求请求体
Add empty params to signature
OAuth10 实现需空参数添加签名
中
AUTHORIZATION
OAuth 20
PostMan 支持获取 OAuth 20 令牌轻松添加请求中 OAuth 20 提
供程序获取访问令牌请列步骤操作：
单击 Get New Access Token 钮开 Model 您
httpswwwgetpostmancomoauth2callback 回调 URL
您 API 提供商获取授权 URL 访问令牌 URL 客户端
ID 客户机密钥值值提供 API 提供者
者您 设置 API 需 Scope 参数设置
API 中具访问级
Request Token 钮启动 OAuth 20 流程果切
正确 设置您 重定 Postman 服务器该服务器
接收您 访问令牌发送 Postman 应程序
完成 PostMan 添加令牌请名称便
快速访问
果您 OAuth2 提供程序公开访问（托
部网）请确保启 Request Access Token Locally’
选项
访问令牌存储显示帮助列表中请求
添加访问令牌请单击 Token 名称
AUTHORIZATION
Hawk authentication
Hawk 消息认证码（
MAC ）算法提供部分
HTTP 请求加密验证 HTTP
认证方案
AUTHORIZATION
AWS authentication
AWS 户必须基密钥 HMAC （
哈希消息认证码）定义 HTTP 方案进
行身份验证 PostMan 支持开箱
详细解 AWS 签名 AWS 文档：
httpdocsawsamazoncomAmazonS3
latestdevRESTAuthenticationhtm l
y httpdocsawsamazoncomapigatewa
w latestdeveloperguideho t o us e
postma n t o cal l apihtm l
COOKIES
Cookies
PostMan 机应程序提供 MANAGE
COOKIES 模式 您编辑 域相关联
Cookie
cookie 理器
开 理 COOKIES 模式请单击 发送 钮 Cookies 链接
COOKIES
cookie 理器
述操作开 MANAGE
COOKIES 模式显示域
列表相关联 cookie
COOKIES
域添加新 cookie 请单击 添加 Cookie 钮 创建根 HTTP 状态理标准预生
成 cookie 字符串 您 方显示文输入进行编辑点击 保存 钮保存
相关域应程序 Cookie 存储区
创建 cookie
COOKIES
添加域 （ Adding a domain ）
果域列表中存
域添加 cookie 通
http 顶部输入框中
输入机名（带端口）
添加单击添加钮
添加域列表 然
您 通选择该域添加
Cookie 述方式输入
新 Cookie 值
COOKIES
更新 Cookies
更新现 Cookie 请
域列表中转域然单击编
辑 cookie 您 编辑属
性然点击 Save 更新
###
通 Set Cookie 头添加 Cookie
您 通 Set Cookie 标
头通响应添加 编辑 Cookie
GENERATE CODE SNIPPETS
Generate code snippets( 生成代码 )
旦您确定您 请求保存 Postman 中您希您 应程序发
出相请求 PostMan 您 种语言框架生成代码段 帮助您执行
操作您需 点击 蓝色 发送 钮 代码 链接开 GENERATE CODE SNIPPETS 模
式
GENERATE CODE SNIPPETS
选择语言
拉菜单选择语言 某语言选项 您选择 框架提出请求
Language Framework
HTTP None (Raw HTTP request)
C LibCur l
cURL None (Raw cUR L command)
C# RestShar p
Go Built in http packag e
Java OkHtt p
Java Unires t
JavaScript X jQuery AJA
JavaScript Built in XH R
NodeJS Built in htt p module
NodeJS t Reques
NodeJS Unires t
Objective C Built in NSURLSessio n
OCaml Cohtt p
PHP HttpReques t
PHP pecl_htt p
PHP Built in cur l
Python Built in t httpclien 3) Python (
Python Request s
Ruby Built in NETHtt p
Shell wge t
Shell HTTPi e
Shell cUR L
Swift Built in NSURLSessio n
PostMan 支持选项
创建集合
什 PostMan 集合？ PostMan 集合请求分组起请
求进步组织成文件夹
什创建集合？
• 组织 请求组合文件夹集合中
便您必 遍遍搜索历史记录
• 文档 请求文件夹集合添加名称
描述 PostMan 中您 收藏浏
览器查文档 Postman Pro 您
创建发布漂亮 API 文档页面
• 测试套件 测试脚附加请求构建
集成测试套件
• 条件工作流程 脚您 API 请
求间传递数 构建反映您 实际
例 API 工作流
创建新集合
1 转边栏中 收藏 标签
2 点击面橙色新收藏图
标
3 输入您 收藏名称（
选描述）
请求保存集合
1 构建器中创建新请求
2 点击 Save 钮
3 选择现集合新集合然点击 Save
保存历史集合
1 请求保存集合中鼠标
悬停 History 选项卡请求中
然单击加号图标（ + ）
2 选择请求单击加图标
（ + 显示边栏顶部）
3 选择现集合新集合然
点击 Save
复制现集合
1 单击省略号（ ）展开控件拉列表 2 菜单中选择 Duplicate
分享收藏
您必须登录您 PostMan 帐户传分享收
藏单击享集合旁边省略号（ ）选择
Share 开 SHARE COLLECTION 模式
中包含享集合数方式
您 团队享集合（ PRO 功）
果您 Postman Pro Enterprise
团队成员团队成员
享集合 SHARE COLLECTION
模式 Team Sharing 选项卡 您
团队指定查编辑 权限您
选择整团队享集合团
队成员分配权限
分享收藏模式
链接享
生成享链接 访问您 收藏享集合推荐方
法收集链接集合作时间快反映出必须进行更新刷新集合
更改
Run in Postman 中
分享
SHARE COLLECTION 模式 Run in Postman 标签 您 创建
Postman 钮 享您 收藏收集链接集合应该手动更新反映
集合中新变化
作文件享
收藏集作 JSON 文件载您通您 PostMan 帐户登录
享
理集合
侧栏中 集合选项卡：
浏览集合
点击集合显示隐藏构成集合
请求键盘箭头键
浏览集合
编辑查收藏细节
展开右角括号（ > ）显示集合详细信
息视图折叠左角括号（ < ）隐藏详细信
息 视图您 添加名称描述等元数
便开发 员您 API 需
信息轻松获
重新排列集合 收藏集合
集合名
称次更新
时间字母
序排序
请选择右
角排序
图标然选
择 Sort by
name Sort
by date
果您正 专
门研究 系
列您 点
击星形图标
收藏集列列
表顶部
滤收藏 删集合
果您
集合
请
搜索输
入字段
侧边
栏中
滤集合
单击集合旁边省略号（
）然选择
Delete 果您想
删该 集合您 点击
Postman 应程序顶部显
示通知中 Undo 链接
收藏功
重新排序请求 集合文件夹 中您 拖放请求进行重新 排序您 拖
放重新排列集合中文件夹
保存回复 存储集合中时请求 存储样响应
example
通 示例您 模拟原始响应保存集合中 然您
Postman 模拟服务户生成模拟端点
添加脚 存储集合中请求包含集合添加动态行脚
添加文件夹
文件夹集合中
API 端点组织成
直观逻辑组
种方法 镜
您 工作流
添加文件夹集合
旁边单击省略号
（ ）选择
Add Folder
文件夹中添
加名称说明
文件夹初
名称字母
序排列文
件夹名称
描述 反映
您 API 文档中
添加文件夹
文件夹
添加更深层次
嵌套拖放
文件夹重新
排序创
建终定
义文件夹结构
EXAMPLES
开发员发送实际请求设置单 端点返回响应前 Postman 中模拟 请求
响应 API 开发早期间建立 Example 需团队成员间明确沟通
期达致意味着开发员测试员更快开始
什例子？
例子紧密耦合请
求响应例例
子中 ＇200 Ok custom
response＇ 例子名字
包含 ’request example’
’response example＇
什例子？
通常情况创建保存 example 响应请求（ 200
404 500 等状态代码）您 API 更容易理解查
您 API 事快速查 example 解特定请求返
回响应 切需请求 Send
外假设您尚存端点构建 API 否您服务器
尚未准备绪通 example 您模拟原始响应保存
然您 Postman 模拟服务客户端生成模拟
端点通设置开发员模拟端点发出请求根模
拟端点返回模拟响应开始前端开发编写测试
A2
添加例子
API 端点添加示例需点击 假
设您正 处理保存集合中 请求您
新定义响应服务器收响应
请求添加示例
新定义 RESPONSE
通您头 开始创
建定义
response 您 通
示例定义
response 应该什
样子面图示概
述创建具新
response 示例步
骤
新定义 RESPONSE
1 单击 examples 拉列表
2 单击添加示例钮基请
求作示例编辑器中
request example 加载
3 输入例子名字
4 编辑示例请求部分
5 输入状态码
6 您 示例创建新响
应
7 单击构建器右角保存示
例钮保存示例
服务器收响应
收服务器响应 您 希前请求响应保存例样
做步骤类似头开始创建新响应（前图）
稍您返回您 基
请求通点击构建器
左角请求名称 继续您
离开 位置
访问您保存 示例
单击构建器右角 examples 拉列表访问保存示例
EXAMPLES POSTMAN 文档中显示
postman API 文档需点击
发布网络示例 显示
您 API 文档中 您 API 提
供详细信息说明
您 时返回编辑示例
文档进行实时更新
允许团队模拟示例请求响应
模拟服务器模拟端点
前端端开发员测试
员根商定示例行开
始工作
详细发布方式面会讲
数格式
PostMan 收藏环境全局变量标题预设导出导出文件链接
导出导入 PostMan 资料
PostMan 导出导入格式作文件生成 URL Postman 应程序
导出集合时导出文件 JSON 文件该文件包含 Postman 导入 Postman
时重新创建集合需数（元数） Newman 命令行界面（ CLI
）运行集合数（元数）
导出 POSTMAN 资料
集合（ collections ）
PostMan 导出两种格式集合 v1 v2 Collection v1 v2
作 JSON 文件载 v2 更功常选择
环境（ Environments ） 环境 MANAGE ENVIRONMENTS 模式导出里导入
数转储（ Data dumps ）
SETTINGS 模式 Data 选项卡 Postman 允许您集
合环境全局变量标题预设导出 JSON 文件中 PostMan
会导出您历史记录您数导入 Postman
导入 POSTMAN 资料
postman 数 SETTINGS 模式 Data 选项卡中 导入 头文件工具栏
中 导入钮导入 IMPORT 模式导入 collection environment data dump c Ur l
command RAML WADL Swagger （ v1 v2 ） Runscope 文件
导入 cURL
效 cURL （仅 HTTP ）命令导入 Postman PostMan importer 支持 cURL 选项：
见页
导入 POSTMAN 资料
选 项 描述
A user agent 选户代理字符串
d data
指定数发送具
application x www form
urlencoded 类型服务器
data ASCII
指定数发送具
application x www form
urlencoded 类型服务器
data 进行 urlencode
指定数发送具
application x www form
urlencoded 类型服务器
data 二进制 数原样发送
F form
）
G get 强制发送请求 GET 附
加查询字符串 data 参数
H 开头 添加标题（次）
X request 指定定义请求方法
url 指定 URL 种方式
导
入
命
令
包
括
cURL 影响
curl httppostman
echocomget
Postman 中创建 GET 请
求预先填充 URL
curl request POST url
httppostman
echocompost form color
red form color
green
值表单数行创
建 POST 请求
curl X PUT data binary
hello httppostman
echocomput
原始数创建 POST
请求
curl X PUT data ascii＇a
b ＆ c
d＇httppostman
echocomput
H＇AccessToken ： 1234 ＇
urlencoded 表单数
定义标头创建
PUT 请求
导入 RAML
RAML 文件夹保存集合
1 包含 RAML 定义存储库克隆计算机
存储文件夹
2 单击 import 钮然选择导入文件夹选项卡
3 单击 选择文件夹 传 RAML 文件夹
4 完成 PostMan 检测 RAML 定义部转换
PostMan 然显示导入成功消息
载 RAML 文件 examples ： githu b ap i v3ram l
IMPORTER SWAGGER
Swagger API 定义通常单文件形式存支持导入单 swagger 文件果文件夹中相关
Swagger 文件通文件夹导入器导入文件
Swagger 文件保存集合
1 包含 Swagger 定义存储库克隆计算机果作文件保存然
2 单击导入钮然选择导入文件选项卡果文件夹中相关 Swagger 文件通文件夹导入器导入
文件
3 点击文件传 Swagger 文件
完成 PostMan 检测 Swagger 定义部转换 PostMan 然您
显示 导入成功消息
Swagger 20 Examples ： http s ： githubcomOAI OpenAP I Specificationtreemasterexamplesv2 0
导入 WADL
PostMan 导入 W ADL 规范然方面受支持 您 期 Postman
种参数（集合文件夹请求标头请求效载荷 ( Collection folder request header
request payload) ）正确生成
application xmlnshttpwadldevjavanet200902> <
< resources basehttpexamplecomapi >
> < resource pathbooks
< method nameGET >
resource path{bookId}> <
< param requiredtrue styletemplate namebookId >
< method nameGET>
< method nameDELETE>
< resource pathreviews >
method nameGET> <
< request >
< param namepage requiredfalse default1 stylequery >
< param namesize requiredfalse default20 stylequery>
< request>
< resource pathreaders>
< resources >
< application >
示例 WADL 文件
验证收集 JSON 文件
验证 JSON 文件否采正确集合格式 PostMan schema files for collection s
• 模式文件位 httpschemagetpostmancomjsoncollectionv100collectionjso n
• 相关文档 httpschemagetpostmancomjsoncollectionv100docsindexhtm l 找
• 切存储 GitHub httpsgithubcompostmanlabsschema s
• 查模式 i s m y jso n vali d 验 证器）数验证示例请查 文
什 POSTMAN 脚
PostMan 脚
Postman 包含基 Nodejs 强运行时 允许您 请求集合添加动态行 允许您编写
测试套件构建包含动态参数请求请求间传递数 等等您 流程中两事件中添
加执行 JavaScript 代码：
1 请求发送服务器前作 Pre request Script 选项卡 预请求脚
2 收响应作 Tests 选项卡 测试 脚 Postman 中单请求请求执
行流程示：
？
魔法 PostMan Sandbox Postman Sandbox
JavaScript 执行 环境您 请求（ PostMan 纽曼州）撰写预
请求测试脚时部分中写入代码沙盒中执行
调试脚
调试脚 Pre request scripts 选项卡 Tests 选项卡
编写 Postman Console 中记录消息
预请求脚发送请求前执行收集请
求相关联代码片段例请求头中包含
时间戳 URL 参数中发送机字母数字字符串
例非常适
例请求标头中包含时间戳
函数返回值设置环境变量
然您 通键入访问头数编辑器中
timestampHeader 变量请求发送 时您 预请求脚
执行 timestampHeader 值发送代
{{ timestampHeader }}{{ timestampHeader }}
注意： 设置环境变量环境必须处活动状态
预请求脚 JavaScript 编写语法 Tests script 完全相响应象存
预请求脚 ( PRE REQUEST SCRIPT)
Postman 您 JavaScript 语言
请求编写运行测试
测试脚
写 PostMan 测试
Postman 测试质
特殊测试象设
置值 JavaScript 代码
测试脚发送请求
执行允许访问响应
象您 象中
元素设置描述性键
然说明否 true
例 tests[Body
contains user_id ]
responseBodyhas ( use
r_id ) 检查响应正文
否包含 user_id 字符串
您 根需添加意数量密钥 具体取决您 测试容查 Postman
测试例子
测试作收集请求部分保存端前端开发员完美确保
切正常运行
PostMan 测试沙盒环境中运行应程序执行环境分开
Sandbox
代码段
然编写测试时
没什需记住
东西 Postman 会尝
试通编辑器旁边列
出常代码段简化
程您 选择
添加代码段相
应代码添加测试编
辑器中快速构建
测试例方法
查结果
PostMan 次运行请求时会运行测试 然您 选择查
测试结果
结果显示响应查器 Tests 选项卡中该选项卡标题显
示传递少测试列出测试变量中设置键
果值 true 测试通
测试脚发送请求服务器收响应运行
Postman 测试例子数 Postman 中作片
段数测试单行 JavaScript 语句样 简单您 求提供许
测试
1 设置环境变量
postmansetEnvironmentVariable(key value)
2 嵌套象设置环境变量
var array [1 2 3 4] postmansetEnvironmentVariable(array JSONstringify(array
null 2)) var obj { a [1 2 3 4] b { c ＇val＇ } } postmansetEnvironmentVariable(obj
JSONstringify(obj))
3 获取环境变量
postmangetEnvironmentVariable(key)
测试示例
测试示例
4 获取环境变量（值字符串象）
These statements should be wrapped in a try catch
block if the data is coming from an unknown source
var array
JSONparse(postmangetEnvironmentVariable(array))
var obj
JSONparse(postmangetEnvironmentVariable(obj))
5 清环境变量
postmanclearEnvironmentVariable(key)
6 设置全局变量
postmansetGlobalVariable(key value)
7 获取全局变量
postmangetGlobalVariable(key)
8 清全局变量
postmanclearGlobalVariable(key)
9 检查响应体否包含字符串
tests[Body matches string]
responseBodyhas(string_you_want_to_search)
10 XML 体转换 JSON 象
var jsonObject xml2Json(responseBody)
11 检查响应体否等字符串
tests[Body is correct] responseBody
response_body_string
12 检查 JSON 值
var data JSONparse(responseBody)
tests[Your test name] datavalue 100
13 容类型存（区分写检查）
tests[Content Type is present]
postmangetResponseHeader(Content Type)
Note the getResponseHeader() method returns the
header value if it exists
14 容类型存（区分写）
tests[Content Type is present]
responseHeadershasOwnProperty(Content Type)
15 响应时间 200 ms
tests[Response time is less than 200ms]
responseTime < 200
16 响应时间特定范围（包括限限排）
tests[Response time is acceptable]
_inRange(responseTime 100 1001)
_ is the inbuilt Lodash v3101 object documented at
httpslodashcomdocs3101
17 状态码 200
tests[Status code is 200] responseCodecode
200
18 代码名称包含字符串
tests[Status code name has string]
responseCodenamehas(Created)
19 POST 请求状态代码成功
tests[Successful POST request]
responseCodecode 201 || responseCodecode
202
20 TinyValidator JSON 数
var schema { items { type boolean } } var data1 [ true false]
var data2 [ true 123]
tests[Valid Data1] tv4validate(data1 schema)
tests[Valid Data2] tv4validate(data2 schema)
consolelog(Validation failed tv4error)
21 解码 base64 编码数
var intermediate base64Content assume this has a base64 encoded value
rawContent base64Contentslice(＇dataapplicationoctet streambase64＇length)
intermediate CryptoJSencBase64parse(base64content) CryptoJS is an inbuilt
object documented here httpswwwnpmjscompackagecrypto js tests[Contents
are valid] CryptoJSencUtf8stringify(intermediate) a check for non emptiness
测试示例
示例数文件
JSON 文件键 值组成
载
JSO N 文 件
CSV 文件顶行需
包含变量名
载 V CS 文 件
运行集合 时您 该 postmansetNextRequest ( request_name ) 功 Postman 中分
支循环 API 请求
设置执行请求 停止工作流执行
postmansetNextRequest ( request_name ) postmansetNextRequest ( null)
分支循环
关键点 postmansetNextRequest () ：
1 指定续请求名称 ID 集合运行者处理余请求
2 预请求测试脚中作业情况考虑设定值
3 果 postmansetNextRequest () 请求中存收集运行器默认线性执行移动
请求
POSTMAN 沙盒
postman Sandbox JavaScript 执行 环境您 编写预请求脚
测试脚（ Postman Newman 中）时沙箱 中执行您 预请
求 测试脚部分中写入代码
• h Lodas ： JS 实程序库
• o cheeri 快速精简核心 ： jQuery API 实现（版 460 更高版）
• S BackboneJ 已弃：提供简单模型视图集合版沙箱中删
• S SugarJ 已弃：方法扩展机 JS 象版沙箱中删
• tv4 JSO N 器 模式验证 ： 根 json schema 草案 v4 验证 JSON 象
• S CryptoJ ： 标准安全加密算法支持算法： AES DES EvpKDF HMAC MD5
HMAC SHA1 3256512 MD5 PBKDF2 Rabbit SHA1 3224256512 TripleDES
• xml2Json(xmlString) ：功 Newman Postman 中样
• xmlToJson(xmlString) 已弃：功 Newman Postman 中行相
• postmangetResponseHeader(headerName) Test only ：返回名称 headerName 响应
头（果存）果没样头存返回 null 注意：根 W3C 规范头名区分
写方法顾 postmangetResponseHeader(Content
type) postmangetResponseHeader(content Type) 返回相值
• 注意： 460 版 jQuery 支持已停
环境全局变量
• postmansetEnvironmentVariable(variableName variableValue) ：设置环境变量 variableName
分配字符串 variableValue 您必须 方法选择环境工作 注意：存储字符串存储类型数
导致意外行
• postmangetEnvironmentVariable(variableName) ：返回环境变量 variableName 值预先请求测试 脚
您必须 方法选择环境工作
• postmansetGlobalVariable(variableName variableValue) ：设置全局变量 variableName 分配字
符串 variableValue 注意：存储字符串存储类型数导致意外行
• postmangetGlobalVariable(variableName) ：返回全局变量 variableName 值预请求测试脚
• postmanclearEnvironmentVariable(variableName) ：清名 variableName 环境 变量您必须 方法选
择环境工作
• postmanclearGlobalVariable(variableName) ：清名 variableName 全局变量
• postmanclearEnvironmentVariables() ：清环境 变量您必须 方法选择环境工作
• postmanclearGlobalVariables() ：清全局变量
• environment ：前环境中变量字典 environment[foo] 访问 foo 环境变量值注意：
读取变量 setEnvironmentVariable() 设置值
• globals 全局变量字典 globals[bar] 访问 栏中 全局变量值注意：读取变量
setGlobalVariable() 设置值
动态变量
PostMan 动态 变量您您 请求中 请注意动态变
量沙盒中 您 请求 URL headers body 中格式
{{}}
{{ }} guid {{ }} timestamp {{ }} randomInt
添加 v4 风格 guid 添加前时间戳 添加 0 1000 间机整数
Cookies
responseCookies {array} Postman only 获取 域设置 Cookie 您 需启 拦
截器 工作
postmangetResponseCookie(cookieName) Postman only 获取具定名称响应 cookie 您需启
拦截器工作查 博客文 章
请求 响应相关属性
• request {object} ： Postman 写脚时请求象该象读更改象属性起作注意：变量会请
求象中解析请求象容组成：
• data {object} 请求表单数字典（ requestdata[ key ] value ）
• headers {object} 请求标题字典（ requestheaders[ key ] value ）
• method {string} GET POST PUT 等
url {string} 请求 url
• responseHeaders {object} 已弃 仅测试：响应头映射区分写应该检查
postmangetResponseHeader() 面列出 方法
• responseBody {string} 仅测试：包含原始响应正文文 字符串您 作 JSONparse xml2Json 输入
• responseTime {number} 仅测试：响应时间（毫秒单位）
• responseCode {object} 测试：包含三属性：
• code {number} ：响应代码（ 200 OK 404 Not Found 等）
• name {string} ：状态码文
• detail {string} ：响应代码说明
• tests {object} 仅测试：象填充 PostMan 象属性作布尔测试
• iteration {number} ：仅 Collection Runner Newman 中表示前测试运行索引 0 开始
仅测试 ：象仅测试脚部分预先请求脚中会抛出错误
数文件
果您 Collection Runner Newman 中 数文件访问 data
象该象前测试运行中数值字典
变量 ) VARIABLES (
什变量？
变量采值符号您熟悉语言变量您前编程验 Postman
中变量工作方式相
什变量？
变量允许您位置重值便您保留代码 DRY （重复）外果更改值
您通代码中影响级联更改变量次
假设您 3 相域 API 端点 your domaincom 您该网站保存变量重复
值 请求建设者现果您域更改您需更改值次
{{ domain}}endpoint1{{domain}}endpoint2another domaincom
Postman 脚引擎您设置变量值请求复制数请求等
变量 ( ) VARIABLES
变量范围
范围 供您 ：
1 Global
2 Environment
3 Local
4 Data
范围作值存种类桶果变量两范围具较高优先
级范围胜出该变量里获取值 PostMan 种广泛窄范围层次结构解决范
围
果前活动环境变量全局变量享名称环境变量优先换句话说全局变量
环境变量覆盖变量数变量覆盖 （仅集合运行程序中 ）
变量 ) VARIABLES (
访问请求构建器中变量
变量 Postman 户界面中列形式 Postman 解析变量时字符串 {{ variableName }} 换相应
值例具值 http ： localhost 环境变量 url 您必须 请求 URL 字段中 请求发送时
换 {{ variableName }}{{ url }}{{ url }} httplocalhost
字符串换访问请求构建器中变量请求构建器中位置 您
中添加文包括 URL URL 参数标题授权请求正文标题预设 Postman 根 Variable scope 部分中讨
范围规评估变量发送服务器
通脚访问变量
变量预请求测试脚中脚部分 JavaScript 编写 您 方式初始化
检索 变量您 脚中初始化变量放特定范围
脚中定义变量：
脚中设置变量请根需范围 setEnvironmentVariable () 方法 setGlobalVariable () 方法该方法需
变量键值作参数设置变量 您发送 请求时脚评估该值作变量存储
获取预定义变量：
旦设置变量 getEnvironmentVariable () 方法 getGlobalVariable () 方法取决适范围获取变量该方
法需变量名作参数检索脚中存储值
范围设置变量：
相应环境模板访问环境变量选定环境广泛访问全局变量
变量 VARIABLES ( )
记录变量
通常脚中变量时需获值 PostMan 控制台轻松实现应程序菜单中选择
View 然选择 show postman console 记录变量值 consolelog(foo) 脚中发送请
求时脚评估变量值记录 Postman 控制台中
数变量
Collection Runner 导入 CSV JSON 文件然 HTTP 请求脚中数文件中值称数变
量 Postman 中请遵循环境全局变量相语法
请求中数变量
Postman UI 中变量包含
括号例面
屏幕截图 部 URL 参
数数文件应值
取代：
{{ username}}{{password }}
变量 ( ) VARIABLES
预请求测试脚中数变量
预先请求测试脚中特殊 data 象包含数文件中特定迭代加载值例 datausername
者 data[username] 您数文件访问户名变量值
键入开卷轴括起启动动
完成菜单数编辑器
预请求测试脚部分 输入
变量第字母会触发动完
成该菜单包含前环境中
变量列表全局变量浏
览列表显示变量前值
范围覆盖变量反馈
变量 VARIABLES ( )
动态变量
PostMan 动态 变量您您 请求中动态变量沙盒中 您 请求 URL headers
body 中格式 {{}}
{{ guid }} ：添加 v4 风格 guid
timestamp }} {{ ：添加前时间戳
{{ randomInt }} ：添加 0 1000 间机整数
快速查找变量
Quick Look 快速预览功
方显示环境全局变量点击右
角眼睛图标切换显示者输入
键盘快捷键（ CMD CTRL + ALT + E ）
变量 ( ) VARIABLES
动完成工具提示变量
PostMan 变量非常强两功 动完成工具提示 更方便
变量动填充
变量 ( ) VARIABLES
变高亮显示工具提示悬停
变量 橙色突出显示
未解析变量 红色显
示悬停变量显示
前值范围果
变量未解决 前环
境中没值 工具提示
显示适反馈
理环境
( ) MANAGE ENVIRONMENTS
环境组键值键作变量名称数编辑器进行编辑
环境全局变量始终作字符串存储果您正存储象 数组请确保 JSONstringify () 存储前进行
JSONparse () 检索
什环境？
API 时您通常需具设置例您机器开发服务器编写 API 环境您够变量
定义请求样您轻松设置间切换需更改您请求旦 PostMan 必担心记住
价值观环境载保存 JSON 文件稍传
理环境
( ) MANAGE ENVIRONMENTS
创建新环境
点击 PostMan 应程序右角齿轮图标然选择 Manage environments 单击添加钮创建新环境
理环境
( ) MANAGE ENVIRONMENTS
理环境
点击 PostMan 应程序右角齿轮图标然选择 Manage environments 创建享环境 外您 复
制导出删环境 您 环境导入单 JSON 文件方
选择活动环境
单击 Postman 应程序右角拉菜单选择活动环境输入环境名称选择环境 您 访问活动环境范围
变量
理环境
( ) MANAGE ENVIRONMENTS
编辑活动环境 分享环境
点击 PostMan 应程序右角齿轮图标然选择 Manage
Environments 单击享环境旁边 Duplicate
Environment 图标
单击 Postman 应程序右角快速查找图标显示
环境全局变量单击编辑链接开模式编
辑键值
创建副佳做法删敏感值（密码访问令牌）然载副享导入环境访
问享模板时模板版中输入信息
理全局变量
全局变量提供组范围始终 变量您 拥环境次活动 您 组
全局变量始终
环境全局变量始终作字符串存储 果您正 存储象 数组请确保 JSONstringify () 存储前进行
JSONparse () 检索
理全局变量 查全局变量
点击 PostMan 应程序右角齿轮图标然选择 Manage environments 单
击模态底部 Globals 钮显示键值编辑器添加编辑删全局变量
您全局变量载单 JSON 文件方
什 API 文档
Postman API 文档 功允许您享 公私 API 文档通网页
查
Postman 实时动生成托基浏览器 API 文档集合
私公文档视图实时步服务器数生成
access the private view 请点击 Postman 应 Team Library
中 View in web 公开视图通公开链接访问 publish your
documentation 时生成 链接 您 文档发布立显示
通私文档视图中 Published 拉菜单访问
动生成容
您 API 文档包括容：
示例请求标头元数请求文
件夹集合相关联描述受欢迎
编程语言生成代码片段文档序
请求文件夹组织成反映收藏结构部分
描述 带嵌入式图形
Markdown 样式进行定制 补充您 文
档支持 GitHub 调味降价甚
包括表包含块元素时请确保
前留出空行避免出现渲染问题
PostMan 帐户免费提供文档查
PostMan 帐户 月您提供 限数量免费文档 查您 通 Postman Pro API 帐户 页面检查您 限制
查文档
集合私公文档视图实时步服务器数生成
查您 Postman Pro Enterprise 团队唯访问私文档请 Postman 应程序 Postman 网络视图中单
击 View Docs View in web
Postman 户私文件查收藏私文档请确保您已登录 Postman 应程序登录您
户名显示右角
PostMan 应程序中展开
集合名称旁边右尖括号（ > ）
开集合详细信息视图然
单击 View Docs 钮
查私文档
查私文档
Postman 应程序中
查 团队收藏 文档 您
您 Team Library
View Docs 钮
单击钮浏览器中
开该集合文档您
浏览集合中文件
夹请求查选择
环境中请求代
码片段外观
请注意视图仅限 Postman Pro Enterprise 团队中户法访问集合身链接起作果 集合您 团队
享团队中查集合私文档 果您 集合享 您 查集合私文档
文档提供户 许作您网站 链接您需 Publish Docs
查公文档
公开视图通公开链接访
问 您发布 文档时生成
发布文档
通公 URL 进行访问
公开 URL 您 文档发布
显示通私
文档视图中已发布拉
列表访问
果您选择 已验证定
义域 您 公文档
您 定义域中
获
环境环境模板
您 环境环境模板会动步通 API 文档中拉列表进行查公私
文档时选择环境环境变量值换文档相关部分例果选定环境具
foo 值变量 bar 请求中出现换 bar 环境中存储程中加密
私文件中环境
私文档视图中您环境环境模板
您 Team Library 中享环境模板起
提供您
公文件中环境
果发布文档时选择环境模板
文档查器该模板
具体说果户登录
PostMan 帐户已步
环境已发布文档中
允许根特定环境定义
已发布 API 文档
果您 公文档发布定
义域中户登录
PostMan 帐户环境模板发
布页面中
发布公文档
发布文档 世界享您 API 文档种方式 果您 查中收藏
文档发布文档点击
生成公文档
您您创建集合您具写入权限集合发布文档开中收藏
文档页面点击屏幕顶部 Publish 钮
果您已 登录 PostMan 您 选择相应环境发布收藏 集合中变量
引 换环境中正确值 {{ url }}
生成公文档
屏幕截图中公开网址 字段包含您 外界分享 URL 例 果您 发布集合
需选择 Production 环境 便您 文档立新访问者
重信息 ： 您 环境中机密信息（密码访问令牌）会公开显示环境发布文档前请确保
信息环境中删
公文档链接始终拥新
容次更新文档时
需继续浏览 Publish
流程
取消发布请点击 View
Docs 您 PostMan 应程序中
钮点击屏幕顶部附
已发布钮已发布
集合您查公链接
取消发布集合
已发布集合文档 – 查
定义域
者您 验证定义域列表中选择 承载您 API 文档您 查定义域中文档
Postman 私文档页面
Custom styling 选项
Postman 允许您定义 已发布文档页面外
观 添加您 团队徽标更新颜色题
您 品牌保持致
您 发布文档前更新定义
样式选项单击显示定义样式选项链接
展开该部分 更新您 调色板
添加验证定义域
具公文档 PostMan 户定义域发布文档
添加定义域
PostMan 网页视图中转 Team 选项卡 edit 视图
部分添加
定义域通
输入名称点击
+ 钮添加
定义 域您
定义域完
整域简单
子域 例您
examplecom
apiexample com
作您 定义
域
获取验证令牌
添加定义域开模式显示验证域权
需 DNS 记录模式中重信息
TXT CNAME 记录 验证您否控
制您尝试 添加域名 Postman 求您
提供令牌作 DNS 记录 添加您 域中
添加 DNS 记录
种情况请 DNS Web 服务提供商验证权单独浏览器选项卡中
转 DNS 提供商控制台添加两新记录
postman echocom 验证域
权 TXT 记录该值应模态中显示
令牌相应 TXT 记录添加根
域添加 examplecom
添加 apiexamplecomTXT 记录
examplecom
CNAME 记录 docspostman
echocom 值应该
phsgetpostmancom 模态中显示
应 CNAME 记录添加您公开
文档相关联 URL 中
验证域名
DNS 提供商控制台中添加记录返回 Postman 网页视图选中确认已添加
TXT CNAME 记录框然点击验证域绿色消息确认定义域已验证
时 DNS 设置需时间生效种情况 您 会面错误信息
件事段时间试次
您 选择稍通单击模式中 Verify the following 钮 验证您 域控制 果您需
次访问模式查 token 重新尝试验证单击定义域列表方 Verify Now 链
接
新定义域发布集合
验证域 您 域 公开提供
您 API 文档 果您 发布演示集
合请转 Postman 网页视图 发布您
收藏现选择定义域新
选项
发布 转您 定义域名
公开文件
添加团队名称徽标
具理员角色 PostMan 户直接 Edit Team Details page 页面邮政组帐户
添加团队名称徽标
更新您 团队名称
您 Postman 网页视图 team page
您前 团队名称
果您 首次创建 Postman Pro Enterprise
团队时未输入团队名称立更新
团队页面中点击右角齿轮图标然
选择 Edit team 更新您 团队名称
更新您 团队徽标
team page 中点击右角齿轮图标
然选择 Edit team 添加 更新您 团队
徽标
传图显示团队发布文档标
题中 Postman 徽标徽标需
5 分钟更新
设置模拟服务器
Postman 模拟服务器模拟端
整开发程中前端端延迟阻碍属团队效完成工作
Postman 模拟服务器前端开发员模拟 Postman Collection （相应环境）中端点查潜
响应会实际旋转端
前端端 API 团队现行工作释放赖关系延迟开发员
设置 mock
开发员发送实际请求设置单端点返回响应前 Postman 中模拟请求响应 API 开发早期间建立
例子需团队成员间明确沟通期达致意味着开发员测试员更快开始
创建 mock 两种方法：
1 PostMan 应程序
2 Postman Pro API
创建模拟 Postman Pro Enterprise 户团队享模拟审查协作通团队特定团队成员
享底层集合实现提供编辑查权限
设置模拟服务器
HTTP 访问控制（ CORS ）
您仅 Postman 应程序模拟端点浏览器进行模拟域协议端口请求资
源时 Web 浏览器会产生跨源 HTTP 请求安全起见跨原始资源享（ CORS ）定义浏览器服务器安全交
互方式标准种情况指 Web 浏览器 Postman 服务器托模拟端点交互
Postman 模拟服务器启 CORS 意味着您 模拟端点模拟数 存储您 Web 应程序换句话说
开发生产网络应程序刚刚创建 Postman 模拟端点发出请求收示例响应
PostMan 帐户免费模拟服务器电话
PostMan 帐户 月您提供 数量限免费模拟服务器电话通 Postman Pro API 帐户 页面检查您
限制
MOCK 实例
深入解模拟服务器示例协工作集成您工作流程中便 Postman 进
步增强 API 体验
1 发送请求（ R1 ）
2 请求（ R1 ）保存集合（ C1 ）
3 保存请求 R1 响应作示例（ P1 ）
4 集合创建模拟（ M1 ）（ C1 ）
5 模拟服务器（ M1 ）发送请求
MOCK 实例
设置需基础知识
解 Mock 细节前开始设置 Mock 需基础知识：
步骤 1 ：发送请求（ R1 ）
PostMan 应程序发送 GET 请求
URL httpspostman
echocomgettest123 该请求命
中 Postman Echo 服务您
测试您 REST 客户端进
行示例 API 调
产生响应右边
请求记录现左边
Histroty 中显示
MOCK 实例
步骤 2 ：请求（ R1 ）保存集合（ C1 ）
Save 钮开 SAVE REQUEST 模式集合连接起创建 API 工作流组请求
您 请求保存
现集合保
存新集合
创建新集合 C1
MOCK 实例
收藏 C1 现访问收藏应程序选项卡集合详细信息视图中进行种样
事情：查 API 文档 Mock 集合监视集合运行集合 ( viewing API documentation
mocking a collection monitoring a collection or running the collection)
MOCK 实例
步骤 3 ：保存请求 R1 response 作示例（ P1 ）
现通点击 save response 钮发送请求中保存示例响应
MOCK 实例
带示例屏幕
保存请求响
应作例子
举例子 P1
MOCK 实例
输入示例名称请求方法 URL 状态
代码确定创建模拟返回
响应关重验证元素需
save example 钮点击左
角返回箭头返回请求构建器现
右角创建示例
添加请求中
MOCK 实例
模拟实例
前步骤中准备收集请求示例响应开始模拟继续步
步骤 4 ：集合创建 mock （ M1 ）（ C1 ）
两种方式收藏创建 mock ：
1 ） Postman 应程序
2 ） Postman Pro API
例子中 Postman 应模拟集合
PostMan 应程序 单击您想 mock 扩展集合详细信息视图集合旁边右尖括号（ > ）
MOCK 实例
Mocks 选项卡单击添加模拟链
接开 MOCK COLLECTION 模式
里您 选择相应环境
包含您 模拟中
单独保存示例（ P1 ）中没
环境变量继续
创建 No Environment 选择模拟
请注意 果您保存 示例 URL
中具环境变量创建模拟时
提供相应环境尝试模拟该特
定请求法正常工作
{{ base_url }} mypath
MOCK 实例
旦模拟集合
Mocks 集合详细
信息视图选项卡
见您
步需模拟网
址
MOCK 实例
步骤 5 ：模拟服务器（ M1 ）发送请求
现已创建模拟
M1 尝试模拟端点发
送请求复制步中
创建模拟模拟网址粘贴
新请求中种情况
未定义路径
httpsb75a340e 4268 20 4 b 8 f5f
3 cfc8f37cec6mockpstmnio
新请求 header 标签添
加 x api key 标题您 Postman
Pro API 密钥值
获 取 Postman Pro AP I 密 钥
MOCK 实例
未定义路径 mock 端点
发送请求返回错误
路径 ’ 请求方法没匹配保
存示例 GET 模拟服务返回响应
完全取决您保存示例包含
URL 请求方法类型
MOCK 实例
路径 get 请求方
法保存例子 GET
GETURL 发送请求 httpsb75a340e
4268 4 b 20 8 f5f
3 cfc8f37cec6mockpstmnioget 返
回正确响应
MOCK 实例
添加更示例
进步说明模拟服务响应否 完全取决您保存 示例试次该集合添加示例重复步骤 1 3
请求保存集合保存响应作示例添加新 URL httpspostman echocomtest
发送 GET 请求 httpspostman echocomtest 返回 404 错误
然存例子收藏 C1 现两
请求两保存例子：
GET > get
GET > test
MOCK 实例
mocktest 模拟路径
提供预期 404 响应
您 examples URL
端点请求方法类型状态代码
异 果您 示例保存
模拟 中您 选择
惟 URL 端点保存示
例例子中
get test 样者 果
您已 保存具响应状态
代码 示例您
验证请求发送模拟端点
x mock responcode 头部指
定指定整数响应代码应
该匹配
完成 已介绍
创建集合保存请求保
存示例创建 mock mock
POSTMAN PRO API MOCK
您 直接 PostMan 应程序中模拟集合外 PostManPro API 创建 mock 步步走
完程
建立 Mock 集合
例中带相应环境
testAPIEnv 集合 testAPI 建立
模拟服务前端团队够模拟
testAPI 中端点查种响应
导航您希 模拟中包含集合
testAPI 中请求保存响应体
头部状态代码详细 信息您希
该端点返回响应例中
特殊请求保存 200 401
状态代码 2 响应 旦您保存
需响应收集进行模拟
注意 保存响应模拟集
合 外您 mock a request
and response using examples
POSTMAN PRO API MOCK
检索模拟创建需信息
获取 collectionId testAPI PostManPro API GET All Collections 端点获取收藏列表 搜索您
集合名称 uid 结果中检索 collectionId 步中
您 Postman 应程序检索
collectionId 您 应程序中查找集合点
击 View Docs 该 collectionId 文档
URL 见：
httpsdocumentergetpostmancomcollectio
nview{{collectionId}}
POSTMAN PRO API MOCK
作选步骤包括环境模板通
检索模拟部分 environmentId
testAPIEnv PostMan Pro
API GET All Environments
endpoint 获取环境列表 搜索
您 环境名称 uid 结果中检索
environmentId 步中
POSTMAN PRO API MOCK
Postman Pro API 创建模拟
POST 创建模拟端点 您前 检索 collectionid environmentid 创建模拟端点
注： headers 中 x api key 忘加
验证 GET All Mocks endpoint 创建 模拟
您 集合现模拟
POSTMAN PRO API MOCK
运行 mock 服务
网址模拟您 collecion ：
https{{mockId}}mockpstmnio{{mockPath}}
mockId id 创建模拟时收
GET All Mocks 端点检索
mockPath 例您想模拟您 请求路径
api response
添加请求标头：
模拟请求需强制性标题 x api key
您 Postman Pro API 密钥进行身份验证
没 Postman Pro API 密钥？ 里创建
Mock 请求接受选标题 x mock
response code 指定返回响应应该匹配整
数响应代码例 500 返回 500 响应
果未提供标题返回响应代码接
匹配项
POSTMAN PRO API MOCK
模拟请求响应示例
例子中保存响应模拟 集合您
发送实际请求设置单端点返回响应前
Postman 中示例模拟请求响应通 示例您 模拟原始
响应保存 然您 Postman 模拟服务
户生成模拟端点
匹配算法
Postman 模拟服务需容：具请求集合模拟服务器保存请求 示例您
时保存示例模拟服务器预见返回示例模拟
究竟决定例子返回呢？
模拟匹配算法
首先例子开始
Postman Pro API
Postman 应程序创建模拟
时会调 Postman 服务器
特定集合 （果您选择
）新创建模拟相关
联 C1 刚刚嘲笑集合
现新模拟关 M1
匹配算法
M1 通
httpsM1mockpstmnioPost
man 应程序中模拟 URL
模拟时模拟服务开始
匹配程前该特定集合
Postman 服务器检索保存
示例
匹配算法
现 mock 服务具前集合保存
示例现传入请求接
匹配示例进行迭代配
传入请求具配置变量例
requestMethod mockPath 该
requestMethod 变量应效
HTTP 请求方法（例 GET POST PUT
PATCH DELETE 等等）
mockPath 指效字符串路径（例
test testpath testpath1 ）
请求需 x api key Postman Pro API 密钥
相应认证报头选接受 x
mock response code 模拟请求期响
应代码相应报头例求
200 400 404 500 特定端点响应
匹配算法
记住种配置元素匹配算法逻辑
1 正确格式化响应 符合预期格式响应匹配程中删
2 HTTP 方法 HTTP 方法类型响应匹配程中删例：果发送模拟请求
POST httpsM1mockpstmniotest 保存例子方法类型 POST 会忽略
3 网址滤
匹配程现检查保存示例迭代性 mockPath 输入 URL 保存
示例进行较果输入网址 httpsM1mockpstmniotest 目前正审查例子
URL httpsgooglecomhelp 模拟服务会较 test help 较 URL 时会进行步步
匹配匹配算法遍历连续步骤减少前示例响应匹配阈值
例：
• 尝试输入路径示例路径完全致值设置匹配阈值
• 尝试剥离尾部斜杠输入路径示例路径相匹配阈值降低定值 n
• 尝试外写输入路径示例路径阈值减更值 n + m
• 尝试输入路径示例路径中外删字母数字门槛进步降 n + 2m
• 果步骤失败保存示例符合条件响应
匹配算法
4 响应代码 果 x mock response code 明确提供标题滤掉
没匹配响应代码示例
5 高阈值
降序剩余滤响应进行排序返回具
高阈值响应
模拟服务找返回模拟请求适响应方式
PostMan 学里 感谢支持
Thanks
《香当网》用户分享的内容，不代表《香当网》观点或立场，请自行判断内容的真实性和可靠性！
该内容是文档的文本内容，更好的格式请下载文档