绿洲ERP电商系统


获取用户精简信息列表

<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>&quot;&quot;</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>&quot;绿洲电商&quot;</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>&quot;中山公司&quot;</td> <td>是</td> </tr> </tbody> </table> <hr /> <h4><strong>响应示例</strong></h4> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 0, &amp;quot;data&amp;quot;: [ { &amp;quot;id&amp;quot;: 1, &amp;quot;nickname&amp;quot;: &amp;quot;绿洲电商&amp;quot;, &amp;quot;deptId&amp;quot;: 101, &amp;quot;deptName&amp;quot;: &amp;quot;中山公司&amp;quot; }, { &amp;quot;id&amp;quot;: 103, &amp;quot;nickname&amp;quot;: &amp;quot;源码&amp;quot;, &amp;quot;deptId&amp;quot;: 106, &amp;quot;deptName&amp;quot;: null }, { &amp;quot;id&amp;quot;: 114, &amp;quot;nickname&amp;quot;: &amp;quot;hr 小姐姐&amp;quot;, &amp;quot;deptId&amp;quot;: null, &amp;quot;deptName&amp;quot;: null } ], &amp;quot;msg&amp;quot;: &amp;quot;&amp;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>

页面列表

ITEM_HTML