目录

一、前言

二、Postman安装和使用

三、请求方式

四、资金记录接口实例演示

一、前言

    在前后端分离开发时，后端工作人员完成系统接口开发后，需要与前端人员对接，测试调试接口，验证接口的正确性可用性。而这要求前端开发进度和后端进度保持基本一致，任何一方的进度跟不上，都无法及时完成功能模块的测试。

    做为后端开发人员，要求独立开发完成某个接口后，开发人员自己需要先测试通过后再提交给测试人员进行测试，否则会出现到测试人员哪里业务流程根本就走不通，或者BUG会过多的情况等。

    市场上有很多优秀的，完善的接口测试工具，比如SoapUI，Postman等，能够高效的帮助后端开发人员独立进行接口测试。这里使用Postman接口测试工具，此处以请求方式为POST的userLogin登录接口为例。

二、Postman安装和使用

    1、这个直接去官网下载即可，我们使用免费版即可满足基本接口测试，根据个人或者公司的项目实际情况考虑是否需要专业版或者其他。

 

免费版官网链接：https://www.getpostman.com/postman

下载好的安装程序Postman-Win64-xxx-Setup.exe，双击安装即可。建议安装在非系统盘，即C盘在外的其他盘，另建议使用全英文路径，避免使用中文路径。

 


    2、打开Postman如下图2-1，可以关闭该页面跳过注册账户，非登陆状态下该工具可以直接使用。接下来出现引导页面，类似IDEA，Android Studio等开发工具的引导页。此处关闭即可。






 






3、进入Postman主页面并创建项目接口集合

    这里是我之前用过，所以左侧文件栏存在几个已有的文件夹。

    选择功能菜单New下的Collection创建项目接口集合。新建一个亿的项目A hundred million，可在Description部分写一下项目描述。






 






4、创建项目模块文件夹

    一般项目会分多个管理模块或者功能模块进行开发。这里可根据项目具体情况创建子文件夹方便接口管理。此处在A hundred million项目右键创建资产管理assets文件夹、user用户管理文件夹。可将测试的接口实例保存在对于管理模块下。







5、后台登录接口演示

    开发完成后台接口，编写正确严谨的逻辑代码处理前端请求。此处登录接口代码如下，运行后台开发项目，使该接口能够访问。接口请求路径为：http://localhost:8080/manage/app/user/login


@Controller
@RequestMapping("/manage/app/")
@Scope("prototype")
public class AppUserController {

   /**
    * 日志
    */
public static Logger customFile = LoggerFactory.getLogger("manageCustomFile");

@Resource
private AppUserService appUserService;

    /**
     * 用户登录
     * @param baseResult
     * @return
     */
    @RequestMapping(value = "user/login" , produces = "application/json;charset=UTF-8", method = RequestMethod.POST)
    @ResponseBody
    public BaseResult loginUser(@RequestBody BaseResult baseResult) {
        customFile.info("appId:"+ baseResult.getTreasureID()+ "用户登陆访问:" + baseResult.toString());
        return appUserService.loginUser(baseResult);
    }
}

6、新建接口测试

    在Postman主页面Content部分点击'+'按钮，新增一个接口测试。在图2-6所示第一部分填写接口请求路径，左侧下拉列表可选择请求方式，此处选择POST请求方式。接口请求路径为http://localhost:8080/manage/app/user/login。第二部分是请求体，即包含接口所需请求参数的Body，此处选择原始数据RAW，数据类型使用JSON数据作为请求数据。点击蓝色Send按钮发送请求，后台项目接口接收请求并响应返回执行结果。此处后台处理数据返回结果仍是JSON数据，这个看实际项目而定，此处仅做演示。第三部分是接口响应体，即接口响应请求处理并返回的数据。点击Pretty自动匹配接口返回的数据格式并对数据美化显示，使数据看起来更加直观。如果接口测试出现异常，则可以通过PreView视图查看浏览器响应接口的页面信息，也可以通过Header了解请求状态等参数。一般出现异常还是直接去后台看控制台的异常信息及项目日志来处理解决异常，再进行接口测试。







    接口测试通过后，可Ctrl+S保存接口测试实例，填写接口测试名称和接口描述信息，选择要保存的路径，此处保存在user用户管理模块文件夹。当项目的接口全部测试通过后，可在A hundred million项目右键Export导出接口文档，保存为JSON接口测试文件，该文件可通过Postman导入查看。



