书目列表API
<h1>开发者</h1>
<ul>
<li>罗恒山</li>
</ul>
<h1>说明</h1>
<ul>
<li>书目列表</li>
</ul>
<h1>请求</h1>
<ul>
<li>Endpoint: <code>/api/goods</code></li>
<li>Method:GET</li>
</ul>
<h1>查询条件(filter)</h1>
<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;">content_range</td>
<td style="text-align: left;">string</td>
<td>查询范围(0全部1过滤已购)默认0</td>
</tr>
<tr>
<td style="text-align: left;">filter[book_notice]</td>
<td style="text-align: left;">int</td>
<td>新书速递的ID,精确查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[erp_id]</td>
<td style="text-align: left;">string</td>
<td>ERP的ID,模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[isbn]</td>
<td style="text-align: left;">string</td>
<td>书籍ISBN码,模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[isbn_or]</td>
<td style="text-align: left;">string</td>
<td>书籍ISBN码,模糊查询(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[isbn_not]</td>
<td style="text-align: left;">string</td>
<td>书籍ISBN码,模糊查询(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[name]</td>
<td style="text-align: left;">string</td>
<td>商品名称,模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[name_or]</td>
<td style="text-align: left;">string</td>
<td>商品名称,模糊查询(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[name_not]</td>
<td style="text-align: left;">string</td>
<td>商品名称,模糊查询(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_name]</td>
<td style="text-align: left;">string</td>
<td>出版社名称,模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_name_or]</td>
<td style="text-align: left;">string</td>
<td>出版社名称,模糊查询(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_name_not]</td>
<td style="text-align: left;">string</td>
<td>出版社名称,模糊查询(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[author_name]</td>
<td style="text-align: left;">string</td>
<td>作者名称,模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[author_name_or]</td>
<td style="text-align: left;">string</td>
<td>作者名称,模糊查询(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[author_name_not]</td>
<td style="text-align: left;">string</td>
<td>作者名称,模糊查询(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_category_id]</td>
<td style="text-align: left;">string</td>
<td>出版社分类ID,可多个</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_category_id_or]</td>
<td style="text-align: left;">string</td>
<td>出版社分类ID,可多个(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_category_id_not]</td>
<td style="text-align: left;">string</td>
<td>出版社分类ID,可多个(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[clc_id]</td>
<td style="text-align: left;">int</td>
<td>中图法分类ID,可多个</td>
</tr>
<tr>
<td style="text-align: left;">filter[clc_id_or]</td>
<td style="text-align: left;">int</td>
<td>中图法分类ID,可多个(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[clc_id_not]</td>
<td style="text-align: left;">int</td>
<td>中图法分类ID,可多个(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[dc_id]</td>
<td style="text-align: left;">int</td>
<td>学科分类ID,可多个</td>
</tr>
<tr>
<td style="text-align: left;">filter[dc_id_or]</td>
<td style="text-align: left;">int</td>
<td>学科分类ID,可多个(或)</td>
</tr>
<tr>
<td style="text-align: left;">filter[dc_id_not]</td>
<td style="text-align: left;">int</td>
<td>学科分类ID,可多个(非)</td>
</tr>
<tr>
<td style="text-align: left;">filter[name_fuzzy]</td>
<td style="text-align: left;">string</td>
<td>商品名称 OR 作者名 OR 出版社名称 OR ISBN 的模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_id]</td>
<td style="text-align: left;">int</td>
<td>出版社ID,可多个</td>
</tr>
<tr>
<td style="text-align: left;">filter[author_id]</td>
<td style="text-align: left;">int</td>
<td>作者ID,全等</td>
</tr>
<tr>
<td style="text-align: left;">filter[type]</td>
<td style="text-align: left;">int</td>
<td>类型:0预售 1正常,全等</td>
</tr>
<tr>
<td style="text-align: left;">filter[publish_date_between]</td>
<td style="text-align: left;">string</td>
<td>发布时间区间,例如:2022-01-05,2022-01-20</td>
</tr>
<tr>
<td style="text-align: left;">filter[price_between]</td>
<td style="text-align: left;">string</td>
<td>价格区间,例如:5.50,15.80</td>
</tr>
<tr>
<td style="text-align: left;">filter[created_between]</td>
<td style="text-align: left;">string</td>
<td>创建时间区间,例如:2022-01-05,2022-01-20</td>
</tr>
<tr>
<td style="text-align: left;">filter[updated_between]</td>
<td style="text-align: left;">string</td>
<td>更新时间区间,例如:2022-01-05,2022-01-20</td>
</tr>
<tr>
<td style="text-align: left;">filter[dc_id_multi]</td>
<td style="text-align: left;">string</td>
<td>多个学科分类ID,例如:10,13,18</td>
</tr>
<tr>
<td style="text-align: left;">filter[clc_id_multi]</td>
<td style="text-align: left;">string</td>
<td>多个中图法分类ID,例如:10,13,18</td>
</tr>
<tr>
<td style="text-align: left;">filter[author_id_multi]</td>
<td style="text-align: left;">string</td>
<td>多个作者ID,例如:10,13,18</td>
</tr>
<tr>
<td style="text-align: left;">filter[press_id_multi]</td>
<td style="text-align: left;">string</td>
<td>多个出版社ID,例如:10,13,18</td>
</tr>
</tbody>
</table>
<p>|filter[recommend] |int |推荐位商品查询:0 馆藏推荐,2 新书推荐, 4 新书预览 |
|filter[only_sales] |string |仅含有销量的商品:yes 是 |</p>
<p>示例 <code>/api/goods?filter[erp_id]=aaa&filter[isbn]=bbb&filter[name]=ccc&filter[type]=1&filter[clc_id]=1&filter[price_between]=5.50,15.80&filter[created_between]=2022-01-05,2022-01-20</code></p>
<h1>关联对象(include)</h1>
<ul>
<li>dc:学科分类</li>
<li>clc:中图法分类</li>
<li>press:出版社</li>
<li>authors:作者(多个)</li>
<li>authorsCount:作者个数</li>
</ul>
<p>示例 <code>/api/goods?include=dc,clc,press,authors,authorsCount</code></p>
<h1>返回示例</h1>
<p>分页的相关参数,请查看"接口说明文档-常例:分页返回结果"</p>
<pre><code>{
"status_code": 200,
"message": "",
"data": {
"current_page": 1,
"data": [
{
"id": 1,
"erp_id": "e001",
"isbn": "9787541160738",
"clc_id": 14,
"clc_no": "shx",
"dc_id": 38,
"dc_name": "历史唯物主义",
"type": 1,
"name": "改变人生的说话术",
"price": "42.00000",
"publish_date": "2020-05-18",
"pic": "http://yuedaguancang.my/images/book.jpg",
"images": [
"http://yuedaguancang.my/images/book.jpg"
],
"press_id": 1,
"press_name": "四川文艺出版社",
"author_name": "岸正龙",
"marc": "",
"is_sale": 1,
"summary": "操控偏见,塑造形象...",
"detail": "操控偏见,塑造形象,让对方敞开心扉;印象深入,引起兴趣,促使对方做出行动;假装技巧,赢得信赖,掌控沟通主导权!3大沟通利器,让你获得改变人生的契机!",
"created_at": "2021-12-24 16:20:42",
"updated_at": "2021-12-27 16:20:42",
"deleted_at": "",
"marc_type": "plf",
"marc_decode": {
{
"name": "210",
"indicator": " ",
"value": "▼a南京▼c江苏人民出版社▼d2018"
},
{
"name": "215",
"indicator": " ",
"value": "▼a268页▼d24cm"
},
{
"name": "225",
"indicator": "2 ",
"value": "▼a统编语文教材必读名著▼Atong bian yu wen jiao cai bi du ming zhu▼e名师导读全解版"
}
},
"authors_count": 1,
"rel_library": {
"id": 1,
"library_id": 1,
"goods_id": 1,
"quantity": 88,
"created_at": "",
"updated_at": "",
"deleted_at": ""
},
"dc": {
"id": 38,
"type": 1,
"pid": 26,
"name": "宗教哲学",
"level": 0,
"is_display": 1,
"sort": 0,
"created_at": "",
"updated_at": "",
"deleted_at": ""
},
"clc": {
"id": 14,
"type": 0,
"pid": 2,
"name": "社会学",
"level": 0,
"is_display": 1,
"sort": 0,
"created_at": "",
"updated_at": "",
"deleted_at": ""
},
"press": {
"id": 1,
"no": "cb001",
"name": "四川文艺出版社",
"abbreviation": "四川文艺",
"detail": "四川文艺出版社是一个有着二十多年历史的专业文学艺术出版社,主要从事当代文学、现代文学和艺术作品图书出版,文艺理论和文学批评专著图书出版,古代优秀文艺作品读物出版,以及影视艺术图书和音乐歌曲图书出版。在长篇小说、纪实文学、当代作家文集、人物传记、小说、散文、影视艺术图书等诸多门类,整合和优化国内外出版资源,扩大合作伙伴,开拓销售市场,形成自己独有的出版特色。",
"created_at": "2021-12-23 18:10:28",
"updated_at": "2021-12-23 18:10:49",
"deleted_at": ""
},
"authors": [
{
"id": 5,
"no": "Z005",
"name": "岸正龙",
"summary": "岸正龙:浅野屋株式会社董事长。",
"avatar": "",
"detail": "岸正龙:浅野屋株式会社董事长、日本思想解读协会理事、日本商业心理学会高管。",
"created_at": "2021-12-23 17:46:19",
"updated_at": "2021-12-23 17:49:36",
"deleted_at": "",
"pivot": {
"goods_id": 1,
"author_id": 5
}
}
]
}
],
"first_page_url": "http://yuedaguancang.my/api/goods?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://yuedaguancang.my/api/goods?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://yuedaguancang.my/api/goods?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://yuedaguancang.my/api/goods",
"per_page": 15,
"prev_page_url": null,
"to": 1,
"total": 1
}
}</code></pre>
<h2>数据列表 data 中参数说明</h2>
<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;">id</td>
<td style="text-align: left;">int</td>
<td>ID</td>
</tr>
<tr>
<td style="text-align: left;">erp_id</td>
<td style="text-align: left;">string</td>
<td>ERP ID</td>
</tr>
<tr>
<td style="text-align: left;">isbn</td>
<td style="text-align: left;">string</td>
<td>ISBN(需要生成条形码)</td>
</tr>
<tr>
<td style="text-align: left;">clc_id</td>
<td style="text-align: left;">int</td>
<td>中图法分类ID</td>
</tr>
<tr>
<td style="text-align: left;">clc_no</td>
<td style="text-align: left;">int</td>
<td>中图法分类编号</td>
</tr>
<tr>
<td style="text-align: left;">dc_id</td>
<td style="text-align: left;">int</td>
<td>学科分类ID</td>
</tr>
<tr>
<td style="text-align: left;">dc_name</td>
<td style="text-align: left;">string</td>
<td>学科分类名称</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">int</td>
<td>类型:0预售 1正常</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;">price</td>
<td style="text-align: left;">float</td>
<td>售价</td>
</tr>
<tr>
<td style="text-align: left;">publish_date</td>
<td style="text-align: left;">datetime</td>
<td>出版日期</td>
</tr>
<tr>
<td style="text-align: left;">pic</td>
<td style="text-align: left;">string</td>
<td>封面图</td>
</tr>
<tr>
<td style="text-align: left;">images</td>
<td style="text-align: left;">array</td>
<td>图片</td>
</tr>
<tr>
<td style="text-align: left;">press_id</td>
<td style="text-align: left;">int</td>
<td>出版社ID</td>
</tr>
<tr>
<td style="text-align: left;">press_name</td>
<td style="text-align: left;">string</td>
<td>出版社名称</td>
</tr>
<tr>
<td style="text-align: left;">author_name</td>
<td style="text-align: left;">int</td>
<td>作者名称</td>
</tr>
<tr>
<td style="text-align: left;">marc</td>
<td style="text-align: left;">string</td>
<td>平台marc</td>
</tr>
<tr>
<td style="text-align: left;">is_sale</td>
<td style="text-align: left;">int</td>
<td>是否上架:0 未上架,1 已上架</td>
</tr>
<tr>
<td style="text-align: left;">summary</td>
<td style="text-align: left;">string</td>
<td>简介</td>
</tr>
<tr>
<td style="text-align: left;">detail</td>
<td style="text-align: left;">string</td>
<td>详细介绍</td>
</tr>
<tr>
<td style="text-align: left;">marc_type</td>
<td style="text-align: left;">string</td>
<td>marc类型:null 暂无MARC,plf 平台MARC,lib 图书馆MARC</td>
</tr>
<tr>
<td style="text-align: left;">marc_decode</td>
<td style="text-align: left;">array</td>
<td>marc解码:null 暂无MARC,正常解码则为一个数组</td>
</tr>
<tr>
<td style="text-align: left;">dc</td>
<td style="text-align: left;">object</td>
<td>关联的学科分类对象</td>
</tr>
<tr>
<td style="text-align: left;">clc</td>
<td style="text-align: left;">object</td>
<td>关联的中图法分类对象</td>
</tr>
<tr>
<td style="text-align: left;">press</td>
<td style="text-align: left;">object</td>
<td>关联的出版社对象</td>
</tr>
<tr>
<td style="text-align: left;">authors</td>
<td style="text-align: left;">object[]</td>
<td>关联的作者对象(多个)</td>
</tr>
<tr>
<td style="text-align: left;">authors_count</td>
<td style="text-align: left;">int</td>
<td>关联的作者个数</td>
</tr>
<tr>
<td style="text-align: left;">rel_library</td>
<td style="text-align: left;">object</td>
<td>图书馆馆藏,用户未登录或未绑定图书馆时无此属性</td>
</tr>
<tr>
<td style="text-align: left;">rel_library.library_id</td>
<td style="text-align: left;">int</td>
<td>图书馆ID</td>
</tr>
<tr>
<td style="text-align: left;">rel_library.quantity</td>
<td style="text-align: left;">int</td>
<td>馆藏数量</td>
</tr>
</tbody>
</table>
<h1>备注</h1>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>