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 登錄接口

• 請求URLhttp://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=4058
sign值為：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	提示信息