请不要问我为何知道这么详细,
-----以上纯属废话
-----本文根据接口文档来的, 若只是测试接口, 请绕行
-
首先在 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 | 手机号 | |
| 邮箱 | ||
| 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
