用户部门信息对接 API 文档
<h2>一、部门管理</h2>
<h3>1.新增部门</h3>
<h4>1.1 简要描述</h4>
<ul>
<li>新增部门接口</li>
</ul>
<h4>1.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/dept</code></li>
</ul>
<h4>1.3 请求方式</h4>
<ul>
<li>POST</li>
</ul>
<h4>1.4 请求示例</h4>
<pre><code>{
"parentId": null,
"orgCategory": "",
"departName": "0",
"mobile": "18711112222",
"fax": "",
"address": "",
"departOrder": 0
}</code></pre>
<h4>1.5 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">postRank</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>父级部门 id</td>
</tr>
<tr>
<td style="text-align: left;">companyId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>机构类型</td>
</tr>
<tr>
<td style="text-align: left;">createBy</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>机构名称</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>电话</td>
</tr>
<tr>
<td style="text-align: left;">fax</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>传真</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">departOrder</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>排序</td>
</tr>
</tbody>
</table>
<h4>1.6 返回示例</h4>
<pre><code>{
"success": true,
"message": "添加成功!",
"code": 200,
"result": "33b89272a79e4fb68205eb49e5fc67f7",
"timestamp": 1634027967422
}</code></pre>
<h4>1.7 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">string</td>
<td>部门 id</td>
</tr>
</tbody>
</table>
<h4>1.8 备注</h4>
<ul>
<li>无</li>
</ul>
<h3>2.修改部门</h3>
<h4>2.1 简要描述</h4>
<ul>
<li>修改部门接口</li>
</ul>
<h4>2.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/dept</code></li>
</ul>
<h4>2.3 请求方式</h4>
<ul>
<li>PUT</li>
</ul>
<h4>2.4 请求示例</h4>
<pre><code>{
"deptId": "33b89272a79e4fb68205eb49e5fc67f7"
"parentId": null,
"orgCategory": "",
"departName": "0",
"mobile": "18711112222",
"fax": "",
"address": "",
"departOrder": 0
}</code></pre>
<h4>2.5 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deptId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>部门 id</td>
</tr>
<tr>
<td style="text-align: left;">parentId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>父级部门 id</td>
</tr>
<tr>
<td style="text-align: left;">orgCategory</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>机构类型</td>
</tr>
<tr>
<td style="text-align: left;">departName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>机构名称</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>电话</td>
</tr>
<tr>
<td style="text-align: left;">fax</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>传真</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">departOrder</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>排序</td>
</tr>
</tbody>
</table>
<h4>2.6 返回示例</h4>
<pre><code>{
"success": true,
"message": "更新成功!",
"code": 200,
"result": "33b89272a79e4fb68205eb49e5fc67f7",
"timestamp": 1634027967422
}</code></pre>
<h4>2.7 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">string</td>
<td>部门 id</td>
</tr>
</tbody>
</table>
<h4>2.8 备注</h4>
<ul>
<li>无</li>
</ul>
<h3>3.删除部门</h3>
<h4>3.1 简要描述:</h4>
<ul>
<li>删除部门接口</li>
</ul>
<h4>3.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/dept</code></li>
</ul>
<h4>3.3 请求方式</h4>
<ul>
<li>DELETE</li>
</ul>
<h4>3.4 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deptId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>部门 id</td>
</tr>
</tbody>
</table>
<h4>3.5 返回示例</h4>
<pre><code>{
"success": true,
"message": "删除成功!",
"code": 200,
"result": "33b89272a79e4fb68205eb49e5fc67f7",
"timestamp": 1634027967422
}</code></pre>
<h4>3.6 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">string</td>
<td>部门 id</td>
</tr>
</tbody>
</table>
<h4>3.7 备注</h4>
<ul>
<li>无</li>
</ul>
<h3>4.查询部门</h3>
<h4>4.1 简要描述</h4>
<ul>
<li>用户注册接口</li>
</ul>
<h4>4.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/dept</code></li>
</ul>
<h4>4.3 请求方式</h4>
<ul>
<li>GET</li>
</ul>
<h4>4.4 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deptId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>部门 id</td>
</tr>
</tbody>
</table>
<h4>4.5 返回示例</h4>
<pre><code>{
"success": true,
"message": "查询成功!",
"code": 200,
"result": {
"deptId": "33b89272a79e4fb68205eb49e5fc67f7"
"parentId": null,
"orgCategory": "",
"departName": "0",
"mobile": "18711112222",
"fax": "",
"address": "",
"departOrder": 0
},
"timestamp": 1634027967422
}
</code></pre>
<h4>4.6 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deptId</td>
<td>string</td>
<td>部门 id</td>
</tr>
<tr>
<td style="text-align: left;">parentId</td>
<td>string</td>
<td>父级部门 id</td>
</tr>
<tr>
<td style="text-align: left;">orgCategory</td>
<td>string</td>
<td>机构类型</td>
</tr>
<tr>
<td style="text-align: left;">departName</td>
<td>string</td>
<td>机构名称</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td>string</td>
<td>电话</td>
</tr>
<tr>
<td style="text-align: left;">fax</td>
<td>string</td>
<td>传真</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td>string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">departOrder</td>
<td>int</td>
<td>排序</td>
</tr>
</tbody>
</table>
<h4>4.7 备注</h4>
<ul>
<li>无</li>
</ul>
<h2>二、用户管理</h2>
<h3>1.新增用户</h3>
<h4>1.1 简要描述</h4>
<ul>
<li>新增用户接口</li>
</ul>
<h4>1.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/user</code></li>
</ul>
<h4>1.3 请求方式</h4>
<ul>
<li>POST</li>
</ul>
<h4>1.4 请求示例</h4>
<pre><code>{
"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"
}</code></pre>
<h4>1.5 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">username</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户账号</td>
</tr>
<tr>
<td style="text-align: left;">password</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录密码</td>
</tr>
<tr>
<td style="text-align: left;">confirmpassword</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>确认密码</td>
</tr>
<tr>
<td style="text-align: left;">realname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户姓名</td>
</tr>
<tr>
<td style="text-align: left;">workNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户工号</td>
</tr>
<tr>
<td style="text-align: left;">birthday</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>生日</td>
</tr>
<tr>
<td style="text-align: left;">sex</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>性别</td>
</tr>
<tr>
<td style="text-align: left;">email</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>邮箱</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手机电话</td>
</tr>
<tr>
<td style="text-align: left;">telephone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>座机</td>
</tr>
<tr>
<td style="text-align: left;">avatar</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>头像 url</td>
</tr>
<tr>
<td style="text-align: left;">selectedroles</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>角色</td>
</tr>
<tr>
<td style="text-align: left;">selecteddeparts</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>部门</td>
</tr>
<tr>
<td style="text-align: left;">userIdentity</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户身份</td>
</tr>
</tbody>
</table>
<h4>1.6 返回示例</h4>
<pre><code>{
"success": true,
"message": "添加成功!",
"code": 200,
"result": "33b89272a79e4fb68205eb49e5fc67f7",
"timestamp": 1634027967422
}</code></pre>
<h4>1.7 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">string</td>
<td>用户 id</td>
</tr>
</tbody>
</table>
<h4>1.8 备注</h4>
<ul>
<li>姓别字典</li>
</ul>
<table>
<thead>
<tr>
<th>字典值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>男生</td>
</tr>
<tr>
<td>2</td>
<td>女生</td>
</tr>
</tbody>
</table>
<h3>2.修改用户</h3>
<h4>2.1 简要描述</h4>
<ul>
<li>修改用户接口</li>
</ul>
<h4>2.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/user</code></li>
</ul>
<h4>2.3 请求方式</h4>
<ul>
<li>PUT</li>
</ul>
<h4>2.4 请求示例</h4>
<pre><code>{
"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"
}</code></pre>
<h4>2.5 请求参数说明</h4>
<h4></h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户 id</td>
</tr>
<tr>
<td style="text-align: left;">realname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户姓名</td>
</tr>
<tr>
<td style="text-align: left;">workNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户工号</td>
</tr>
<tr>
<td style="text-align: left;">birthday</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>生日</td>
</tr>
<tr>
<td style="text-align: left;">sex</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>性别</td>
</tr>
<tr>
<td style="text-align: left;">email</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>邮箱</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手机电话</td>
</tr>
<tr>
<td style="text-align: left;">avatar</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>头像 url</td>
</tr>
<tr>
<td style="text-align: left;">selectedroles</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>角色</td>
</tr>
<tr>
<td style="text-align: left;">selecteddeparts</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>部门</td>
</tr>
<tr>
<td style="text-align: left;">userIdentity</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>用户身份</td>
</tr>
</tbody>
</table>
<h4>2.6 返回示例</h4>
<pre><code>{
"success": true,
"message": "更新成功!",
"code": 200,
"result": "33b89272a79e4fb68205eb49e5fc67f7",
"timestamp": 1634027967422
}</code></pre>
<h4>2.7 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">string</td>
<td>用户 id</td>
</tr>
</tbody>
</table>
<h4>2.8 备注</h4>
<ul>
<li>姓别字典</li>
</ul>
<table>
<thead>
<tr>
<th>字典值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>男生</td>
</tr>
<tr>
<td>2</td>
<td>女生</td>
</tr>
</tbody>
</table>
<h3>3.删除用户</h3>
<h4>3.1 简要描述:</h4>
<ul>
<li>删除用户接口</li>
</ul>
<h4>3.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/user</code></li>
</ul>
<h4>3.3 请求方式</h4>
<ul>
<li>DELETE</li>
</ul>
<h4>3.4 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户 id</td>
</tr>
</tbody>
</table>
<h4>3.5 返回示例</h4>
<pre><code>{
"success": true,
"message": "删除成功!",
"code": 200,
"result": "33b89272a79e4fb68205eb49e5fc67f7",
"timestamp": 1634027967422
}</code></pre>
<h4>3.6 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">string</td>
<td>用户 id</td>
</tr>
</tbody>
</table>
<h4>3.7 备注</h4>
<ul>
<li>无</li>
</ul>
<h3>4.查询用户</h3>
<h4>4.1 简要描述</h4>
<ul>
<li>查询用户接口</li>
</ul>
<h4>4.2 请求 URL</h4>
<ul>
<li><code>http://www.lushan.com/api/system/user</code></li>
</ul>
<h4>4.3 请求方式</h4>
<ul>
<li>GET</li>
</ul>
<h4>4.4 请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户 id</td>
</tr>
</tbody>
</table>
<h4>4.5 返回示例</h4>
<pre><code>{
"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
}
</code></pre>
<h4>4.6 返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">birthday</td>
<td>string</td>
<td>生日</td>
</tr>
<tr>
<td style="text-align: left;">sex_dictText</td>
<td>string</td>
<td>性别字典值</td>
</tr>
<tr>
<td style="text-align: left;">delFlag</td>
<td>string</td>
<td>删除标记</td>
</tr>
<tr>
<td style="text-align: left;">workNo</td>
<td>string</td>
<td>工号</td>
</tr>
<tr>
<td style="text-align: left;">orgCode</td>
<td>string</td>
<td>所属机构</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td>string</td>
<td>用户 id</td>
</tr>
<tr>
<td style="text-align: left;">email</td>
<td>string</td>
<td>邮箱</td>
</tr>
<tr>
<td style="text-align: left;">sex</td>
<td>int</td>
<td>性别字典</td>
</tr>
<tr>
<td style="text-align: left;">updateTime</td>
<td>date</td>
<td>更新时间</td>
</tr>
<tr>
<td style="text-align: left;">departIds</td>
<td>string</td>
<td>所属部门</td>
</tr>
<tr>
<td style="text-align: left;">avatar</td>
<td>string</td>
<td>头像 url</td>
</tr>
<tr>
<td style="text-align: left;">realname</td>
<td>string</td>
<td>用户姓名</td>
</tr>
<tr>
<td style="text-align: left;">createBy</td>
<td>string</td>
<td>创建人</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td>string</td>
<td>手机电话</td>
</tr>
<tr>
<td style="text-align: left;">createTime</td>
<td>date</td>
<td>创建时间</td>
</tr>
<tr>
<td style="text-align: left;">username</td>
<td>string</td>
<td>用户账号</td>
</tr>
</tbody>
</table>
<h4>4.7 备注</h4>
<ul>
<li>无</li>
</ul>