python-week1-postman+jemter-soapUI

Posted 2020-09-18

BestTest接口规范

 

1 获取用户信息

1.1 功能描述

获取用户信息：该接口用于通过userid获取用户信息

1.2 请求地址

http://api.nnzhp.cn/getuser

1.3 请求方式

POST/GET

1.4 入参

参数	数据类型(长度)	是否必传	备注
userid	String	Y	用户id

1.5 出参

参数	数据类型(长度)	备注
code	int	状态码200为成功，500为异常
age	int	年龄
id	string	用户id
name	String	用户姓名

 

1.6 示例

请求：http://api.nnzhp.cn/getuser?userid=1

返回：{"age": 18, "code": 200, "id": "1", "name": "小明"}

1.7 运行结果

 

 

 

2 获取用户余额

2.1 功能描述

获取用户余额：传入userid获取用户余额

 

2.2  请求地址

http://api.nnzhp.cn/getmoney

 

2.3 请求方式

Post请求

 

2.4  入参 ，入参是json类型

参数	数据类型(长度)	是否必传	备注
userid	String	Y	用户id

 

2.5  出参

参数	数据类型(长度)	备注
code	int	状态码200为成功，500为异常
userid	int	用户id
money	string	余额

 

2.6 示例

请求：http://api.nnzhp.cn/getmoney?userid=1

返回：{‘code‘:200,‘userid‘:1,‘money‘:1000}

2.7 运行结果

 

 

3 修改用户余额

 

3.1  功能描述

修改用户余额：需要有http权限验证，账号admin密码123456

 

3.2  请求地址

http://api.nnzhp.cn/setmoney

 

3.3 请求方式

Post

3.4  入参

参数	数据类型(长度)	是否必传	备注
userid	String	Y	用户id
money	String	Y	修改的余额数值

 

3.5  出参

参数	数据类型(长度)	备注
code	int	状态码200为成功，500为异常
success	String	状态

 

3.6 示例

请求：http://api.nnzhp.cn/setmoney?userid=1&money=5000

 

返回：{‘code‘:200,‘success‘:‘成功‘}

注意：如果调用的时候传入的账号密码不对或者没传的话，返回权限验证失败

3.7运行结果

 

4 获取用户信息2

4.1 功能描述

获取用户信息：需要添加header，Content-Type application/json

 

标头 (header)：是服务器以HTTP协议传HTML资料到浏览器前所送出的字串，在标头与 HTML 文件之间尚需空一行分隔。

 

4.2 请求地址

http://api.nnzhp.cn/getuser2

 

4.3 请求方式

get/post

 

4.4  入参

参数	数据类型(长度)	是否必传	备注
userid	String	Y	用户id

 

4.5  出参

参数	数据类型(长度)	备注
code	int	状态码200为成功，500为异常
userid	int	用户id
name	string	用户名称
age	int	用户年龄

 

4.6  示例

请求:http://api.nnzhp.cn/getuser2?userid=1

返回：{‘code‘:200,id‘:1,‘name‘:‘小明‘,‘age‘:18}

 

4.7运行结果

 

5 修改用户余额2

5.1  功能描述

功能描述：需要添加cookie，token token是写死的token12345

 

5.2 请求地址

http://api.nnzhp.cn/setmoney2

 

5.3 请求方式

Post

 

5.4 入参

参数	数据类型(长度)	是否必传	备注
userid	String	Y	用户id
money	String	Y	修改的余额数值

 

5.5  出参

参数	数据类型(长度)	备注
code	int	状态码200为成功，500为异常
success	String	状态

 

 

5.6  示例

请求：http://api.nnzhp.cn/setmoney?userid=1&money=5000

 

返回：{‘code‘:200,‘success‘:‘成功‘}

注意：和接口3一样，不过是需要传入cookie，不需要http权限验证了

5.7运行结果

 

 

6 上传文件

6.1 功能描述

上传文件：向服务器（211.149.218）指定目录传送文件

 

6.2 请求地址

http://api.nnzhp.cn/uploadFile

 

6.3 请求方式

Post

 

6.4 入参

参数	数据类型(长度)	是否必传	备注
file	String	Y	上传文件

 

6.5 出参

参数	数据类型(长度)	备注
code	int	状态码200为成功，500为异常
success	String	状态

 

6.6运行结果