用户部门信息对接 API 文档

一、部门管理

1.新增部门

1.1 简要描述

  • 新增部门接口

1.2 请求 URL

  • http://www.lushan.com/api/system/dept

1.3 请求方式

  • POST

1.4 请求示例

{
    "parentId": null,
    "orgCategory": "",
    "departName": "0",
    "mobile": "18711112222",
    "fax": "",
    "address": "",
    "departOrder": 0
}

1.5 请求参数说明

参数名 必选 类型 说明
postRank string 父级部门 id
companyId string 机构类型
createBy string 机构名称
mobile string 电话
fax string 传真
address string 地址
departOrder int 排序

1.6 返回示例

{
    "success": true,
    "message": "添加成功!",
    "code": 200,
    "result": "33b89272a79e4fb68205eb49e5fc67f7",
    "timestamp": 1634027967422
}

1.7 返回参数说明

参数名 类型 说明
result string 部门 id

1.8 备注

2.修改部门

2.1 简要描述

  • 修改部门接口

2.2 请求 URL

  • http://www.lushan.com/api/system/dept

2.3 请求方式

  • PUT

2.4 请求示例

{
    "deptId": "33b89272a79e4fb68205eb49e5fc67f7"
    "parentId": null,
    "orgCategory": "",
    "departName": "0",
    "mobile": "18711112222",
    "fax": "",
    "address": "",
    "departOrder": 0
}

2.5 请求参数说明

参数名 必选 类型 说明
deptId string 部门 id
parentId string 父级部门 id
orgCategory string 机构类型
departName string 机构名称
mobile string 电话
fax string 传真
address string 地址
departOrder int 排序

2.6 返回示例

{
    "success": true,
    "message": "更新成功!",
    "code": 200,
    "result": "33b89272a79e4fb68205eb49e5fc67f7",
    "timestamp": 1634027967422
}

2.7 返回参数说明

参数名 类型 说明
result string 部门 id

2.8 备注

3.删除部门

3.1 简要描述:

  • 删除部门接口

3.2 请求 URL

  • http://www.lushan.com/api/system/dept

3.3 请求方式

  • DELETE

3.4 请求参数说明

参数名 必选 类型 说明
deptId string 部门 id

3.5 返回示例

{
    "success": true,
    "message": "删除成功!",
    "code": 200,
    "result": "33b89272a79e4fb68205eb49e5fc67f7",
    "timestamp": 1634027967422
}

3.6 返回参数说明

参数名 类型 说明
result string 部门 id

3.7 备注

4.查询部门

4.1 简要描述

  • 用户注册接口

4.2 请求 URL

  • http://www.lushan.com/api/system/dept

4.3 请求方式

  • GET

4.4 请求参数说明

参数名 必选 类型 说明
deptId string 部门 id

4.5 返回示例

{
    "success": true,
    "message": "查询成功!",
    "code": 200,
    "result": {
        "deptId": "33b89272a79e4fb68205eb49e5fc67f7"
        "parentId": null,
        "orgCategory": "",
        "departName": "0",
        "mobile": "18711112222",
        "fax": "",
        "address": "",
        "departOrder": 0
    },
    "timestamp": 1634027967422
}

4.6 返回参数说明

参数名 类型 说明
deptId string 部门 id
parentId string 父级部门 id
orgCategory string 机构类型
departName string 机构名称
mobile string 电话
fax string 传真
address string 地址
departOrder int 排序

4.7 备注

二、用户管理

1.新增用户

1.1 简要描述

  • 新增用户接口

1.2 请求 URL

  • http://www.lushan.com/api/system/user

1.3 请求方式

  • POST

1.4 请求示例

{
    "username": "11111",
    "password": "123456Qq.",
    "confirmpassword": "123456Qq.",
    "realname": "1111",
    "workNo": "111111",
    "birthday": "2021-10-12",
    "sex": 1,
    "email": "123456@qq.com",
    "phone": "18711111111",
    "telephone": "",
    "avatar": null,
    "selectedroles": "1443144167322927106",
    "selecteddeparts": "65219b3426f24defa36660d3607bee1f",
    "userIdentity": "1",
    "id": "987110a788e74ffaa481529f5dc81343"
}