三、请求方式



    对于后台开发的接口，请求方式肯定不止POST一种，Postman也支持多种请求方式。在新建接口测试实例时可选择接口的请求方式，如图3-1。








    请求类型可以模拟Form表单文本提交，Form表单文件提交，raw原始数据提交，二进制文件提交。对于原始数据类型raw还支持不同文件格式，包括JSON，TXT，HTML等多种文件格式。








 



四、资金记录接口实例演示



    后台开发接口如下，服务器部署运行后台项目。接口请求路径为：http://localhost:8080/manage/app/user/asset/withdrawRecord


@Controller
@RequestMapping("/manage/app/")
@Scope("prototype")
public class AppUserAssetController {
 
    /**
     * 日志
     */
    public static Logger customFile = LoggerFactory.getLogger("manageCustomFile");

    @Resource
    private AppUserAssetService appUserAssetService;
    
    /**
     * 获取提现记录
     * 即我的页面中的资金记录
     * @param baseResult
     * @return
     */
    @RequestMapping(value = "user/asset/withdrawRecord" , produces = "application/json;charset=UTF-8", method = RequestMethod.POST)
    @ResponseBody
    public BaseResult getUserWithdrawRecord(@RequestBody BaseResult baseResult){
        customFile.info( "appId:"+ baseResult.getTreasureID() + "用户提现记录获取"+baseResult.toString());
        return appUserAssetService.getUserWithdrawRecord(baseResult);
    }
}

新建资金接口测试

请求方式为POST，

请求URL为http://localhost:8080/manage/app/user/asset/withdrawRecord

请求体为JSON类型的原始数据

点击Send请求接口，接口响应请求处理返回结果如图3-3所示







Powered By niaonao

 

接口测试简介

1.什么是接口

接口就是内部模块对模块，外部系统对其他服务提供的一种可调用或者连接的能力的标准，就好比usb接口，他是系统向外接提供的一种用于物理数据传输的一个接口，当然仅仅是一个接口是不能进行传输的，我们还的对这个接口怎么进行传输进行进行一些设置和定义。开发所谓的接口是模块模块之间的一种连接，而测试眼中的接口是一种协议（对接口的功能的一种定义）

2.接口的种类和分类

外部接口，内部接口：上层服务于下层服务，同级服务。常见的接口分类http：get，post，delete，put

系统对外的接口：比如你要从别的网站或服务器上获取资源或信息，别人肯定不会把数据库共享给你，他只能给你提供一个他们写好的方法来获取数据，你引用他提供的接口就能使用他写好的方法，从而达到数据共享的目的。

程序内部的接口：方法与方法之间，模块与模块之间的交互，程序内部抛出的接口，比如bbs系统，有登录模块、发帖模块等等，那你要发帖就必须先登录，那么这两个模块就得有交互，它就会抛出一个接口，供内部系统进行调用。

接口的分类：1.webservice接口 2.http api接口

　　webService接口是走soap协议通过http传输，请求报文和返回报文都是xml格式的，我们在测试的时候都用通过工具才能进行调用，测试。

　　http api接口是走http协议，通过路径来区分调用的方法，请求报文都是key-value形式的，返回报文一般都是json串，有get和post等方法，这也是最常用的两种请求方式。

　　json是一种通用的数据类型，所有的语言都认识它。（json的本质是字符串，他与其他语言无关，只是可以经过稍稍加工可以转换成其他语言的数据类型，比如可以转换成Python中的字典，key-value的形式，可以转换成JavaScript中的原生对象，可以转换成java中的类对象等。）

3.各个接口之间的区别

通常我们测试的接口分为get接口和post接口，get的提交方式是明文提交，把提交的参数跟在url后面发送给服务器，所以不安全，而且get提交的参数是有字符限制的且可以被当做书签保存，但是post的提交方式跟get完全不一样，post提交的参数是放在表单里的，所以不会存在字符限制，而且因为参数是放在表单里，不容易被看到，所以会比get更安全。

4.什么是接口测试

简单的来说接口测试对于测试来说其实是对接口协议的一种测试，这个协议指的是为了让这个接口实现某种需要的功能还设计的一种要求。

5.为什么要进行接口测试

因为不同端（前段，后端）的工作进度不一样，所以我们要针对最开始出来的接口，以及需要调用其他公司的（银行，支付宝，微信，qq等）一些接口进行接口测试及验证数据，从安全层面来说，只依赖前端进行限制已经完全不能满足系统的安全要求（绕过前面实在太容易），需要后端同样进行控制，在这种情况下就需要从接口层面进行验证。前后端传输、日志打印等信息是否加密传输也是需要验证的，特别是涉及到用户的隐私信息，如身份证，银行卡等。

