接口测试是什么&接口测试文档规范

点击链接加入QQ群 522720170(免费公开课、视频应有尽有):https://jq.qq.com/?_wv=1027&k=5C08ATe

以下内容选自《大话软件测试-性能、自动化、安全及团队管理》

接口测试是什么?接口测试怎么做?这样的问题几乎每天都会被问到几十次,可见很多朋友对于接口测试并不是十分了解,而接口测试又是现在互联网产品测试中的重中之重,所以学习并掌握它是必须的。本章我们力争通俗化的揭开接口测试的面纱,让大家看到它的本质。

特别需要指出,在本书的其他章节也讲解了接口测试的相关内容,比如LoadRunner、Jmeter、SoapUI章节等,所以想掌握接口测试最好通读本书。

9.1接口测试是什么

接口有时候我们也会叫做API,不论是哪种叫法本质上都是接口,就好像叫你的全名和小名,本质上都是你这个人。对于接口测试是什么我们给大家进行两种解释。

不通俗的解释:发送一个请求到服务器端,服务器端处理完毕之后返回一个响应,我们对响应进行验证是否符合预期结果。至于服务器端是怎么处理这个请求的我们并不关心。我们只关心输入和输出即可,如图9.1。


图9.1 请求和响应

通俗的解释:接口和电脑的USB一样,你不需要关心内部是怎么实现的,你只需要知道这个接口在哪,怎么用,插上能干什么即可。比如:我要验证这个USB能不能用,那么插入鼠标,鼠标可以正常工作说明USB可以用,我们并不关心USB的实现逻辑。同理,我们的接口测试也是一样的。

9.2接口文档规范

接口测试进行的前提是一定要有接口文档,我们要通过文档获取接口的说明、请求参数、响应参数以及一些依赖关系。一般公司都会有接口文档的,毕竟开发人员也要做接口的维护,如果没有文档以后维护起来是比较麻烦的。当然有的公司确实没有接口文档,那对于测试工程师来说只能自己通过抓包来分析请求和响应了。

规范的接口文档不管是对于开发还是测试都是有百利而无一害的,一般都包括接口名、接口描述、接口地址、请求方式、请求参数和格式、响应参数和格式等,具体示例如下:

l 接口名:mLogin

l 接口描述:移动端登录接口

l 接口地址:http://xxx/mLogin

l 请求方式:POST

l 支持格式:JSON

l 请求参数:

username 必填 类型string 用户名

pwd 必填 类型string 密码

l 响应参数:

errorCode 状态码 0表示成功;1表示失败

username 用户名

这里只是举了个例子,实际需要哪些描述还是要根据实际情况做调整的。

对于接口文档的维护也是一件让人头疼的事情,尤其是接口数量比较多的时候。我见过的维护方法有如下几种:

l Word或者Excel维护。不推荐,量小的时候还可以,量大的时候太困难。

l Wiki维护。推荐,相对来说比较好管理。

l 接口文档维护工具。比如:apizza、apiview、小幺鸡等,如图9.2。


图9.2 接口文档维护工具

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,137评论 6 511
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,824评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,465评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,131评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,140评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,895评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,535评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,435评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,952评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,081评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,210评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,896评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,552评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,089评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,198评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,531评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,209评论 2 357

推荐阅读更多精彩内容

  • 扫盲内容: 1.什么是接口? 2.接口都有哪些类型? 3.接口的本质是什么? 4.什么是接口测试? 5.问什么要做...
    今天心情很美阅读 2,503评论 0 15
  • 什么是接口? 一般来说接口有两种,一种是程序内部的接口,一种是系统对外的接口。广义来说,客户端与后台服务间的协议;...
    青心不解杨柳枝阅读 1,512评论 0 1
  • 参考https://www.kancloud.cn/liupeizhi/openapi/292276https:/...
    Helen_Cat阅读 13,307评论 0 17
  • 基于Jmeter 工具的接口测试 1、Jmeter 工具的安装 1.1安装步骤: l安装环境:Windows XP...
    MrGago阅读 2,923评论 0 1
  • 夕阳西下的时候,总是会听见教堂晚钟的声音。通常那个时候,我已经从学校的车站下来往家的方向走,正经过那教堂前红砖砌成...
    徒然君阅读 486评论 0 0