postman生成接口文档(postman怎么做接口)

接口测试工具Postman入门

供外部（界面客户端或第三方系统）访问的后台程序，该后台程序能够对外部发送过来的请求进行处理，并返回处理的结果。

接口文档（接口的功能说明书）

Postman：适用RESTful接口（HTTP/HTTPS协议）的功能测试

Soup UI：适用WebService接口（SOAP协议）的测试

Jmeter：适用RESTful接口的性能测试

HttpClient + fastjson + TestNG：适用RESTful接口功能自动化

比如：

1、生成时间戳

微信扫一扫关注该公众号【测试开发者部落】

点击链接加入群聊【软件测试学习交流群】

软件测试学习交流QQ群号： 511619105

postman优点

postman优点：

1. 支持多种协议：可以支持HTTP、HTTPS、HTTP/2、Websocket、GRPC等多种协议，让开发者可以针对不同的协议进行测试。

2. 功能齐全：Postman提供了丰富的功能，比如支持请求分组、历史记录、环境变量、断言、代码生成、授权管理、自动化测试、可视化等，可以满足开发者多方面的需求。

3. 易用性强：Postman提供了友好的UI界面，只需要几步就可以完成请求的发送，可以让开发者节省许多时间，提升自己的工作效率。

拓展：Postman还可以支持API的文档生成，可以把API文档发布到Postman的服务器上，这样就可以更好的管理API文档，让开发者可以更加便捷的调用API接口。

史上最详细Postman教程

Postman是 chrome 的一款插件,用于做接口请求测试,无论是前端,后台还是测试人员,都可以用 postman 来测试接口,用起来非常方便。

从 chrome 的扩展程序中安装(自备梯子)

搜索Postman找下面的应用安装

安装好之后在扩展程序里面可以看到,点击详细信息,创建快捷方式

快捷图标如下

打开之后如下图所示,左边是项目具体的接口,右上上面是请求链接,请求体,右边下面是具体的响应体

先选择左边的 "colletions",下边有个带”+”的文件夹点击

输入项目名称,点击"create"

新建项目成功

在项目下面还可以创建子目录,选择Add Folder。(可用于一个界面有多个接口,这样就可以按界面来查找接口)

再建一个

效果如下

点击“+”新建接口,选择请求方式(get) ,填入链接,点击”send发送请求”

新建接口,输入接口名称,选择属于哪个界面

添加成功

选择请求方式post,选择body,点击”raw”,选择你对应接口的mime类型,输入请求体,点击Send,发送请求,右下角是响应码,和响应时间。

请求结果:可以选择格式(json,xml等),也可以搜索请求体里面的内容

点击右上角设置

选择”setting”

选择“general” ,” Language detection”选择”json”,以后请求回来的数据是自动格式化之后的json字符串,这样就不用每次都修改了

我们开发的时候一般是开发的时候一套接口,上线之后是另一套接口,那么我们要把每一套接口都保存一份吗,当然不用,我们只需做如下设置,就可以自由切换是开发还是正式的接口了

点击右上角的齿轮,选择”Manage Environments”。

点击”add”,添加域名,这样就可以开发的时候一套链接,上线之后用另外一套,就不需要每个接口都要改请求链接了

url配好之后,要在请求链接的地方用{{url}},替换链接,url这个名字是你自己定义的,然后点击右边的箭头就可以切换时开发还是正式的接口了

当然注册账号之后,可以实现接口同步,非常方便,当然也可以本地导入

先导出接口

导入接口,拷贝文件,点击左上角“import”,选择文件路径导入即可.

学会这些一般的接口调试应该没问题了,更多功能自己慢慢摸索吧!

postman生成接口文档(postman怎么做接口)

Postman 使用

可以参考:

972.html

(1).全局变量的使用

接口共同使用的部分可以存放在全局变量,调用时直接要{变量名}就可,如图:

查询的接口是www.baidu.com

(2).提取公共 www 点击环境按钮,选择全局编辑

点击环境按钮，选择全局编辑，输入数据点击"save"按钮

(3).输入{{3w}}baidu.com代表 www .baidu.com

通常情况下测试接口过多,不能一个一个点击,需要放入集合中一次性运行实现批量测试效果

(1).点击runner

(2).选择需要的接口集合,点击"startRun"按钮

(3).生成接口的测试报告

点击完 Start Run 就会生成报告!!!! 这边就没有展示!!

(1).点击左侧菜单栏中的文件夹

(2).创建app文件,用于存储app接口

(3).设置代理,指定端口(默认 5555),指定存储路径

(4).显示代理链接

(5).查看电脑ip地址

也可以使用黑窗口 (菜单+R ) 输入命令ipconfig/all 回车就可以看到IP地址了

(6).手机设置代理模式

(7)手机上点击对应的app项目

随机打开自己的app

(8).查看postman中所对应的接口

(1).点击Export导出接口

(2.)选择导出路径

(4).导入操作 , import

(5).导入成功

(1).聚合数据中查询

(2).使用postman下发GET请求

(3).使用postman 下发GET无参请求

(4).有一个自定义请求头,需要自己填写

(1).使用postman测

试接口

postman微信公众号接口测试

1、拿到api接口文档：熟悉接口业务、接口地址、鉴权、入参、出参、错误码