6.接口测试流程

需求讨论，需求评审，场景设计，编写用列，准备数据，执行测试

7.怎么进行接口测试

通过工具模拟客户端向服务端发送请求并接受服务器返回的数据来对接口的功能，逻辑业务，异常，安全进行测试

功能测试：测试这个接口的功能是否实现，并且测试这个接口是否按照接口文档来进行开发的（比如说接口文档规定了一些关键字，而开大的时候把关键字改成了其他的关键字，因为在整个项目周期，并不只有一个开发而是有多个，所以可能因为在开发过程中因为关键字不一样导致某些开发的功能异常，还有自动化脚本也会发生异常）

　　逻辑业务，主要指的是一些逻辑业务依赖关系（比如支付宝提交订单的时候要保证你是在登录的情况下，如果你没有登录而提交成功了，这就是异常，可以修改请求的cookie来测试）

　　异常测试：参数异常：关键字参数（应用其他的关键字替换进行测试）、参数为空、参数多少（通过添加参数增添个数），参数错误。数据异常：关键字数据（填入的数据用其他的数据语言的数据替用）、数据长度、数据为空、数据错误。

　　

　　由于我们项目前后端调用主要是基于http协议的接口，所以测试接口时主要是通过工具或代码模拟http请求的发送与接收。工具有很多如：postman、jmeter、soupUI、java+httpclient、robotframework+httplibrary等。

　　–也可以用 接口自动化来实现，就是用代码实现，框架和UI自动化差不多，发送请求用断言来判断。

8.接口测试需要用到的工具

　 接口测试常用的工具，fiddler抓取请求，postman模拟客户端通过对fiddler抓取的请求修改并发送到服务端并接收服务器返回的数据及异常来进行验证接口。工具不是固定的，需要根据项目来进行选择。

9.接口的本质及其工作原理

　　接口你可以简单的理解他就是URL，工作原理就会说URL通过get或者post请求像服务器发送一些东西，然后得到一些相应的返回值，本质就是数据的传输与接收。

接口测试用例设计思路

目的：测试接口的正确性和稳定性；

　　原理：模拟客户端向服务器发送请求报文，服务器接收请求报文后对相应的报文做处理并向客户端返回应答，客户端接收应答的过程；

　　重点：检查数据的交换，传递和控制管理过程，还包括处理的次数；

　　核心：持续集成是接口测试的核心；

　　优点：为高复杂性的平台带来高效的缺陷监测和质量监督能力，平台越复杂，系统越庞大，接口测试的效果越明显（提高测试效率，提升用户体验，降低研发成本）；

　　用例设计重点：通常情况下主要测试最外层的两类接口:数据进入系统接口（调用外部系统的参数为本系统使用）和数据流出系统接口（验证系统处理后的数据是否正常）；

　　PS：设计用例时还需要注意外部接口提供给使用这些接口的外部用户什么功能，外部用户真正需要什么功能；

1 输入

　　输入参数主要从以下几各方面设计：

　　a 必填项校验

　　接口文档中有是否必填的说明。参考接口文档即可。

　　b 参数长度校验

　　参考接口文档即可。

　　c 参数值的有效性校验

　　如：身份证号的校验 ，设计的数据虽然符合身份证号的规则，但是并不是真实有效的身份证号；这种情况就要看身份证号的校验规则是什么样了，一般都是用的现成的身份证号校验器，但是有些是自己写的校验算法，这个本人就遇到过这种问题—校验算法写的不正确；

　　所以参数有效性的校验就需要结合实际业务场景，判断哪些数据是真实有效的数据，一定要确保所有真实有效的数据是可以验证通过的。

　　d 参数组合校验

　　不同的参数组合可能会存在不同的业务场景；

　　e 如果参数是枚举值，一定要各种枚举值都要测试，因为可能不同的枚举走的不同的业务流程；

　　f 参数值的默认值的校验

　　参考接口文档。

　　g 某些参数具有特定的生成规则，要单独针对生成规则设计用例，一定要保证真实有效的数据是可以验证通过的。

　　如身份证号中间几位 ***19860701*，本人就遇到过输入***19861001*这种值校验不正确；

2 接口逻辑

　　接口逻辑我用的设计方法是分支覆盖—>路径覆盖—>场景覆盖,同样也是要结合实际业务场景，根本不发生的业务场景就是无效的测试用例。

　　a 第一步先把业务流程图画出来；

