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 请求地址
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 请求地址
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运行结果