API接口测试--postman测试基础
本节讲解,如何使用postman测试API接口,以下讲解常用的两种请求方法。
一、postman测试GET请求
比如如下一个查询天气的API接口文档。
接口地址:http://apis.juhe.cn/simpleWeather/query 返回格式:json 请求方式:http get 接口备注:通过城市名称或城市ID查询天气预报情况
请求参数说明
名称 | 必填 | 类型 | 说明 |
city | 是 | string | 要查询的城市名称/id,城市名称如:温州、上海、北京,需要utf8 urlencode |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
返回参数说明
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码,0为查询成功 |
reason | string | 返回说明 |
result | string | 返回结果集 |
realtime | - | 当前天气详情情况 |
info | string | 天气情况,如:晴、多云 |
wid | string | 天气标识id,可参考小接口2 |
temperature | string | 温度,可能为空 |
humidity | string | 湿度,可能为空 |
direct | string | 风向,可能为空 |
power | string | 风力,可能为空 |
aqi | string | 空气质量指数,可能为空 |
future | - | 近5天天气情况 |
date | string | 日期 |
temperature | string | 温度,最低温/最高温 |
weather | string | 天气情况 |
direct | string | 风向 |
打开postman工具,没有的之间去官网进行下载安装即可,下载地址:https://www.postman.com/downloads/,安装很简单,这里就不介绍了,打开界面如下:
2.1 创建集合collection:首先需要创建一个集合collection,类似于项目名称,比如你需要测试多个项目的接口,那么可以创建对应的集合。如生活类接口测试,点击collection右边的 + 符合即可
2.2 然后你可以在collection下面添加文件夹,文件夹即你这个项目的模块,比如天气查询模块,电影查询模块,豆瓣top250书籍查询模块,这里我们添加一个 天气查询 ,将鼠标放在collection上面,会出现三个点,点击找到add folder即可。
2.3 然后在天气查询文件夹下面,添加请求 Add Request ,修改名称为 查询深圳天气,如下所示
接口主要信息:
接口请求地址:http://apis.juhe.cn/simpleWeather/query
请求方式:GET
请求参数:city(必填),key(必填)
点击请求方式那里,会下拉显示很多种方式,选择你需要的即可。
Params代表参数,每写入一行会默认添加一行。
Authorization:代表鉴权,比如一般API接口都会需要注册对应的网站,然后给你一个鉴权方式。一般可以直接加在头部里面.
Headers:代表请求的头部信息。
Body是请求体,post请求方式用的比较多,里面有多种格式,常用的比如 json。
将查询天气的接口写入,点击Send即可,下方会显示请求结果,即response响应内容,如下所示:
二、postman测试POST请求测试
博客园添加随笔的请求。
头部的Cookie为必须的,因为添加随笔的时候,是需要登录状态。
请求的数据为application/json 格式的,在头部也需要注明,其在postman测试如下