　　b 依据路程图中的分支分别设计，不同分支不同的场景，这里就要把异常的场景考虑进去；如接口超时，接口异常，接口请求成功或失败，成功后怎么处理，失败后流程是否继续执行，失败后的数据怎么处理；

　　以打款接口为例：

　　打款结果有打款成功或打款失败，成功后怎么处理，需要回写打款成功状态，失败后怎么处理，也需要回写失败状态，失败后的数据可以操作退回，也可以操作重新出款等等；

c 测试逻辑设计完成后要想一想不同的业务场景怎么去测试，需要哪些人员协助，

如接口超时怎么去测试，请求重复怎么去测试，请求并发怎么去测试

3 输出

输入结果：正常输出和异常输出，常用的方法有错误推断法（列举出程序中可能存在的错误或者异常，根据他们选择测试用例）

4 以上都完成后，要结合实际的业务场景去掉冗余的用例（即实际业务场景不存在的流程或者输入数据）；

5 如果业务流程涉及到状态转换，要单独设计用户—方法：状态转换图；

6 涉及到多个不同金额或者手续费的计算，可能还会用到正交实验法去设计用例；

7 另外，用例设计中还应当包含异常流程中产生的异常数据的处理流程；—通常所说的补偿机制，这块流程能大大的减轻人工运营的工作量，当然，这需要在做系统设计的时候就需要把这部分考虑进去。

接口测试和app测试的相同和区别

1.两者区别：App端性能主要关注与手机相关的特性，如手机cpu、内存、流量、fps等。而接口性能主要关注接口响应时间、并发、服务端资源的使用情况等。两种测试时的策略和方法都有很大区别，所以这部分内容是需要分开单独进行测试的，理论上来说这也是不同的部分。

2.接口测试持续集成：

　　对接口测试而言，持续集成自动化是核心内容，通过持自动化的手段我们才能做到低成本高收益。目前我们已经实现了接口自动化，主要应用于回归阶段，后续还需要加强自动化的程度，包括但不限于下面的内容：

　　　　a) 流程方面：在回归阶段加强接口异常场景的覆盖度，并逐步向系统测试，冒烟测试阶段延伸，最终达到全流程自动化。

　　　　b) 结果展示：更加丰富的结果展示、趋势分析，质量统计和分析等

　　　　c) 问题定位：报错信息、日志更精准，方便问题复现与定位。

　　　　d) 结果校验：加强自动化校验能力，如数据库信息校验。

　　　　e) 代码覆盖率：不断尝试由目前的黑盒向白盒下探，提高代码覆盖率。

　　　　f) 性能需求：完善性能测试体系，通过自动化的手段监控接口性能指标是否正常。

最后ps：接口测试需要掌握的知识。

　　①了解系统及内部各个组件之间的业务逻辑交互；

　　②了解接口的I/O（input/output：输入输出）；

　　③了解协议的基本内容，包括：通信原理、三次握手、常用的协议类型、报文构成、数据传输方式、常见的状态码、URL构成等；

　　④常用的接口测试工具，比如：jmeter、loadrunner、postman、soapUI等；

　　⑤数据库基础操作命令（检查数据入库、提取测试数据等）；

　　⑥常见的字符类型，比如：char、varchar、text、int、float、datatime、string等；　

　　如何学这些技能？

　　①系统间业务交互逻辑：通过需求文档、流程图、思维导图、沟通等很多渠道和方式；

　　②协议：推荐《图解http》这本书，内容生动，相对算是入门级的书籍，其他的还有《图解tcp、IP》等；

　　③接口测试工具：百度这些工具，然后你会发现，好多的教学博客、相关问题解决方案、以及一些基于工具的书籍，当然，选择合适的书很重要；

　　④数据库操作命令：学习网站（W3C、菜鸟教程）、教学博客，以及一些数据库相关书籍，入门级推荐：《mysql必知必会》、《oracle PL/SQL必知必会》等

　　⑤字符类型：还是百度，有句话这么说：内事不决问百度，外事不决问Google。。。

　　 如何获取接口相关信息？

　　一般的企业，都会由开发或者对应的技术负责人员编写接口文档，里面会注明接口相关的地址、参数类型、方法、输入、输出等信息，如果没有，想办法获取。。。

　　接口文档八要素：

　　封面：封面最好是本公司规定的封面，有logo，内容标题，版本号，公司名称，文档产生日期；

　　修订历史：表格形式较好些，包括：版本、修订说明、修订日期、修订人、审核时间审核人等；

