如何看懂接口文档,怎么看懂下面的额接口文档,然后在postman里输入
大家好,关于如何看懂接口文档很多朋友都还不太明白,今天小编就来为大家分享关于怎么看懂下面的额接口文档,然后在postman里输入的知识,希望对各位有所帮助!
规范的接口文档中,都包含那些信息
一般一个规范的接口文档至少包含三部分信息,分别是基本信息,请求参数部分,响应部分
基本部分又包括接口名称,接口URL,请求方法以及描述信息;
请求参数部分主要包括请求头和请求体部分,主要是对这两个部分的每个字段定义的说明和解释
响应部分主要包括响应返回的数据类型,已经响应数据中每个字段的含义。
以前在黑马程序员培训后,也会买他们出版的书,这个就是直接从书上看的。现在很多大学都用的他们的教材,我就会没事看看。反正说的挺详细的。
接口文档包含的主要内容有哪些
一个规范的接口文档,要包含以下信息:
1)基本信息(接口名称、请求方法、请求路径、接口描述)
2)请求参数(请求头、请求体)
3)返回数据(不同情况的响应状态码、响应数据)
如果想系统的学习接口测试相关的技术,可以了解一下黑马程序员的软件测试课程,里面讲的非常详细。
怎么看懂下面的额接口文档,然后在postman里输入
在电脑桌面上找到安装的postman软件位置,鼠标双击图标打开;打开后显示如下界面即为打开成功。现在我们开始对一个接口进行测试
请点击输入图片描述
点击左上角的“+New”,在打开的弹窗页面中切换到creatNew页面(一般打开后默认就是creatNew页面),鼠标点击Collection,新建一个集合,这个集合就类似于一个文件夹,我们可以把一个项目或者一个完成功能的所有接口都放在它的里面。
请点击输入图片描述
在新打开的弹窗页面creat a new collection中,输入你想要给这个collection起的名字,然后再下方的description中添加描述说明,这个非必填项,所以可以忽略不写,直接点击右下角的“creat”进行确定。
请点击输入图片描述
选中刚刚建的collection,鼠标右击,在打开的菜单栏中选择“add request”,会进入下面的页面,输入这个接口请求的名称,同样可以在下方的description中添加描述说明,点击Save进行保存
请点击输入图片描述
按照接口文档中的描述,输入接口请求的url,添加请求头和请求体,点击运行,就完成了一个接口的测试。
请点击输入图片描述