请不要问我为何知道这么详细,

-----以上纯属废话

-----本文根据接口文档来的, 若只是测试接口, 请绕行

首先在 collection 下建立文件夹, 以储存自己的接口测试的信息

建立文件 储存接口数据

文件夹右击 => Add Request

或者像这样,点击地址栏上面 + 号,再save到shop

文件名最好用 : 接口基准地址{url}/ + 请求路径

就像我这样, 除了能较为快速找到想要的东西,没其他好处

根据接口文档, 相当重要, 一般写在接口文档最前面

API V1 接口说明

接口基准地址：http://127.0.0.1:8888/api/private/v1/

服务端已开启 CORS 跨域支持

API V1 认证统一使用 Token 认证

需要授权的 API ，必须在请求头中使用 Authorization 字段提供 token 令牌

使用 HTTP Status Code 标识状态

数据返回格式统一使用 JSON

支持的请求方法

GET(SELECT)：从服务器取出资源(一项或多项)。

POST(CREATE)：在服务器新建一个资源。

PUT(UPDATE)：在服务器更新资源(客户端提供改变后的完整资源)。

PATCH(UPDATE)：在服务器更新资源(客户端提供改变的属性)。

DELETE(DELETE)：从服务器删除资源。

HEAD：获取资源的元数据。

OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的。

通用返回状态说明

状态码

含义

说明

200

OK

请求成功

201

CREATED

创建成功

204

DELETED

删除成功

400

BAD REQUEST

请求的地址不存在或者包含不支持的参数

401

UNAUTHORIZED

未授权

403

FORBIDDEN

被禁止访问

404

NOT FOUND

请求的资源不存在

422

Unprocesable entity

[POST/PUT/PATCH] 当创建一个对象时，发生一个验证错误

500

INTERNAL SERVER ERROR

内部错误

post 请求处理且传token值并在其他接口用

登录验证接口

请求路径：login

请求方法：post

请求参数

参数名

参数说明

备注

username

用户名

不能为空

password

密码

不能为空

响应参数

参数名

参数说明

备注

id

用户 ID

rid

用户角色 ID

username

用户名

mobile

手机号

email

邮箱

token

令牌

基于 jwt 的令牌

响应数据

{

"data": {

"id": 500,

"rid": 0,

"username": "admin",

"mobile": "123",

"email": "123@qq.com",

"token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjUwMCwicmlkIjowLCJpYXQiOjE1MTI1NDQyOTksImV4cCI6MTUxMjYzMDY5OX0.eGrsrvwHm-tPsO9r_pxHIQ5i5L1kX9RX444uwnRGaIM"

},

"meta": {

"msg": "登录成功",

"status": 200

}

}

突然变懒,画风突变

image.png

image.png

image.png

代码

var data = JSON.parse(responseBody);

if (data.data.token) {

tests["Body has token"] = true;

postman.setEnvironmentVariable("token", data.data.token);

}

else {

tests["Body has token"] = false;

}

image.png

验证

image.png

image.png

image.png

用户数据列表

请求路径：users

请求方法：get

请求参数

参数名

参数说明

备注

query

查询参数

可以为空

pagenum

当前页码

不能为空

pagesize

每页显示条数

不能为空

响应参数

参数名

参数说明

备注

total

总记录数

pagenum

当前页码

users

用户数据集合

响应数据

{

"data": {

"total": 5,

"pagenum": 1,

"users": [

{

"id": 25,

"username": "tige117",

"mobile": "18616358651",

"type": 1,

"email": "tige112@163.com",

"create_time": "2017-11-09T20:36:26.000Z",

"mg_state": true, // 当前用户的状态

"role_name": "炒鸡管理员"

}

]

},

"meta": {

"msg": "获取成功",

"status": 200

}

}

这里请求需要获取token值

接口说明中

image.png

image.png

image.png

image.png