　　接口信息：接口调用方式，常用的GET/POST方式，接口地址；

　　功能描述：简洁清晰的描述接口功能，比如：接口获取的信息不包括哪些；

　　接口参数说明：每个参数都要和实际中调用的一样，包括大小写；参数的含义言简意赅的说明，格式，是string 还是int 还是long等格式；

　　 说明部分，说明参数值是需要哪里提供，并详细说明参数怎么生成的，例如时间戳，是哪个时间段的，参数是否必填，一些参数是必须要有的，有些是可选参数等；

　　返回值说明：

　　①最好有一个模板返回值，并说明每个返回参数的意义；

　　②提供一个真实的调用接口，真实的返回值；

　　调用限制，安全方面：

　　加密方式，或者自己公司一个特殊的加密过程，只要双方采用一致的加密算法就可以调用接口，保证了接口调用的安全性，比如常见的md5；

　　文档维护：文档在维护的时候，如有修改一定要写上修改日期，修改人，对大的修改要有版本号变更；

　　其他相关知识？

　　get请求，post请求的区别：

　　1、GET使用URL或Cookie传参。而POST将数据放在BODY中。

　　2、GET的URL会有长度上的限制，则POST的数据则可以非常大。

　　3、POST比GET安全，因为数据在地址栏上不可见。

　　4、一般get请求用来获取数据，post请求用来发送数据。

　　其实上面这几点，只有最后一点说的是比较靠谱的，第一点post请求也可以把数据放到url里面，get请求其实也没长度限制，post请求看起来参数是隐式的，稍微安全那么一些些，但是那只是对于小白用户来说的，就算post请求，你通过抓包也是可以抓到参数的。（唯一区别就是这一点，上面3点区别都是不准确的）

　　http状态码：

　　1、200 2开头的都表示这个请求发送成功，最常见的就是200，就代表这个请求是ok的，服务器也返回了。

　　2、300 3开头的代表重定向，最常见的是302，把这个请求重定向到别的地方了。

　　3、400 400代表客户端发送的请求有语法错误，401代表访问的页面没有授权，403表示没有权限访问这个页面，404代表没有这个页面。

　　4、500 5开头的代表服务器有异常，500代表服务器内部异常，504代表服务器端超时，没返回结果。

　　webservice接口怎么测试：

　　它不需要你在拼报文了，会给一个webservice的地址，或者wsdl文件，直接在soapui导入，就可以看到这个webservice里面的所有接口，也有报文，直接填入参数调用，看返回结果就可以了。

　　天气预报wsdl地址：http://www.webservicex.net/globalweather.asmx?wsdl　　

　　cookie与session的区别：

　　1、cookie数据存放在客户的浏览器上，session数据放在服务器上。

　　2、cookie不是很安全，别人可以分析存放在本地的cookie并进行cookie欺骗

　　考虑到安全应当使用session。

　　3、session会在一定时间内保存在服务器上。当访问增多，会比较占用你服务器的性能

　　考虑到减轻服务器性能方面，应当使用cookie。

　　4、单个cookie保存的数据不能超过4K，很多浏览器都限制一个站点最多保存20个cookie。

　　5、所以个人建议：

　　将登陆信息等重要信息存放为session

　　其他信息如果需要保留，可以放在cookie中

 

说起接口测试，网上有很多例子，但是当初做为新手的我来说，看了不不知道他们说的什么，觉得接口测试，好高大上。认为学会了接口测试就能屌丝逆袭，走上人生巅峰，迎娶白富美。因此学了点开发知识后，发现接口测试其实都是人们玩的名词罢了。接口测试，真心很简单。它只不过是数据传递是一种表现而已。

请求模型

​ 看下图中“A”线，可以理解为接口就是一个电灯的开关，它在接口里面给你提供了一个参数，参数的值一个是“开”，一个是“关”。



​ 说起来，怎么才能让灯亮？一个灯头接两根线，一根线接火线，一根线接零线这时灯就亮了。反之，不接零线、火线灯就灭了。

​ 其实接口呢，就把这些复杂的操作简化了，让你看到的就只有一个开关，而你来操作这个开关就好了。我们做接口测试也只需要测试这个开关就完成任务了，接口测试就是这么简单。

当你访问“http://127.0.0.1:8080/light?opt=open”，让零线、火线连通，此时灯亮。
	
当你访问“http://127.0.0.1:8080/light?opt=close”，让零线、火线断开，此时灯灭。
请求结构

