1、编写接口文档。

前台用户管理、个人中心、用户绑定、文件上传通用接口。

1、前台用户列表：

简要描述：

• 前台用户列表接口，需展示总用户人数
• 有条件时，条件查询，其中名称查询为模糊查询，逆袭豆查询为范围查询
• 无条件时，展示列表

请求URL：

• dev.admin.daoxiangzhe.xiuzhenyuan.cn/a/u/user/list/search

请求方式：

• GET

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success",
    "data": {
        "user_sum": 100,
        "users": {
            "pageNum": 1,
            "pageSize": 10,
            "total": 2,
            "pages": 1,
            "list": [
                {
                    "id": 1,
                    "name": "用户一",
                    "img": "https://jnshu.com/image/123456.jpg",
                    "phone": 12345678901,
                    "email": "www.nishuoshenme.com",
                    "grade": "高一",
                    "score": 1212,
                    "status": 1
                },
                {
                    "id": 2,
                    "name": "用户二",
                    "img": "https://jnshu.com/image/123.jpg",
                    "phone": 12345678901,
                    "email": "www.nishuoshenme.com",
                    "grade": "高一",
                    "score": 1212,
                    "status": 0
                }
            ]
        }
    }
  }

返回参数说明

data数据说明

2、用户状态修改：

简要描述：

• 用户状态修改接口，每次访问都修改用户状态，冻结为0，解冻为1

请求URL：

• dev.admin.daoxiangzhe.xiuzhenyuan.cn/a/u/user/{id}

请求方式：

• GET

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success"
  }

返回参数说明

1、用户信息编辑（数据回显）：

简要描述：

• 用户信息编辑（数据回显）接口，可修改名称、头像、年级

请求URL：

• dev.home.daoxiangzhe.xiuzhenyuan.cn/b/user/{id}

请求方式：

• GET

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success",
    "data": {
        "id": 1,
        "name": "用户一二",
        "avatar_url": "http://jnshu.com/image/111.jpg",
        "grade": "高一",
        "score": 120
    }
  }

返回参数说明

data数据说明

2、用户信息编辑（数据提交）：

简要描述：

• 用户信息编辑（数据提交）接口

请求URL：

• dev.home.daoxiangzhe.xiuzhenyuan.cn/b/user/{id}

请求方式：

• PUT

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success"
  }

返回参数说明

1、用户（手机号）验证：

简要描述：

• 用户（手机号）验证接口，发送验证码

请求URL：

• dev.home.daoxiangzhe.xiuzhenyuan.cn/b/user/phone

请求方式：

• POST

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success"
  }

返回参数说明

2、用户（手机号）绑定：

简要描述：

• 用户（手机号）绑定接口，输入验证码，与手机号进行绑定

请求URL：

• dev.home.daoxiangzhe.xiuzhenyuan.cn/b/user/phone/verify

请求方式：

• POST

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success"
  }

返回参数说明

3、用户（邮箱）验证：

简要描述：

• 用户（邮箱）验证接口，发送验证码

请求URL：

• dev.home.daoxiangzhe.xiuzhenyuan.cn/b/user/email

请求方式：

• POST

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success"
  }

返回参数说明

2、用户（邮箱）绑定：

简要描述：

• 用户（邮箱）绑定接口，输入验证码，与邮箱进行绑定

请求URL：

• dev.home.daoxiangzhe.xiuzhenyuan.cn/b/user/email/verify

请求方式：

• POST

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success"
  }

返回参数说明

1、上传文件（图片、视频）：

简要描述：

• 通用接口，上传文件（图片、视频）接口，选择文件后上传，返回url地址

请求URL：

• dev.admin.daoxiangzhe.xiuzhenyuan.cn/a/upload

请求方式：

• POST

请求参数：

返回示例

  {
    "code": 200,
    "msg": "success",
    "data": {
        "file_url": "http://jnshu.com/image/111.jpg"
    }
  }

返回参数说明

data数据说明