商品详情
<h5>接口描述</h5>
<ul>
<li>商品详情</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/goods/{good}</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>REST 参数</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;">good</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商品id</td>
</tr>
</tbody>
</table>
<h5>返回参数</h5>
<p><strong>goods 商品详情</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;">string</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;">string</td>
<td>创建者</td>
</tr>
<tr>
<td style="text-align: left;">category_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>分类</td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>标题</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>描述</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>价格</td>
</tr>
<tr>
<td style="text-align: left;">stock</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>库存</td>
</tr>
<tr>
<td style="text-align: left;">sales</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>销量</td>
</tr>
<tr>
<td style="text-align: left;">cover</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>封面图</td>
</tr>
<tr>
<td style="text-align: left;">cover_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>封面图url</td>
</tr>
<tr>
<td style="text-align: left;">pics</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>小图集</td>
</tr>
<tr>
<td style="text-align: left;">pics_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>小图集url</td>
</tr>
<tr>
<td style="text-align: left;">is_on</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>是否上架 0不上架 1上架</td>
</tr>
<tr>
<td style="text-align: left;">is_recommend</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>是否推荐 0不推荐 1推荐</td>
</tr>
<tr>
<td style="text-align: left;">details</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>
<tr>
<td style="text-align: left;">comments</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>关联的评论数据, 参考下表</td>
</tr>
</tbody>
</table>
<p><strong>goods.comments 商品评论</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>商品ID</td>
</tr>
<tr>
<td style="text-align: left;">order_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;">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>价格</td>
</tr>
<tr>
<td style="text-align: left;">star</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>库存</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>
<tr>
<td style="text-align: left;">user</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>关联的用户数据, 参考下表</td>
</tr>
</tbody>
</table>
<p><strong>goods.comments.user 评论所关联的用户</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;">name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</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>头像</td>
</tr>
<tr>
<td style="text-align: left;">avatar_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>头像地址</td>
</tr>
</tbody>
</table>
<p><strong>like_goods 相似商品</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;">title</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>标题</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>价格</td>
</tr>
<tr>
<td style="text-align: left;">sales</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>销量</td>
</tr>
<tr>
<td style="text-align: left;">cover</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>封面图</td>
</tr>
<tr>
<td style="text-align: left;">cover_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>封面图url</td>
</tr>
<tr>
<td style="text-align: left;">collects_count</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收藏人数</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<ul>
<li>状态码 200 请求成功</li>
</ul>
<pre><code> {
"goods": {
"id": 1,
"user_id": 1,
"title": "Consectetur.",
"category_id": 64,
"description": "Aliquid quis cupiditate maxime qui.",
"price": 852,
"stock": 7025,
"sales": 0,
"cover": "http://placeimg.com/640/480/any",
"pics": [
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any"
],
"is_on": 0,
"is_recommend": 0,
"details": "Explicabo dolores quo corporis alias et rerum placeat. Ut sequi mollitia deserunt quae est aperiam consectetur. Sint ipsum minus et. Magni repudiandae suscipit libero nisi consectetur architecto.\n\nVoluptas tempore quod laborum commodi. Reiciendis debitis delectus est aut.\n\nRerum eos eos reprehenderit est perspiciatis. Aut assumenda nobis dicta sit. Dolorum explicabo recusandae et beatae.\n\nAut culpa vel dolores minima laudantium. Rerum dignissimos et vero molestiae harum. In qui molestiae consequatur consequatur et. Doloremque rerum neque veniam commodi et ea.",
"created_at": "2021-09-17T01:49:16.000000Z",
"updated_at": "2021-09-17T01:49:16.000000Z",
"cover_url": "http://placeimg.com/640/480/any",
"pics_url": [
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any"
],
"comments": [
{
"id": 1,
"user_id": 1,
"goods_id": 1,
"rate": 1,
"star": 5,
"content": "我评论了你",
"reply": null,
"pics": null,
"created_at": "2021-09-18T04:19:24.000000Z",
"updated_at": "2021-09-18T04:19:26.000000Z",
"user": {
"id": 1,
"name": "admin",
"avatar": "http://placeimg.com/200/200/any",
"avatar_url": "http://placeimg.com/200/200/any"
}
}
]
},
"like_good": [
{
"id": 35,
"title": "Non eos debitis.",
"price": 348,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 198,
"title": "Nostrum totam sed.",
"price": 15,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 237,
"title": "Placeat perferendis.",
"price": 170,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 300,
"title": "Magnam repellat.",
"price": 992,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 119,
"title": "In velit voluptatem.",
"price": 152,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 186,
"title": "Tempora architecto.",
"price": 550,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 174,
"title": "Consequatur.",
"price": 932,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 83,
"title": "Nam eaque corporis.",
"price": 281,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 53,
"title": "Qui enim excepturi.",
"price": 784,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
},
{
"id": 240,
"title": "Possimus et nihil.",
"price": 259,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any"
}
]
}</code></pre>