获取用户精简信息列表
<h3>接口说明文档:获取用户精简信息列表</h3>
<hr />
<h4><strong>接口名称</strong></h4>
<p>获取用户精简用户信息列表</p>
<hr />
<h4><strong>接口地址</strong></h4>
<p><code>GET http://localhost:48082/admin-api/system/user/list-all-simple</code></p>
<hr />
<h4><strong>接口功能</strong></h4>
<p>获取系统中用户的精简信息列表,包含用户基础信息及所属部门信息(部分字段可能为空)。</p>
<hr />
<h4><strong>请求参数</strong></h4>
<p>无(接口为 <code>GET</code> 请求,无需额外参数)。</p>
<hr />
<h4><strong>响应格式</strong></h4>
<p>JSON</p>
<hr />
<h4><strong>响应字段说明</strong></h4>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>说明</th>
<th>示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>int</td>
<td>响应状态码(0 表示成功)</td>
<td>0</td>
</tr>
<tr>
<td>msg</td>
<td>string</td>
<td>提示信息</td>
<td>""</td>
</tr>
<tr>
<td>data</td>
<td>array</td>
<td>用户数据列表</td>
<td>见下方数据结构</td>
</tr>
</tbody>
</table>
<p><strong>data 数据结构</strong><br />
每个用户对象的字段说明:</p>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>说明</th>
<th>示例值</th>
<th>允许为空</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>int</td>
<td>用户唯一标识</td>
<td>1</td>
<td>否</td>
</tr>
<tr>
<td>nickname</td>
<td>string</td>
<td>用户昵称</td>
<td>"绿洲电商"</td>
<td>否</td>
</tr>
<tr>
<td>deptId</td>
<td>int</td>
<td>用户所属部门 ID</td>
<td>101</td>
<td>是</td>
</tr>
<tr>
<td>deptName</td>
<td>string</td>
<td>用户所属部门名称(可能未分配)</td>
<td>"中山公司"</td>
<td>是</td>
</tr>
</tbody>
</table>
<hr />
<h4><strong>响应示例</strong></h4>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;data&quot;: [
{
&quot;id&quot;: 1,
&quot;nickname&quot;: &quot;绿洲电商&quot;,
&quot;deptId&quot;: 101,
&quot;deptName&quot;: &quot;中山公司&quot;
},
{
&quot;id&quot;: 103,
&quot;nickname&quot;: &quot;源码&quot;,
&quot;deptId&quot;: 106,
&quot;deptName&quot;: null
},
{
&quot;id&quot;: 114,
&quot;nickname&quot;: &quot;hr 小姐姐&quot;,
&quot;deptId&quot;: null,
&quot;deptName&quot;: null
}
],
&quot;msg&quot;: &quot;&quot;
}</code></pre>
<hr />
<h4><strong>注意事项</strong></h4>
<ol>
<li><strong>权限要求</strong>:需管理员权限(根据路径 <code>/admin-api/</code> 推断)。</li>
<li><strong>字段空值处理</strong>:
<ul>
<li><code>deptId</code> 和 <code>deptName</code> 可能为 <code>null</code>,表示用户未分配部门或部门信息未维护。</li>
</ul></li>
<li><strong>无分页设计</strong>:接口直接返回全量数据,适用于数据量较小的场景。</li>
<li><strong>状态码约定</strong>:
<ul>
<li><code>code=0</code>:请求成功。 </li>
<li>其他状态码需结合 <code>msg</code> 处理异常(示例未提供具体错误码)。</li>
</ul></li>
</ol>
<hr />
<h4><strong>使用场景建议</strong></h4>
<p>适用于需要快速获取用户基础信息的场景(如用户选择器、部门人员统计等)。</p>