HTTP接口测试
HTTP接口测试
1.1 get接口
请求URL
http://api.nnzhp.cn/api/user/stu_info
请求方式 get
请求参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
stu_name | 是 | string | 学生姓名 |
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 登录接口
请求URL
http://api.nnzhp.cn/api/user/login
请求方式 post
请求参数 : 参数为key-value形式
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
username | 是 | string | 用户名 |
passwd | 是 | string | 密码 |
登陆用户名:niuhanyang 密码:aA123456
post方法的参数是放在body中的,参数直接放到URL中是无效的
{ "error_code": 0, -"login_info": { "login_time": "20200509211925", "sign": "34972ea3f42d75c03574d3553a4df77e", "userId": 47749 }}
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
error_code | int | 错误编码,0为操作成功 |
login_info | object | 登录对象信息 |
userId | int | 用户id |
sign | string | 签名 |
login_time | string | 登录时间 |
2.2.2 添加学生信息接口
请求URL:
http://api.nnzhp.cn/api/user/add_stu
请求方式 post
参数 ,入参是json类型
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
name | 是 | string | 学生姓名 |
grade | 是 | string | 班级 |
phone | 是 | int | 电话 |
sex | 否 | string | 性别,如果不传默认为男 |
age | 否 | int | 年龄,如果不传默认为18 |
addr | 否 | string | 地址,如果不传默认为北京市昌平区 |
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
error_code | int | 错误编码,1000为操作成功 |
msg | string | 提示信息 |
请求示例
{ "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_id | 是 | int | 学生id |
gold | 是 | int | 金币数量 |
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
error_code | int | 错误编码,0为操作成功 |
msg | string | 提示信息 |
如上述描述,入参形式需要添加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_code | int | 错误编码,0为操作成功 |
all_stu | list | 提示信息 |
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
参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
file | 是 | file | 文件 |
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
error_code | int | 错误编码,0为操作成功 |
msg | string | 提示信息 |