获取“我的书架”中的书本清单
<p><strong>服务:</strong>api-cloud
<strong>API: </strong><code>cloud-api1.51wanxue.com/api-cloud/user/book/list</code>
<strong>请求方式:</strong>GET
<strong>api开发者:</strong> 宇佳
<strong>简要描述:</strong>
每一个openId下都关联了一个叫做“我的书架”的书本清单,这个清单中的书有两个来源:
1、所属该openId设备识别过的每一本不一样的书;
2、与上述设备绑定的家长端使用扫ISBN条码功能扫过的每一本玩瞳支持的书。
因此“我的书架”清单基本呈现了一个用户家中有的,且能被玩瞳支持的书本列表。调用该接口可以获取“我的书架”中的书本清单。</p>
<p>“我的书架”清单是按页返回的,<code>pageSize</code>用于设定返回的数据中每一页的书本数量,<code>page</code>用于指定返回的页码。</p>
<p><strong>参数:</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;">openId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>openId 用户登录后获得</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>页码</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>页面大小</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;ok&quot;,
&quot;data&quot;: {
&quot;bookVOList&quot;: [
{
&quot;id&quot;: 6656,
&quot;name&quot;: &quot;伟大的科学家&quot;,
&quot;author&quot;: &quot;[中]郑毅&quot;,
&quot;coverImage&quot;: &quot;975d7f0a-e019-46ff-bc32-5ba4cd82429e.jpg&quot;,
&quot;thumbnailUrl&quot;: &quot;http://files-dev.51wanxue.cn/brs/content/thumbnail/6656/975d7f0a-e019-46ff-bc32-5ba4cd82429e_300x300.jpg&quot;,
&quot;bookCategory&quot;: 0
}
],
&quot;produceCount&quot;: 0,
&quot;pagination&quot;: {
&quot;pageSize&quot;: 121,
&quot;currentPage&quot;: 1,
&quot;totalRecord&quot;: 7,
&quot;limit&quot;: 121,
&quot;recordStartIndex&quot;: 0,
&quot;recordEndIndex&quot;: 242,
&quot;pages&quot;: 1
}
}
}</code></pre>
<p><strong>返回数据参数说明 </strong></p>
<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>请求返回码 0(表示成功)</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">String</td>
<td>返回值为“ok”时代表请求成功,否则为请求失败的原因</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">Object</td>
<td>接口返回的数据主体</td>
</tr>
</tbody>
</table>
<p><strong>produceCount </strong></p>
<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;">produceCount</td>
<td style="text-align: left;">int</td>
<td>制作中书本数量 此字段暂不维护</td>
</tr>
</tbody>
</table>
<p><strong>bookVOList </strong></p>
<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;">Long</td>
<td>推送可识别的书库书本id</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;">coverImage</td>
<td style="text-align: left;">String</td>
<td>封面图</td>
</tr>
<tr>
<td style="text-align: left;">bookCategory</td>
<td style="text-align: left;">int</td>
<td>书本类别 0-brs书库 1-豆瓣书类型</td>
</tr>
<tr>
<td style="text-align: left;">thumbnailUrl</td>
<td style="text-align: left;">String</td>
<td>缩略图访问地址</td>
</tr>
<tr>
<td style="text-align: left;">author</td>
<td style="text-align: left;">String</td>
<td>作者</td>
</tr>
</tbody>
</table>
<p><strong>pagination</strong></p>
<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;">pageSize</td>
<td style="text-align: left;">Integer</td>
<td>当前页数量</td>
</tr>
<tr>
<td style="text-align: left;">currentPage</td>
<td style="text-align: left;">Integer</td>
<td>当前页码</td>
</tr>
<tr>
<td style="text-align: left;">totalRecord</td>
<td style="text-align: left;">Integer</td>
<td>书本总数</td>
</tr>
<tr>
<td style="text-align: left;">limit</td>
<td style="text-align: left;">Integer</td>
<td>页最大数量</td>
</tr>
<tr>
<td style="text-align: left;">pages</td>
<td style="text-align: left;">Integer</td>
<td>页数</td>
</tr>
<tr>
<td style="text-align: left;">recordStartIndex</td>
<td style="text-align: left;">Integer</td>
<td>起始索引</td>
</tr>
<tr>
<td style="text-align: left;">recordEndIndex</td>
<td style="text-align: left;">Integer</td>
<td>结尾索引</td>
</tr>
</tbody>
</table>