HTTP接口测试

HTTP接口测试

1.1 get接口

  • 请求URL http://api.nnzhp.cn/api/user/stu_info

  • 请求方式 get

  • 请求参数

参数名必选类型说明
stu_namestring学生姓名

http://api.nnzhp.cn/api/user/stu_info?stu_name=test001

{"error_code": 0,-"stu_info": [-{"id": 4058,"name": "test001","sex": "男","age": 18,"addr": "北京市昌平区","grade": "7","phone": "15062431255","gold": 25100}

1.2 post 接口

2.2.1 登录接口

  • 请求URLhttp://api.nnzhp.cn/api/user/login

  • 请求方式 post

  • 请求参数 : 参数为key-value形式

参数名必选类型说明
usernamestring用户名
passwdstring密码

登陆用户名:niuhanyang 密码:aA123456

post方法的参数是放在body中的,参数直接放到URL中是无效的

{    "error_code": 0,    -"login_info": {    "login_time": "20200509211925",    "sign": "34972ea3f42d75c03574d3553a4df77e",    "userId": 47749    }}

返回参数说明

参数名类型说明
error_codeint错误编码,0为操作成功
login_infoobject登录对象信息
userIdint用户id
signstring签名
login_timestring登录时间

2.2.2 添加学生信息接口

  • 请求URL:http://api.nnzhp.cn/api/user/add_stu

  • 请求方式 post

  • 参数 ,入参是json类型

参数名必选类型说明
namestring学生姓名
gradestring班级
phoneint电话
sexstring性别,如果不传默认为男
ageint年龄,如果不传默认为18
addrstring地址,如果不传默认为北京市昌平区

返回参数说明

参数名类型说明
error_codeint错误编码,1000为操作成功
msgstring提示信息

请求示例

{    "name":"micr067",    "grade":"白羊座",    "phone":13888888880,    "sex":"男",    "age":26,    "addr":"北京市朝阳区"}

返回示例

{    "error_code": 0,    "msg": "操作成功!"}

2.2.3 学生金币充值

  • 请求URL:http://api.nnzhp.cn/api/user/gold_add

  • 请求方式 post

  • 参数 : 该接口有权限验证,需要admin用户才可以做操作,需要添加cookie cookie中key为登录的用户名,value从登录接口中获取,登陆成功之后会返回sign

参数名必选类型说明
stu_idint学生id
goldint金币数量

返回参数说明

参数名类型说明
error_codeint错误编码,0为操作成功
msgstring提示信息

如上述描述,入参形式需要添加cookie

cookie是保存在用户浏览器端的一个键值对 session就是保存在服务器的一个键值对,一般session都是存在缓存里面,因为要经常用到,要提升性能的话直接把session放到内存里面。

该接口有权限验证,需要admin用户才可以做操作,需要添加cookie我们通过“获取学生信息”接口查看到学生的id信息,然后通过“登录”接口,获取niuhanyang的签名的值如下:查询出ID=4058sign值为:34972ea3f42d75c03574d3553a4df77e

Header:

cookie:niuhanyang=34972ea3f42d75c03574d3553a4df77e

Body

stu_id:4058

gold:1000

2.2.4 获取所有学生信息

  • 请求URL:http://api.nnzhp.cn/api/user/all_stu

  • 请求方式 get

  • 参数 ,需要添加header信息,key为Referer value 为http://api.nnzhp.cn/

返回参数说明

参数名类型说明
error_codeint错误编码,0为操作成功
all_stulist提示信息

1、如果不添加header,直接用浏览器地址栏访问,会提示来路不正确

{        "error_code": 4,        "msg": "请求来路不正确"}

2、添加header信息,并进行调用

Referer:http://api.nnzhp.cn

2.2.5 文件上传类型

  • 请求URL:http://api.nnzhp.cn/api/file/file_upload

  • 请求方式 post

  • 参数

参数名必选类型说明
filefile文件

返回参数说明

参数名类型说明
error_codeint错误编码,0为操作成功
msgstring提示信息