app接口测试手册1.0.2

书旗APP接口测试手册

修订记录

日期版本号类别描述作者

2014-6-9 1.0.0 A 增加接口测试工具使用说

明；

示例说明接口测试思路及

测试用例分析

梁丽君

2014-6-17 1.0.2 M 修改和增加测试原理和测

试逻辑说明

梁丽君

目录

1接口测试工具使用说明 (3)

1.1 【接口设置】--【接口分组】 (3)

1.2 【接口设置】--【新建接口】 (3)

1.3 【接口设置】--【查看接口】 (4)

1.4 【测试】--【接口测试】 (5)

2 测试用例位置说明 (6)

3 接口测试说明 (7)

3.1 【用户相关接口】模块说明 (7)

3.1.1 【用户身份唯一性验证及生成接口】用例设计 (8)

3.2【书旗书城IOS接口】模块说明 (24)

3.2.2 【获取书签接口】用例设计 (25)

3.3 【书旗书城接口】模块说明 (30)

3.3.1 【购买章节接口】用例设计 (32)

3.4 【一搜接口】模块说明 (43)

3.4.1 【书本检查更新接口】用例设计 (44)

3.5【支付类接口】模块说明 (50)

3.5.1【UC支付充值接口】用例设计 (51)

1接口测试工具使用说明

工具地址：http://210.14.131.100:8887/auth/login

工具维护接口人：殷振华

登陆帐号：默认你的姓名全拼

密码：123456

主要功能使用介绍：

1.1 【接口设置】--【接口分组】

用途：标识被测接口特性分类

1.2 【接口设置】--【新建接口】

接口名称：对应用例名称

分组：所属接口组名

URL：被测接口地址

URL参数：此处传递的参数对应接口文档中的get参数部分。格式形如：bookid(94525),user_id(23423423) ，多个参数之间用英文逗号分隔；同一个参数存在多个值时，使用下划线_ 分隔，形如：bookid(94532425_945324_3234425_55524234) 方法：仅包含URL参数时，默认选中GET方法；当包含POST数据时，选择POST方法

POST数据：对应接口文档中需要传递的post参数，文档中没有标注清楚时，需要找相关研发人员进行确认。参数之间用&分隔，形如：session=A86AT8tt6KN6A816HJGTG8XZtHAJZ&email=liang@& mobile=185********

Post函数：

默认为none；当post数据采用特殊的加密方式进行传输时，需要进行选择。需要根据接口文档中的加密规则进行判断，如有新的加密规则出现，可反馈给工具开发人员进行处理。简要提示：1 测试账户相关接口时，post函数选用sq_auth；2 测试书城相关接口时，使用sq_token函数；3 测试书签接口，使用md5_key函数；4 测试支付类接口，使用uc_pay 函数；5 测试书籍购买接口，使用sq_token_sign函数

返回格式：

一般为xml与json串，当设置的格式与接口数据的返回格式不匹配时，response中的validation 会标识为“不合格”

1.3 【接口设置】--【查看接口】

用途：用于修改接口测试用例，点击【编辑】即可进入编辑模式

1.4 【测试】--【接口测试】

用途：执行接口测试

选中接口分组下待测试的用例，点击【测试】按钮，下方展示Request，Response，以及返回结果，可为xml、json数据格式。

形如：

当Response返回code为200时，说明http请求成功；若返回5xx状态码，则说明服务器处理有异常；若返回4xx状态码，则说明客户端发生错误，需要排查请求的url参数是否符合要求。

【保存】--点击此按钮，可保存当前接口测试的结果。注：每次测试后点击，均将当前的结果替换成上一次的结果，为覆盖保存逻辑

【对比】--展开上一次测试时保存的结果，用于与当前结果进行比对

【折叠】--点击此按钮，可将接口测试结果面板区域进行隐藏

2 测试用例位置说明

App接口测试用例，位于testlink--> 测试产品：【阅读业务中心】APP接口，Testlink地址：http://testlink.ucweb.local/index.php

目前包括5个模块，共计53个接口，如下图

3 接口测试说明

以下将分别选取5个模块下的测试点，进行用例设计说明：

3.1 【用户相关接口】模块说明

说明：

提供与用户身份获取、账户资料、账号绑定相关的测试，需求文档详见“账户接口文档_20140307.doc”

测试点举例：

用户身份唯一性验证及生成接口

接口地址：

/appapi/ppuser/ppuser_app_imeisn2userid.php

Get参数：

user_id=xxxx 必选

sn=xxxxx 必选

imei=xxxxxxxxxx 必选

Post参数：

Key=加密验证码

业务说明：

1. 结合实际业务，用户身份包括两类，一类是准会员，一类是会员。app中使用user_id标识唯一用户身份，而user_id的生成，依赖于对传入的imei、sn参数的判断。

简要判断逻辑：

接口先判断uid是否是正式会员，是则返回成功，否则返回失败；

判断是准会员，且验证通过，则返回成功；是准会员验证不通过，重新按sn，imei来生成新的uid。

准会员重新生成uid的逻辑判断，根据u+s+i唯一性来进行处理。先判断i是否相同，若i不相同，且sn不为空，则生成新uid；若i不相同，且原来的sn为空，则绑定新的sn，且重新生成uid；若i，u相同，原来的sn为空，则绑定新的sn，uid不重新生成；若i相同，sn不为空，则分配新uid。

2.根据接口条件可知，输入包括get和post参数，其中post参数中的key传输会通过加密的方式，故在借用工具进行验证时，需要使用特殊函数进行处理，此处使用的方法已封装在sq_auth 中。