# 接口设计 - 用户
## 登录
系统登录需要UAS账号（手机号和密码）验证
##### 请求路径
`/login`
##### 请求方式
`HTTP - POST`
##### 请求参数
```json
{
    "userName": "手机号",
    "passWord": "密码"
}
```
##### 返回结果
```json
{
    "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`
##### 请求参数
无
##### 返回结果
```json
{
    "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`
##### 请求参数
无
##### 返回结果
```json
{
    "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`
##### 请求参数
```json
{
    "userGroupName": "组名",
    "userGroupNote": "备注"
}
```
##### 返回结果

___

## 删除用户组
##### 请求路径
`/delUserGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数
```
[id: 用户组id]
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}
```
___

## 修改用户组
##### 请求路径
`/updateUserGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数
```json
{
    "id": "用户组id",
    "userGroupName": "新用户组名",
    "userGroupNote": "新备注"
}
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}
```
___

## 获得用户组成员列表
##### 请求路径
`/getUserInGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数
```
用户组id
```
##### 返回结果
```json
{
    "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`
##### 请求参数
```json
{
    "userList": ["用户id"],
    "userGroupId": "用户组id"
}
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}
```
___

## 删除用户组成员
##### 请求路径
`/delUserInGroup`
##### 请求方式
`HTTP - POST`
##### 请求参数
```json
{
    "userList": ["用户id"],
    "userGroupId": "用户组id"
}
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": null
    }
}
```
___

## 关键字查询用户
##### 请求路径
`/getNameList`
##### 请求方式
`HTTP - POST`
##### 请求参数
```
关键字
```
##### 返回结果
```json
{
    "data": {
        "code": 200,
        "msg": "成功",
        "data": [{
            "id": 16,
            "name": "祝通鸿",
            "userName": null,
            "passWord": null,
            "department": "销售经理",
            "post": "国内销售科",
            "role": "admin",
            "phone": null,
            "createDate": null,
            "updateDate": null
        }]
    }
}
```
___