​ 看到这里我们大致就明白了接口测试是怎么一回事了。接下来需要理解一下HTTP的URL是怎么组成为一个接口的。如图：




	
一个URL就是一个接口：接口大致会分为一下几个部分：

	

		
请求协议：

		
http — 普通的http请求
			
https — 加密的http请求，传输数据更加安全
			
ftp — 文件传输协议，主要用来传输文件
		
		

		
请求IP：就是指提供接口的系统所部署的服务器地址
		
		

		
请求端口：如果不填端口，默认是80，否则需要填写端口号
		
		

		
接口路径：指系统提供的接口在什么位置
		
		

		
接口参数：参数在接口路径后，用“?”来表示路径地址完了，剩下的都是参数了，用“&”来区分参数个数，

		
如下示例：

		

		
http://127.0.0.1:8080/light?opt=open&use=yy&pwd=123456
		

		
假设要操作这个灯，需要用户密码，则可以增加新的参数”use”、”pwd”，用”&”来隔开。可以看到这个示例有3个参数：

		
“opt”:”open”
			
“use”:”yy”
			
“pwd”:”123456”
		
		

		
接口HTTP参数【url看不见等隐藏参数】

		

			
http请求方式

			
GET --- 通过请求URI得到资源
POST --- 用于添加新的内容
PUT --- 用于修改某个内容
DELETE --- 删除某个内容
CONNECT --- 用于代理进行传输，如使用SSL
OPTIONS --- 询问可以执行哪些方法
PATCH --- 部分文档更改
PROPFIND (wedav) --- 查看属性
PROPPATCH (wedav) --- 设置属性
MKCOL (wedav) --- 创建集合（文件夹）
COPY (wedav) --- 拷贝
MOVE (wedav) --- 移动
LOCK (wedav) --- 加锁
UNLOCK (wedav) --- 解锁
TRACE --- 用于远程诊断服务器
HEAD --- 类似于GET, 但是不返回body信息，用于检查对象是否存在，以及得到对象的元数据

			
			

			
http请求头

			
请求头包含许多有关的客户端环境和请求正文的有用信息。例如，请求头可以声明浏览器所用的语言，请求正文的长度。示例：

			
Accept:image/gif.image/jpeg./
Accept-Language:zh-cn
Connection:Keep-Alive
Host:localhost
User-Agent:Mozila/4.0(compatible:MSIE5.01:Windows NT5.0)
Accept-Encoding:gzip,deflate.

			
			

			
http请求体

			
请求体就是请求等正文了，可以有很多种请求体。

			
json格式
				
xml格式
				
html格式
				
二进制格式( 多数用于图片 )
				
字符串格式
			
		
	
​ 看到上面的请求结构，就能接口测试了，只需要修改接口的参数，就可以像功能测试一样测了。可以用功能测试设计用例的方法来设计接口测试的用例。可以使用各种测试用具辅助测试，下图为“postman”测试工具。





接口的请求会发向哪里

我们可以看看这样一个接口，用Java的Servlet怎么来实现

package com.yy.test;

import net.sf.json.JSONObject;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

// 接口的名称与路径，urlPatterns中的/light，就是说在输入地址与ip后，定义的接口名字http://127.0.0.1:8080/light 
@WebServlet(name = "light", urlPatterns = "/light")
public class light extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 获取opt的值 
        String opt = request.getParameter("opt");

        // 新建返回json的对象 
        JSONObject json = new JSONObject();

        // 判断opt有没有值 
        if (null != opt) {

            // 定义返回的请求头，类型是json，编码是utf-8 
            response.setContentType("application/json; charset=UTF-8");

            // 定义返回的对象，用它来将json输出 
            PrintWriter out = response.getWriter();

            // 判断opt的值是不是open 
            if ("open".equals(opt)) {
                json.put("msg", "开灯啦！");
                out.println(json);
            }

            // 判断opt的值是不是close 
            else if ("close".equals(opt)) {
                json.put("msg", "关灯啦！");
                out.println(json);
            }
        }
    }
}


上面的代码大致做了如下几个操作：

获取opt的值
	

	
判断获取的opt的值

	
如果是”open”就返回”开灯啦！”
		

		
如果是”close”就返回”关灯啦！”

		
看到上面的代码，就能发现，我们将opt的值，传进”http://127.0.0.1:8080/light“这个接口中，当你拿到你想要的值，想做什么都可以了，对吧。我这边的代码就是简单的进行了返回，当你访问了我“开灯”的接口，我就直接告诉你“开灯了” ( 其实我什么都没做，这已经算是一个BUG了。所以测试接口要看看它到底生效了没有，也就是说，灯真的开了吗？)，我们做接口测试，需要开发提供接口文档。最重要的有一下几点：
		
	
	

	
被测接口的地址
	
	
接口参数，以及各个参数的说明
	
