前台 用户模块 - d4smart/Traveller GitHub Wiki

1. 注册

/user/register post

request

username,password,gender,phone,avatar,signature,captcha
必需:username,password,captcha
说明:gender必须为男或女

response

fail

{
"code": 1,
"msg": "验证码错误/用户信息不完整/用户性别填写错误/用户名已存在/手机号已存在/注册失败"
}

success

{
"code": 0,
"msg": "注册成功"
}

2. 登陆

/user/login post

request

username,password,captcha
必需:username,password,captcha

response

fail

{
"code": 1,
"msg": "验证码错误/用户名或密码不能为空/用户名与密码不匹配/暂时不可以登陆,如有疑问,请联系后台管理员"
}

success

{
"code": 0,
"msg": "登陆成功",
"data":{
"id": 1,
"username": "d4smart",
"gender": "男",
"phone": "15171444706",
"avatar": "/image/2018/03/1522401513524.png",
"signature": "一江春水向东流",
"canLogin": true,
"canPublish": true,
"isAdmin": true,
"createTime": "2018-03-30 11:18:19",
"updateTime": "2018-04-02 19:17:25"
}
}

3. 获取自己的信息

/user/info get

request

无参数

response

success

{
"code": 0,
"data":{
"id": 1,
"username": "d4smart",
"gender": "男",
"phone": "15171444706",
"avatar": "/image/2018/03/1522401513524.png",
"signature": "一江春水向东流",
"canLogin": true,
"canPublish": true,
"isAdmin": true,
"createTime": "2018-03-30 11:18:19",
"updateTime": "2018-04-02 19:17:25"
}
}

4. 更新用户信息

/user/update post

request

username,password,gender,phone,avatar,signature
必需:无
说明:gender必须为男或女

response

fail

{
"code": 1,
"msg": "用户性别填写错误/用户名已存在/手机号已存在/更新用户信息失败"
}

success

{
"code": 0,
"msg": "更新用户信息成功",
"data":{
"id": 1,
"username": "d4smart",
"gender": "男",
"phone": "15171444706",
"avatar": "/image/2018/03/1522401513524.png",
"signature": "一江春水向东流",
"canLogin": true,
"canPublish": true,
"isAdmin": true,
"createTime": "2018-03-30 11:18:19",
"updateTime": "2018-04-02 19:52:39"
}
}

5. 检查 用户名/手机号 是否合法

/user/checkValid get

request

type(username/phone),value(对应的值)
必需:type,value

response

fail

{
"code": 1,
"msg": "参数错误/用户名已存在/手机号已存在"
}

success

{
"code": 0,
"msg": "校验成功"
}

6. 登出

/user/logout post

request

无参数

response

success

{
"code": 0,
"msg": "退出登陆成功"
}

7. 关注用户

/user/follow post

request

id
必需:id

response

fail

{
"code": 1,
"msg": "自己不能关注自己/要关注的用户不存在/关注用户失败/您已经关注过这个用户"
}

success

{
"code": 0,
"msg": "关注用户成功"
}

8. 取消关注用户

/user/unfollow post

request

id
必需:id

response

fail

{
"code": 1,
"msg": "自己不能取消关注自己/要取消关注的用户不存在/取消关注用户失败"
}

success

{
"code": 0,
"msg": "取消关注用户成功"
}

9. 是否关注了用户

/user/isFollowing get

request

id
必需:id

response

fail

{
"code": 1,
"msg": "参数错误/没有关注这个用户"
}

success

{
"code": 0,
"msg": "关注了这个用户"
}

10. 粉丝

/user/follower get

request

pageNum,pageSize
必需:无

response

success

{
    "code": 0,
    "data": {
        "list": [
        ],
        "pageNum": 1,
        "pageSize": 10,
        "totalPage": 0,
        "totalRow": 0
    }
}

11. 关注的人

/user/following get

request

pageNum,pageSize
必需:无

response

