阅达馆藏API

阅达馆藏API


作者书目列表API

<h1>开发者</h1> <ul> <li>罗恒山</li> </ul> <h1>说明</h1> <ul> <li>书目列表</li> </ul> <h1>请求</h1> <ul> <li>Endpoint: <code>/api/author/{authorId}/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;">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[name]</td> <td style="text-align: left;">string</td> <td>商品名称,模糊查询</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[type]</td> <td style="text-align: left;">int</td> <td>类型:0预售 1正常,全等</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[dc_id]</td> <td style="text-align: left;">int</td> <td>学科分类ID,全等</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> </tbody> </table> <p>示例 <code>/api/author/6/goods?filter[erp_id]=aaa&amp;amp;filter[isbn]=bbb&amp;amp;filter[name]=ccc&amp;amp;filter[type]=1&amp;amp;filter[clc_id]=1&amp;amp;filter[price_between]=5.50,15.80&amp;amp;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/author/6/goods?include=dc,clc,press,authors,authorsCount</code></p> <h1>返回示例</h1> <p>分页的相关参数,请查看&quot;接口说明文档-常例:分页返回结果&quot;</p> <pre><code>{ &amp;quot;code&amp;quot;: 200, &amp;quot;message&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;current_page&amp;quot;: 1, &amp;quot;data&amp;quot;: [ { &amp;quot;id&amp;quot;: 2, &amp;quot;erp_id&amp;quot;: &amp;quot;e002&amp;quot;, &amp;quot;isbn&amp;quot;: &amp;quot;9787802115743&amp;quot;, &amp;quot;clc_id&amp;quot;: 16, &amp;quot;clc_no&amp;quot;: &amp;quot;shkxllyffl&amp;quot;, &amp;quot;dc_id&amp;quot;: 42, &amp;quot;dc_name&amp;quot;: &amp;quot;辩证唯物主义&amp;quot;, &amp;quot;type&amp;quot;: 1, &amp;quot;name&amp;quot;: &amp;quot;沉思录&amp;quot;, &amp;quot;price&amp;quot;: &amp;quot;9.10000&amp;quot;, &amp;quot;publish_date&amp;quot;: &amp;quot;2015-08-21&amp;quot;, &amp;quot;pic&amp;quot;: &amp;quot;http://yuedaguancang.my/images/book.jpg&amp;quot;, &amp;quot;images&amp;quot;: [ &amp;quot;http://yuedaguancang.my/images/book.jpg&amp;quot; ], &amp;quot;press_id&amp;quot;: 2, &amp;quot;press_name&amp;quot;: &amp;quot;中央编译出版社&amp;quot;, &amp;quot;author_name&amp;quot;: &amp;quot;何怀宏&amp;quot;, &amp;quot;marc&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;is_sale&amp;quot;: 1, &amp;quot;detail&amp;quot;: &amp;quot;这本书天天放在我的床头,我可能读了有100遍,天天都在读。 —— *《沉思录》有一种不可思议的魅力,它甜美、忧郁和高贵。这部黄金之书以庄严不屈的精神负起做人的重荷,直接帮助人们去过更加美好的生活。\r\n\r\n&amp;quot;, &amp;quot;created_at&amp;quot;: &amp;quot;2021-12-24 16:20:42&amp;quot;, &amp;quot;updated_at&amp;quot;: &amp;quot;2021-12-26 16:20:42&amp;quot;, &amp;quot;deleted_at&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;authors_count&amp;quot;: 1, &amp;quot;rel_library&amp;quot;: null, &amp;quot;dc&amp;quot;: { &amp;quot;id&amp;quot;: 42, &amp;quot;type&amp;quot;: 1, &amp;quot;pid&amp;quot;: 30, &amp;quot;name&amp;quot;: &amp;quot;地理总论&amp;quot;, &amp;quot;level&amp;quot;: 0, &amp;quot;is_display&amp;quot;: 1, &amp;quot;sort&amp;quot;: 0, &amp;quot;created_at&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;updated_at&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;deleted_at&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;clc&amp;quot;: { &amp;quot;id&amp;quot;: 16, &amp;quot;type&amp;quot;: 0, &amp;quot;pid&amp;quot;: 2, &amp;quot;name&amp;quot;: &amp;quot;社会科学理论与方法论&amp;quot;, &amp;quot;level&amp;quot;: 0, &amp;quot;is_display&amp;quot;: 1, &amp;quot;sort&amp;quot;: 0, &amp;quot;created_at&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;updated_at&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;deleted_at&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;press&amp;quot;: { &amp;quot;id&amp;quot;: 2, &amp;quot;no&amp;quot;: &amp;quot;cb002&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;中央编译出版社&amp;quot;, &amp;quot;abbreviation&amp;quot;: &amp;quot;中央编译&amp;quot;, &amp;quot;detail&amp;quot;: &amp;quot;中央编译出版社&amp;quot;, &amp;quot;created_at&amp;quot;: &amp;quot;2021-12-23 18:10:28&amp;quot;, &amp;quot;updated_at&amp;quot;: &amp;quot;2021-12-23 18:10:49&amp;quot;, &amp;quot;deleted_at&amp;quot;: &amp;quot;&amp;quot; }, &amp;quot;authors&amp;quot;: [ { &amp;quot;id&amp;quot;: 6, &amp;quot;no&amp;quot;: &amp;quot;Z006&amp;quot;, &amp;quot;name&amp;quot;: &amp;quot;何怀宏&amp;quot;, &amp;quot;summary&amp;quot;: &amp;quot;哲学博士,1954年12月生于江西樟树市,曾任中国青年政治学院副教授,中国文化研究所研究员,现为北京大学哲学系教授,伦理学教研室主任,博士生导师。&amp;quot;, &amp;quot;avatar&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;detail&amp;quot;: &amp;quot;哲学博士,1954年12月生于江西樟树市,曾任中国青年政治学院副教授,中国文化研究所研究员,现为北京大学哲学系教授,伦理学教研室主任,博士生导师,主要从事伦理学、人生哲学、社会史等领域的研究。&amp;quot;, &amp;quot;created_at&amp;quot;: &amp;quot;2021-12-23 19:17:56&amp;quot;, &amp;quot;updated_at&amp;quot;: &amp;quot;2021-12-23 19:18:05&amp;quot;, &amp;quot;deleted_at&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;pivot&amp;quot;: { &amp;quot;goods_id&amp;quot;: 2, &amp;quot;author_id&amp;quot;: 6 } } ] } ], &amp;quot;first_page_url&amp;quot;: &amp;quot;http://yuedaguancang.my/api/author/6/goods?page=1&amp;quot;, &amp;quot;from&amp;quot;: 1, &amp;quot;last_page&amp;quot;: 1, &amp;quot;last_page_url&amp;quot;: &amp;quot;http://yuedaguancang.my/api/author/6/goods?page=1&amp;quot;, &amp;quot;links&amp;quot;: [ { &amp;quot;url&amp;quot;: null, &amp;quot;label&amp;quot;: &amp;quot;&amp;amp;laquo; Previous&amp;quot;, &amp;quot;active&amp;quot;: false }, { &amp;quot;url&amp;quot;: &amp;quot;http://yuedaguancang.my/api/author/6/goods?page=1&amp;quot;, &amp;quot;label&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;active&amp;quot;: true }, { &amp;quot;url&amp;quot;: null, &amp;quot;label&amp;quot;: &amp;quot;Next &amp;amp;raquo;&amp;quot;, &amp;quot;active&amp;quot;: false } ], &amp;quot;next_page_url&amp;quot;: null, &amp;quot;path&amp;quot;: &amp;quot;http://yuedaguancang.my/api/author/6/goods&amp;quot;, &amp;quot;per_page&amp;quot;: 15, &amp;quot;prev_page_url&amp;quot;: null, &amp;quot;to&amp;quot;: 1, &amp;quot;total&amp;quot;: 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;">detail</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;">datetime</td> <td>创建时间</td> </tr> <tr> <td style="text-align: left;">updated_at</td> <td style="text-align: left;">datetime</td> <td>修改时间</td> </tr> <tr> <td style="text-align: left;">deleted_at</td> <td style="text-align: left;">datetime</td> <td>删除时间</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>

页面列表

ITEM_HTML