必要的http头与http体 ( http头是可以自定义的，可以用来校验是否是自己人访问 )
	
接口返回什么值，以及各个返回值的说明
	
接口是干什么的
确定了这些，才能做好接口测试。好的接口文档如下：



复杂一点的接口，RESTful



一个用户接口可以通过以下4种不同方式的请求，来做不同的事情：

获取用户信息
	
创建用户
	
修改用户
	
删除用户
你完全可以像“灯”的那个例子，用GET请求来传递不同的参数来实现，但是这样如果接口多了，就会很混乱，很难管理。

这时，我们需要一种规则：

当用“GET”方式时，只用来获取数据，成功了返回http状态码200
	
当用“POST”方式时，只用来创建数据，成功了返回http状态码201
	
当用“PUT”方式时，只用来修改数据，成功了返回http状态码203
	
当用“DELETE”方式时，只用来删除数据，成功了返回http状态码204
	
当请求发送失败，返回http状态码400
这样子的规则，我们称它为“RESTful”标准。

下图是RESTful的状态码返回



5. 接口测试

前面的搞清楚了，接口测试就简单了，其实就是几个步骤。

拿到接口的url地址
	
查看接口是用什么方式发送
	
添加请求头，请求体
	
发送查看返回结果，校验返回结果是否正确
这个是正常的一套流程，异常的情况，就不用我多说来吧。比如参数不传值呀，传的值不正确呀，明明要求用"GET"请求发送，偏要用"POST"请求发送呀。等等有很多异常情况，一般懂功能测试都能想到很多的异常情况，这里不再举例来。

下面我以百度翻译的接口为例子：

请求地址：http://fanyi.baidu.com/v2transapi

请求方式：POST

请求参数：

​ from — 哪国语言

    to --- 翻译成哪国语言

    query --- 翻译都内容


​ 我使用Python语言来进行接口测试，使用”requests”库来编写代码比较简答易懂，如果没有安装”requests”库，可以打开cmd，输入”pip install requests”来安装

import requests

# 接口的url 
url = "http://fanyi.baidu.com/v2transapi"

# 接口的参数 
params = { 
    "from":"en", 
    "to":"zh", 
    "query": "test"
}

# 发送接口 
r = requests.request("post", url, params=params)

# 打印返回结果 
print(r.text)

# 其实到上面就已经完了，因为百度不是我自己写的接口，为了让结果看的更加清楚一点，我取来翻译的字段 
import json
d = json.loads(r.text)
print(d['liju_result']['tag'])
返回结果

['试验', '测验', '考验', '化验', '考查', '受试验', '受测验', '受考验', '测得结果']


可以试着将"query"的参数改成"student"，返回结果也随之改变

import requests

url = "http://fanyi.baidu.com/v2transapi"
params = { 
    "from":"en", 
    "to":"zh", 
    "query": "student" # 我改了这里 
}

r = requests.request("post", url, params=params)

import json
d = json.loads(r.text)
print(d['liju_result']['tag'])
返回结果

['中学生', '学生', '大学生', '研究者', '学者']


​ 当然，要是不懂代码，也可以使用工具进行测试，只要记住填写的几个点，就可以做好接口测试，下图是使用”postman”进行测试：

输入发送方式”POST”
	
输入测试地址”http://fanyi.baidu.com/v2transapi“
	
输入下图红框参数
	
点击”send”，查看返回结果


 接口测试就是这么简单

接口测试用例

接口测试用例的设计就没什么好讲的了，与功能测试一样设计就好了。我是用Excel来编写的，主要是为了方便管理，只要写的干净，让人看的很舒服就好了。我自己设计的用例是这样的：

一个模块对应一个Excel表
	
一条接口对应一张sheet表
	
表中一行对应一条测试用例
	
在开始要注明测试时需要的sql，如下图开始我会创建用户，用完了我会删除
这样的用例比较好管理，如图：



整个接口测试就这么多了。接口测试其实很简单，在功能测试眼里，接口测试那么高大上，其实不也过如此了。

无意中发现了一个巨牛的人工智能教程，忍不住分享一下给大家。教程不仅是零基础，通俗易懂，而且非常风趣幽默，像看小说一样！觉得太牛了，所以分享给大家。点这里可以跳转到教程。