2、接口测试计划和方案：正例、反例、分页异常

3、编写用例和评审

4、执行接口测试

5、输出接口测试报告

在企业中做接口测试是不会把参数写死过去的

时间戳：

生成0-100的随机整数：

生成一个GUID的字符串：

一个接口中可能存在多个环境如：开发、测试、生产环境

环境和globals都是全局变量

多个接口之前都是有相互关联的

如：注册之后就是登陆，一个业务增删改查不可能一个接口一个接口测

如果一个参数可能从新增到修改再到删除D都是关联，则需要在第一个接口先去获取到，然后在下面接口使用时可以调用

可以在Tests界面上使用

1、json提取器

2、正则表达式提取器

3、cookie提取器

精确断言： 如果需要精确断言的，即这个是个变量，可以提取获取到值，保存到一个全局变量中，并通过获取全局变量来进行断言

一般是在这个Pre-request Script界面上

全局断言： 就是所有接口都用到这个断言

一般用于状态断言

Postman接口测试之：Postman实现接口请求（1）

课程实例使用的url地址汇总：

开源接口部分：

1、获取时间get接口

2、网易新闻post接口

3、百度ip接口

电商项目部分： 电商网站：

4、电商登录接口：

5、文件上传接口 ：

自动化平台项目：平台网站：

6、平台登录接口：

Token接口项目：Token项目网站：

7、Token项目 SOAP接口：

1、 Postman 安装之后， 可以进行一下更新。

使用的时候最好可以注册一个账号。

先创建一个workspace，用于管理接下来使用过程中产生的内容。

2、接口测试的基本流程： 本质就是抄。

1、了解接口信息 ： 由开发提供接口文档， 或者通过抓包来获取接口报文信息。

2、 设计测试用例

3、 执行测试用例： 用postman等工具执行。 请求发包。

4、验证返回结果。

3、 HTTP协议接口报文： 理解成寄快递。

接口报文分为请求和返回，格式其实是相同的。

请求

请求四要素： http方法 、url地址、请求头 、请求体。

请求行： http方法（邮寄方式） url（地址） http协议版本

请求头： 键值对格式 ，键：值 用换行分割的方式。 （快递单）

除了特殊指定的要填的请求头以外，注意 post请求 需要关注content-Type请求头，表示的是请求体的编辑格式。（快递的运输方式 常温/冷冻）

常见的content-Type类型：

application/x-www-form-urlencoded: url编码格式： 键=值&键=值

application/json: json格式字符串： {"键":值,"键":值}

postman选 raw格式之后，下拉栏选择json

注意：复制json格式的请求体的时候，如果从浏览器开发者工具中复制，记得确认键必须带双引号。最好view source 之后再复制。

multipart/form-data： 用于进行文本和文件的混合传递。 完成文件上传。

选择posmtna中的 form-data进行参数填写。

注意： Name空格中，可以选择下拉 file或者text。

文件用file上传，文本用text上传。

text/xml: 用xml格式来进行传递。 <键>值

选择 body中的 raw格式 ，下拉栏用xml进行填写：

注意：content-type postman会默认使用 application/xml，需要自己确认，到底是text/xml还是application/xml，如果不对，进行修改，最后是直接去掉原有的，加一个新的content-type头。

请求体 ： 请求头之后空一行 ，之后的就是请求体。 （寄的东西）

返回

返回行：http协议版本 HTTP状态码（物流状态） 状态码描述

返回头： 键值对格式 ，键：值 用换行分割的方式。 （快递单）

返回体 ：返回头之后空一行，就是返回体 （对方寄回的东西）

返回：重点验证返回体。

4、http协议抓包：

使用浏览器开发者工具抓包：

在网页上右键检查，或者按下F12，打开开发者工具，切换到network 界面。

注意：记得勾选 preserve log。

请求体中：request payload （json格式、xml格式和普通文本） 和form data （文件和x-www-form-urlencoded格式）

使用 fiddler /charles 等http抓包工具抓包：

在fiddler菜单右侧，用inspector 选项进行查看，选raw（原始）格式能够直观看到报文格式。

http是一个简单的请求-响应协议，它通常运行在TCP之上。它指定了客户端可能发送给服务器什么样的消息以及得到什么样的响应。

http协议是基于url地址的资源请求协议

5、用postman发送报文请求：

1、http 方法 和 url 进行填写。 注意 url中最后带上的空格也会有影响，所以千万注意。

2、请求头一般先不做过多关注，先用默认的，除非有明确的说明需要设置某个请求头。

3、请求体在postman 请求栏的body中进行设置。选择相应的content-type格式进行编辑，可以自动设置，不用自己设置 请求头中的 content-type。

6、unicode编码： \u 4位16进制数，用于表示某个特殊的字符。

例如：\u7f8e\u56fd\u963f\u62c9\u65af\u52a0

7、get和post的核心区别：

get方法，通常不带请求体。

而post方法可以携带请求体。

END

postman能生成接口文档吗

本文主要是对Postman这个接口测试工具的使用做个简单的介绍，仅供参考。

插件安装

1）下载并安装chrome浏览器

2）如下

3.

弹出框中选择【添加】

4.打开Postman

界面简介