interface-user.md 5.1 KB

接口设计 - 用户

登录

系统登录需要UAS账号(手机号和密码)验证

请求路径

/login

请求方式

HTTP - POST

请求参数
{
    "userName": "手机号",
    "passWord": "密码"
}
返回结果
{
    "data": {
        "code":200,
        "msg":"成功",
        "data": {
            "token": "...",
            "times": "1538971981364",
            "user": {
                "id":31,
                "name": "张三",
                "userName":"17600000000",
                "passWord":"11111111",
                "department":"销售经理",
                "post":"国内销售科",
                "role":null,
                "phone":"17600000000",
                "createDate":null,
                "updateDate":null
            }
        }
    }
}

获取用户列表

请求路径

/getUserList

请求方式

HTTP - POST

请求参数

返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": [{
            "id": 16,
            "name": "张三",
            "userName": "17600000000",
            "passWord": "111111",
            "department": "销售经理",
            "post": "国内销售科",
            "role": "admin",
            "phone": null,
            "createDate": "2018-09-28T18:29:11.000+0000",
            "updateDate": null
        }, {
            "id": 22,
            "name": "李四",
            "userName": "18100000000",
            "passWord": "111111",
            "department": "采购跟单科科长",
            "post": "采购部",
            "role": null,
            "phone": null,
            "createDate": "2018-09-29T10:24:26.000+0000",
            "updateDate": null
        }]
    }
}

获得用户组列表

请求路径

/getUserGroupList

请求方式

HTTP - POST

请求参数

返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": [{
            "id": 43,
            "userGroupName": "BI项目组",
            "userGroupNote": "BI项目组",
            "createDate": "2018-09-06T14:03:02.000+0000",
            "updateDate": "2018-09-29T17:44:24.000+0000"
        }]
    }
}

添加用户组

请求路径

/createUserGroup

请求方式

HTTP - POST

请求参数
{
    "userGroupName": "组名",
    "userGroupNote": "备注"
}
返回结果

删除用户组

请求路径

/delUserGroup

请求方式

HTTP - POST

请求参数
[id: 用户组id]
返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}

修改用户组

请求路径

/updateUserGroup

请求方式

HTTP - POST

请求参数
{
    "id": "用户组id",
    "userGroupName": "新用户组名",
    "userGroupNote": "新备注"
}
返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}

获得用户组成员列表

请求路径

/getUserInGroup

请求方式

HTTP - POST

请求参数
用户组id
返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": [{
            "id": 16,
            "name": "祝通鸿",
            "userName": null,
            "passWord": null,
            "department": "销售经理",
            "post": "国内销售科",
            "role": "admin",
            "phone": null,
            "createDate": null,
            "updateDate": null
        }, {
            "id": 22,
            "name": "陈文俊",
            "userName": null,
            "passWord": null,
            "department": "采购跟单科科长",
            "post": "采购部",
            "role": null,
            "phone": null,
            "createDate": null,
            "updateDate": null
        }]
    }
}

添加用户组成员

请求路径

/setUserInto

请求方式

HTTP - POST

请求参数
{
    "userList": ["用户id"],
    "userGroupId": "用户组id"
}
返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}

删除用户组成员

请求路径

/delUserInGroup

请求方式

HTTP - POST

请求参数
{
    "userList": ["用户id"],
    "userGroupId": "用户组id"
}
返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}

关键字查询用户

请求路径

/getNameList

请求方式

HTTP - POST

请求参数
关键字
返回结果
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": [{
            "id": 16,
            "name": "祝通鸿",
            "userName": null,
            "passWord": null,
            "department": "销售经理",
            "post": "国内销售科",
            "role": "admin",
            "phone": null,
            "createDate": null,
            "updateDate": null
        }]
    }
}