自带接口测试用例

1.文档主要提供本项目骨架已经集成的Api接口使用说明。
2.相关测试全部基于postman工具进行。

默认已经集成的路由

门户网站类

GET http://127.0.0.1:20191
GET /api/v1/home/news?newsType=portal&page=1&limit=50

后台管理类

GET /http://127.0.0.1:20201
GET /admin/ws
POST /admin/users/register
POST /admin/users/login
POST /admin/users/refreshtoken
GET /admin/users/index
POST /admin/users/create
POST /admin/users/edit
POST /admin/users/delete
POST /admin/upload/file

pprof 路由

调试模式自动开启，以pprof开头的路由
http://127.0.0.1:20191/debug/pprof/
http://127.0.0.1:20201/debug/pprof/

门户网站类

1.ip、端口使用本项目默认配置，即：http://127.0.0.1:20191，门户类接口通用

1.首页新闻

GET，/api/v1/home/news?newsType=portal&page=1&limit=50
返回示例：

{
    "code": 200,
    "data": {
        "content": "门户新闻内容001",
        "limit": 20,
        "newstype": "potal",
        "page": 1,
        "title": "门户首页公司新闻标题001",
        "user_ip": "127.0.0.1"
    },
    "msg": "Success"
}

后台应用类

1.ip、端口使用本项目默认配置，即：http://127.0.0.1:20201，后端管理类系统通用。

1.用户注册

表单参数验证器: register
POST，/admin/users/register

返回示例：

{
    "code": 200,
    "data": "",
    "msg": "Success"
}

2.用户登录

表单参数验证器: login
POST，/admin/users/login

返回示例，关于登陆时是否提交验证码取决于登陆路由(接口)是否加载了验证码中间件.

{
    "code": 200,
    "data": {
        "phone": "",
        "realName": "",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyaWQiOjQ3LCJ1c2VyX25hbWUiOiJnb3NrZWxldG9uMS40IiwicGhvbmUiOiIiLCJleHAiOjE2MDQwNTIxNzMsIm5iZiI6MTYwNDA0ODU2M30.YNhN9_QasHc5XILQiilZvhxpPDnmC_j82y4JfYPnI7A",
        "updated_at": "2020-10-30 17:02:53",
        "userId": 47,
        "user_name": "goskeleton1.4"
    },
    "msg": "Success"
}

3.根据关键词查询用户表

表单参数验证器: index
GET，/admin/users/index ， 该接口需要 token 鉴权，请在 header 头添加 Authorization 字段值， 注意：该字段的值格式：Bearer+(空格)+(token), 这个是行业标准，网页端显示换行，不要被误导!
CURD 相关的其他接口格式与本接口基本一致，例：/admin/users/create、/admin/users/edit、/admin/users/delete，只不过表单参数不一致。

返回示例：

{
    "code": 200,
    "data": [
        {
            "user_name": "zhang001",
            "phone": "1660177xxxx",
            "real_name": "张三丰",
            "status": 1,
            "token": "",
            "last_login_ip": ""
        },
        {
            "user_name": "goskeleton51",
            "phone": "1580403xxxx",
            "real_name": "新的姓名",
            "status": 1,
            "token": "",
            "last_login_ip": ""
        }
    ],
    "msg": "Success"
}

4.新增用户

表单参数验证器: create
POST，/admin/users/create ，注意该接口需要token鉴权，请在 header 头添加 Authorization 字段值，注意：该字段的值格式：Bearer (token)之间有一个空格, 这个是行业标准，网页端显示换行，不要被误导!

返回示例：

{
    "code": 200,
    "data": "",
    "msg": "Success"
}

5.更新用户

表单参数验证器: edit
POST ，/admin/users/edit ，注意该接口需要token鉴权，请在 header 头添加 Authorization 字段值，注意：该字段的值格式：Bearer (token)之间有一个空格, 这个是行业标准，网页端显示换行，不要被误导!

返回示例：

{
    "code": 200,
    "data": "",
    "msg": "Success"
}

6.删除用户

表单参数验证器: delete
POST，/admin/users/delete ，注意该接口需要token鉴权，请在 header 头添加 Authorization 字段值，注意：该字段的值格式：Bearer (token)之间有一个空格, 这个是行业标准，网页端显示换行，不要被误导!

返回示例：

{
    "code": 200,
    "data": "",
    "msg": "Success"
}

7.token刷新 ，请将旧token放置在header头参数直接提交更新

表单参数验证器: refresh_token
POST，/admin/users/refreshtoken

返回示例：

{
    "code": 200,
    "data": {
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyaWQiOjQ3LCJ1c2VyX25hbWUiOiJnb3NrZWxldG9uMS40IiwicGhvbmUiOiIiLCJleHAiOjE2MDQwNTYxMDcsIm5iZiI6MTYwNDA0ODU2M30.JPE6G-9YE9UTdxHiWuvdVlD-akiIkvp6Ezf9y4_ud9M"
    },
    "msg": "Success"
}

8.文件上传

表单参数验证器: upload_fiels
POST，/admin/upload/files

返回示例：

{
    "code": 200,
    "data": {
        "path": "/storage/app/uploaded/3c5d5f59484cad593e46d7fe0c6b078e.sql"
    },
    "msg": "Success"
}

postman 直接上传文件相关参数