角色列表
<h5>简要描述</h5>
<ul>
<li>角色列表接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://xx.com/api/admin/role</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET</li>
</ul>
<h5>Authorization header</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">参数值</th>
<th style="text-align: left;">类型</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Authorization</td>
<td style="text-align: left;">Bearer access_token</td>
<td style="text-align: left;">string</td>
</tr>
</tbody>
</table>
<h5>参数</h5>
<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;">page</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>页码 默认第一页</td>
</tr>
<tr>
<td style="text-align: left;">cn_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>角色名称模糊搜索</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>权限字符模糊搜索</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>状态【0:正常 1:禁用】</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;code&quot;: 200,
&quot;message&quot;: &quot;成功&quot;,
&quot;data&quot;: {
&quot;current_page&quot;: 1,
&quot;data&quot;: [
{
&quot;id&quot;: 1,
&quot;name&quot;: &quot;admin&quot;,
&quot;cn_name&quot;: &quot;超级管理员&quot;,
&quot;status&quot;: 0,
&quot;guard_name&quot;: &quot;api&quot;,
&quot;created_at&quot;: &quot;2023-06-20T08:18:31.000000Z&quot;,
&quot;updated_at&quot;: &quot;2023-07-04T02:04:24.000000Z&quot;,
&quot;has_permissions&quot;: &quot;1,2,4&quot;
},
{
&quot;id&quot;: 5,
&quot;name&quot;: &quot;admin2&quot;,
&quot;cn_name&quot;: &quot;ceshi2&quot;,
&quot;status&quot;: 0,
&quot;guard_name&quot;: &quot;api&quot;,
&quot;created_at&quot;: &quot;2023-07-04T03:39:46.000000Z&quot;,
&quot;updated_at&quot;: &quot;2023-07-04T03:39:49.000000Z&quot;,
&quot;has_permissions&quot;: &quot;&quot;
}
],
&quot;first_page_url&quot;: &quot;http://api.localhost/api/admin/role?page=1&quot;,
&quot;from&quot;: 1,
&quot;last_page&quot;: 1,
&quot;last_page_url&quot;: &quot;http://api.localhost/api/admin/role?page=1&quot;,
&quot;links&quot;: [
{
&quot;url&quot;: null,
&quot;label&quot;: &quot;&amp;laquo; 上一页&quot;,
&quot;active&quot;: false
},
{
&quot;url&quot;: &quot;http://api.localhost/api/admin/role?page=1&quot;,
&quot;label&quot;: &quot;1&quot;,
&quot;active&quot;: true
},
{
&quot;url&quot;: null,
&quot;label&quot;: &quot;下一页 &amp;raquo;&quot;,
&quot;active&quot;: false
}
],
&quot;next_page_url&quot;: null,
&quot;path&quot;: &quot;http://api.localhost/api/admin/role&quot;,
&quot;per_page&quot;: 15,
&quot;prev_page_url&quot;: null,
&quot;to&quot;: 2,
&quot;total&quot;: 2
}
}</code></pre>
<h5>返回参数说明</h5>
<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;">code</td>
<td style="text-align: left;">int</td>
<td>状态码</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>消息提示</td>
</tr>
<tr>
<td style="text-align: left;">current_page</td>
<td style="text-align: left;">number</td>
<td>当前页码</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">array</td>
<td>展示数据</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">number</td>
<td>角色ID</td>
</tr>
<tr>
<td style="text-align: left;">cn_name</td>
<td style="text-align: left;">string</td>
<td>角色名称</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td>权限字符</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">number</td>
<td>状态【0:正常 1:禁用】</td>
</tr>
<tr>
<td style="text-align: left;">has_permissions</td>
<td style="text-align: left;">string</td>
<td>角色拥有的权限ID【多个逗号分隔】</td>
</tr>
<tr>
<td style="text-align: left;">created_at</td>
<td style="text-align: left;">string</td>
<td>创建时间</td>
</tr>
<tr>
<td style="text-align: left;">updated_at</td>
<td style="text-align: left;">string</td>
<td>修改时间</td>
</tr>
<tr>
<td style="text-align: left;">first_page_url</td>
<td style="text-align: left;">string</td>
<td>首页数据链接</td>
</tr>
<tr>
<td style="text-align: left;">last_page_url</td>
<td style="text-align: left;">string</td>
<td>最后数据链接</td>
</tr>
<tr>
<td style="text-align: left;">next_page_url</td>
<td style="text-align: left;">string</td>
<td>下一页数据链接</td>
</tr>
<tr>
<td style="text-align: left;">links</td>
<td style="text-align: left;">array</td>
<td>分页数据链接</td>
</tr>
<tr>
<td style="text-align: left;">per_page</td>
<td style="text-align: left;">number</td>
<td>每页数据条数</td>
</tr>
<tr>
<td style="text-align: left;">total</td>
<td style="text-align: left;">number</td>
<td>数据总数</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>