评价列表
<h5>接口描述</h5>
<ul>
<li>评价列表</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/admin/comments</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET</li>
</ul>
<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;">Authorization</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>JWT token</td>
</tr>
</tbody>
</table>
<h5>Query 请求参数</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;">current</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>分页-当前页</td>
</tr>
<tr>
<td style="text-align: left;">goods_title</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品名模糊搜索</td>
</tr>
<tr>
<td style="text-align: left;">rate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>评论等级 1好评 2中评 3差评</td>
</tr>
<tr>
<td style="text-align: left;">include</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>包含额外的数据: goods 商品,user 用户</td>
</tr>
</tbody>
</table>
<blockquote>
<p>inlude可以返回额外的数据, 多个使用 <code>,</code> 分隔, 比如: <code>include=goods,user</code></p>
</blockquote>
<h5>返回参数</h5>
<p><strong>data</strong></p>
<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;">id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>自增长主键ID</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>创建者</td>
</tr>
<tr>
<td style="text-align: left;">goods_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>分类</td>
</tr>
<tr>
<td style="text-align: left;">content</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>评价内容</td>
</tr>
<tr>
<td style="text-align: left;">rate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>评论的级别: 1好评 2中评 3差评</td>
</tr>
<tr>
<td style="text-align: left;">star</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>评论星级0-5</td>
</tr>
<tr>
<td style="text-align: left;">pics</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>小图集</td>
</tr>
<tr>
<td style="text-align: left;">pics_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>小图集url</td>
</tr>
<tr>
<td style="text-align: left;">reply</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>回复的内容</td>
</tr>
<tr>
<td style="text-align: left;">created_at</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">timestamp</td>
<td>添加时间</td>
</tr>
<tr>
<td style="text-align: left;">updated_at</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">timestamp</td>
<td>修改时间</td>
</tr>
</tbody>
</table>
<p><strong>meta.pagination</strong></p>
<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;">total</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>数据总数</td>
</tr>
<tr>
<td style="text-align: left;">count</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前页数据</td>
</tr>
<tr>
<td style="text-align: left;">per_page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>每页显示条数</td>
</tr>
<tr>
<td style="text-align: left;">current_page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前页页码</td>
</tr>
<tr>
<td style="text-align: left;">total_pages</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>总页数</td>
</tr>
<tr>
<td style="text-align: left;">links.previous</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>上一页链接</td>
</tr>
<tr>
<td style="text-align: left;">links.next</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>下一页链接</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<ul>
<li>状态码 200 请求成功</li>
</ul>
<pre><code>{
"data": [
{
"id": 1,
"user_id": 1,
"goods_id": 1,
"content": "不错",
"rate": 1,
"pics": null,
"pics_url": [],
"reply": null,
"created_at": null,
"updated_at": null
}
],
"meta": {
"pagination": {
"total": 1,
"count": 1,
"per_page": 2,
"current_page": 1,
"total_pages": 1,
"links": null
}
}
}</code></pre>