1.5 请求参数说明

参数名 必选 类型 说明
username string 用户账号
password string 登录密码
confirmpassword string 确认密码
realname string 用户姓名
workNo string 用户工号
birthday string 生日
sex int 性别
email string 邮箱
phone string 手机电话
telephone string 座机
avatar string 头像 url
selectedroles string 角色
selecteddeparts string 部门
userIdentity string 用户身份

1.6 返回示例

{
    "success": true,
    "message": "添加成功!",
    "code": 200,
    "result": "33b89272a79e4fb68205eb49e5fc67f7",
    "timestamp": 1634027967422
}

1.7 返回参数说明

参数名 类型 说明
result string 用户 id

1.8 备注

  • 姓别字典
字典值 说明
1 男生
2 女生

2.修改用户

2.1 简要描述

  • 修改用户接口

2.2 请求 URL

  • http://www.lushan.com/api/system/user

2.3 请求方式

  • PUT

2.4 请求示例

{
    "userId": "33b89272a79e4fb68205eb49e5fc67f7"
    "realname": "1111",
    "workNo": "111111",
    "birthday": "2021-10-12",
    "sex": 1,
    "email": "123456@qq.com",
    "phone": "18711111111",
    "avatar": null,
    "selectedroles": "1443144167322927106",
    "selecteddeparts": "65219b3426f24defa36660d3607bee1f",
    "userIdentity": "1",
    "id": "987110a788e74ffaa481529f5dc81343"
}

2.5 请求参数说明

参数名 必选 类型 说明
userId string 用户 id
realname string 用户姓名
workNo string 用户工号
birthday string 生日
sex int 性别
email string 邮箱
phone string 手机电话
avatar string 头像 url
selectedroles string 角色
selecteddeparts string 部门
userIdentity string 用户身份

2.6 返回示例

{
    "success": true,
    "message": "更新成功!",
    "code": 200,
    "result": "33b89272a79e4fb68205eb49e5fc67f7",
    "timestamp": 1634027967422
}

2.7 返回参数说明

参数名 类型 说明
result string 用户 id

2.8 备注

  • 姓别字典
字典值 说明
1 男生
2 女生

3.删除用户

3.1 简要描述:

  • 删除用户接口

3.2 请求 URL

  • http://www.lushan.com/api/system/user

3.3 请求方式

  • DELETE

3.4 请求参数说明

参数名 必选 类型 说明
userId string 用户 id

3.5 返回示例

{
    "success": true,
    "message": "删除成功!",
    "code": 200,
    "result": "33b89272a79e4fb68205eb49e5fc67f7",
    "timestamp": 1634027967422
}

3.6 返回参数说明

参数名 类型 说明
result string 用户 id

3.7 备注

4.查询用户

4.1 简要描述

  • 查询用户接口

4.2 请求 URL

  • http://www.lushan.com/api/system/user

4.3 请求方式

  • GET

4.4 请求参数说明

参数名 必选 类型 说明
userId string 用户 id

4.5 返回示例

{
    "success": true,
    "message": "查询成功!",
    "code": 200,
    "result": {
        "birthday": "2021-10-12",
        "sex_dictText": "男",
        "delFlag": 0,
        "workNo": "111111",
        "orgCode": "鹿山街道办事处",
        "id": "987110a788e74ffaa481529f5dc81343",
        "email": "123456@qq.com",
        "sex": 1,
        "updateTime": null,
        "departIds": "",
        "avatar": null,
        "realname": "1111",
        "createBy": "admin",
        "phone": "18711111111",
        "createTime": "2021-10-12 17:09:48",
        "username": "11111",
        "status": 1
    },
    "timestamp": 1634027967422
}

4.6 返回参数说明

参数名 类型 说明
birthday string 生日
sex_dictText string 性别字典值
delFlag string 删除标记
workNo string 工号
orgCode string 所属机构
id string 用户 id
email string 邮箱
sex int 性别字典
updateTime date 更新时间
departIds string 所属部门
avatar string 头像 url
realname string 用户姓名
createBy string 创建人
phone string 手机电话
createTime date 创建时间
username string 用户账号

4.7 备注