HTTP的接口测试工具有很多，可以进行http请求的方式也有很多，但是可以直接拿来就用，而且功能还支持的不错的，我使用过的来讲，还是postman比较上手。

 

优点：

1、支持用例管理

2、支持get、post、文件上传、响应验证、变量管理、环境参数管理等功能

3、支持批量运行

4、支持用例导出、导入

5、支持云端保存用例【付费用户】

 

可以说POSTMAN满足了HTTP接口测试的大部分功能，只有少部分的功能不被支持，比如：请求流程的控制；前面说了这么多，接下来我们就看看POSTMAN的安装与使用吧。

 

1、什么是POSTMAN

POSTMAN是一个Chrome的一个插件工具，我们可以通过Chrome的应用商店进行搜索并安装，安装完成会在桌面上显示一个postman的图标，每次点击这个图标就可以启动POSTNA的界面。



启动过后就是上面的界面了，左边是用来管理用例的目录结构，右边是具体某个用例的请求内容的参数及响应内容；默认的postman会自带一个demo的项目叫“POSTMAN Echo”，里面有各种场景的用例demo，对于新上手的同学可以通过查看这些demo用例来学习如何使用POSTMAN。

 

2、新建一个项目

直接点击左边栏上面的添加目录图标来新增一个根目录，这样就等于新建了一个项目，我们可以把一个项目或一个模块的用例都存放在这个目录之下，并且在根目录之下我们还可以在建立子目录来进行功能用例的细分，具体见下图。



2、新增一个用例

创建了项目目录后我们就可以新建用例了，具体是点击右侧区域的+号来新增一个空用例的模板，也可以通过复制一个已有用例来达到新建一个用例的目的，2种方法见下：



 

3、添加请求信息

新建的用例请求内容为空，我们需要添加相应的请求信息，这部分的操作都在右侧的信息区域，一般流程如下：

 

选择一个请求方法，如：get或post
	
填写请求的url，如：http://www.baidu.com
	
如果是get则请求参数直接写在url后，用？连接
	
如果是post则请求添加在body中
	
点击“send”发送请求
	
查看请求响应内容
 



 

4、post请求参数

post请求的主要的特点是把请求数据放在body中，而非url后



上面的样例是post方式传输普通参数，如果我们需要发送带文件的请求时，就要改下请求格式了，具体如下：



注意上面标红框的内容，都是必须要对应上。

 

5、添加头信息

有些时候请求时还需要一些特定的头信息，postman同样可以完美的支持，直接点击Headers标签就可以进行请求头的信息设置



 

6、预处理和结果检查

预处理主要是对一些环境变量之类的进行设置，相当于数据初始化；如图：



响应处理就是对响应结果进行分析和验证，比如检查code是不是200，内容是不是等于具体某个值，是否包含特定的值等等。



 

因为预处理和结果检查都是使用js作为脚本语言，所以你还可以进行任意的js可以实现的场景，来辅助测试。

 

7、全局变量与环境变量

全局变量我们可以自己在预处理和结果处理2个脚本环境里进行赋值，在具体的测试数据里我们就可以直接使用，具体的使用方法是为：{{variable_key}}；比如你在脚本中可以设置全局变量：

 

postman.setGlobalVariable("username", "tester");

那么在用例数据项里面我就可以这样使用，{{username}}，用来代表具体的tester值，具体见下图

 



而环境变量的设置可使用与全局变量基本一样，只是环境变量我们还有另外一个入口可以进行设置，那就是环境配置管理中，我们可以预先建立若干和与环境相关的一套变量，根据实际的测试需求在执行前选择对应的环境变量模板，这样可以快速切换测试服务器与线上服务器之前的环境差异。比如：配置2套环境变量模板，一套url是测试环境，另一套为线上环境，根据测试对象不同我们选择不同的环境变量模板就行了，而不再需要修改测试数据中的url了。

上面我们就把请求的host提取出来，然后在不同环境变量模板里使用不同的url值，后面我们就可以通过选择不同的环境变量模板来进行对应的请求测试

 

8、导出用例为代码

POSTMAN还有一个很赞的地方就是导出用例为CODE，即如果你编写好了用例之后可以通过点击“Generate Code”来一键生成代码，并且还有好多语言和类库可以选择，帧的是棒棒哒！



 

9、批量执行用例

最后我们再来看看POSTMAN的批量执行功能，这个功能由单独的runner来负责的，我们需要在另外的界面进行操作，具体如下：



依次点击上面的按钮就会出现runer界面，如下直接点击“Start Test”即可