success

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 2,
                "username": "易水人去",
                "gender": "女",
                "phone": "15896209327",
                "avatar": "",
                "signature": "",
                "canLogin": true,
                "canPublish": true,
                "isAdmin": false,
                "createTime": "2018-03-30 14:26:13",
                "updateTime": "2018-03-30 14:26:13"
            },
            {
                "id": 3,
                "username": "d4smarter",
                "gender": "男",
                "phone": "17553421379",
                "avatar": "/image/2018/04/1522634396537.jpg",
                "signature": "一蓑烟雨任平生",
                "canLogin": true,
                "canPublish": true,
                "isAdmin": false,
                "createTime": "2018-04-02 19:39:27",
                "updateTime": "2018-04-02 19:39:27"
            },
            {
                "id": 5,
                "username": "iomger",
                "gender": "男",
                "phone": "17551321379",
                "avatar": "1.jpg",
                "signature": "一蓑烟雨任平生",
                "canLogin": true,
                "canPublish": true,
                "isAdmin": false,
                "createTime": "2018-04-09 16:09:41",
                "updateTime": "2018-04-09 16:09:41"
            },
            {
                "id": 6,
                "username": "yat140",
                "gender": "女",
                "phone": "13297968882",
                "avatar": "",
                "signature": "",
                "canLogin": true,
                "canPublish": true,
                "isAdmin": false,
                "createTime": "2018-04-10 15:48:48",
                "updateTime": "2018-04-10 15:48:48"
            },
            {
                "id": 13,
                "username": "mageluer",
                "gender": "男",
                "phone": "13611337789",
                "avatar": "666.jpg",
                "signature": "一蓑烟雨任平生",
                "canLogin": true,
                "canPublish": true,
                "isAdmin": false,
                "createTime": "2018-04-16 16:55:53",
                "updateTime": "2018-04-16 16:55:53"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "totalPage": 1,
        "totalRow": 5
    }
}

12. 用户动态

/user/dynamics get

request

pageNum,pageSize
必需:无
说明:根据用户的关注生成的攻略动态,类似于QQ中的好友动态功能

response

success

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 15487,
                "title": "武汉一日游",
                "authorId": 6,
                "author": {
                    "username": "yat140",
                    "avatar": "/image/2018/05/1525232310539.jpg"
                },
                "places": "武汉",
                "thumbnail": "/image/2018/04/1524799754504.jpg",
                "views": 1,
                "likes": 0,
                "comments": 0,
                "createTime": "2018-04-27 11:29:14",
                "updateTime": "2018-05-07 17:27:27"
            },
            {
                "id": 15486,
                "title": "武汉一日游",
                "authorId": 6,
                "author": {
                    "username": "yat140",
                    "avatar": "/image/2018/05/1525232310539.jpg"
                },
                "places": "武汉",
                "thumbnail": "",
                "views": 0,
                "likes": 0,
                "comments": 0,
                "createTime": "2018-04-27 11:28:11",
                "updateTime": "2018-04-27 11:28:11"
            },
            {
                "id": 15485,
                "title": "去旅游",
                "authorId": 6,
                "author": {
                    "username": "yat140",
                    "avatar": "/image/2018/05/1525232310539.jpg"
                },
                "places": "香山公园",
                "thumbnail": "",
                "views": 0,
                "likes": 0,
                "comments": 0,
                "createTime": "2018-04-27 11:22:42",
                "updateTime": "2018-04-27 11:22:42"
            }
        ],
        "pageNum": 1,
        "pageSize": 3,
        "totalPage": 6,
        "totalRow": 16
    }
}

13. 获取用户信息

/user/get get

request

id(用户的id)
必需:id

response

fail

{
    "code": 1,
    "msg": "参数错误/用户不存在"
}

success

{
    "code": 0,
    "data": {
        "follower": 1,
        "following": 4,
        "collection": 3,
        "user": {
            "id": 1,
            "username": "d4smart",
            "gender": "男",
            "phone": "17551321379",
            "avatar": "/image/2018/04/1524022147663.jpg",
            "signature": "恰似飞鸿踏雪泥",
            "createTime": "2018-03-30 11:18:19",
            "updateTime": "2018-05-07 10:24:05"
        }
    }
}