获取某台设备下书本每次阅读的记录
<p><strong>服务:</strong>api-cloud
<strong>API:</strong><code>cloud-api1.51wanxue.com/api-cloud/record/userBookReadRecord.do</code>
<strong>请求方式:</strong>GET
<strong>api开发者:</strong> 林垚
<strong>是否授权登录:</strong> 否
<strong>简要描述:</strong>获取一个用户在给定时间段内的阅读记录列表。一条记录中含有用户<a href="https://www.showdoc.cc/visiontalk?page_id=2029155996355329">一次阅读</a>的下列信息:</p>
<ul>
<li>书本信息</li>
<li>发生时间</li>
<li>结束时间</li>
<li>持续时间</li>
</ul>
<p>列表按由近到远的时间顺序排列。</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>设备唯一ID</td>
</tr>
<tr>
<td style="text-align: left;">start</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Date(pattern = "yyyy-MM-dd HH:mm:ss")</td>
<td>开始时间(目前无限制,建议查询不超过当前时间一年)</td>
</tr>
<tr>
<td style="text-align: left;">end</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Date(pattern = "yyyy-MM-dd HH:mm:ss")</td>
<td>结束时间(目前无限制,建议查询不超过当前时间一年)</td>
</tr>
<tr>
<td style="text-align: left;">currentPage</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int 默认为1</td>
<td>目标页</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int 默认为3</td>
<td>一页的数据量</td>
</tr>
</tbody>
</table>
<p><strong>备注:</strong> 当不填写start或者不填写end 时,回去当天时间的00:00 和后一天的00:00</p>
<p><strong>返回示例</strong></p>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;ok&quot;,
&quot;data&quot;: {
&quot;records&quot;: [
{
&quot;userReadRecordTimeVO&quot;: {
&quot;bookId&quot;: 4134,
&quot;startTime&quot;: &quot;2019-03-29 10:14:52&quot;,
&quot;endTime&quot;: &quot;2019-03-29 10:21:12&quot;,
&quot;readFinish&quot;: false,
&quot;duration&quot;: 380
},
&quot;book&quot;: {
&quot;bookName&quot;: &quot;[精]我爱小黑猫&quot;,
&quot;isbn&quot;: {
&quot;mainISBN&quot;: &quot;&quot;,
&quot;affiliateISBNs&quot;: null
},
&quot;coverThumbnailUrl&quot;: &quot;http://files-dev.51wanxue.cn//brs/content/basebook/27/4134/08cabc8b-8da6-4378-a70b-1be24fbbf393.jpg&quot;,
&quot;author&quot;: &quot;[法]克里斯提昂.约里波瓦&quot;,
&quot;publisher&quot;: &quot;&quot;,
&quot;description&quot;: &quot;&quot;,
&quot;labels&quot;: []
}
}
],
&quot;pagination&quot;: {
&quot;pageSize&quot;: 3,
&quot;currentPage&quot;: 1,
&quot;totalRecord&quot;: 1,
&quot;limit&quot;: 3,
&quot;pages&quot;: 1,
&quot;recordStartIndex&quot;: 0,
&quot;recordEndIndex&quot;: 6
}
}
}</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>系统返回提示</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">Object</td>
<td>返回数据</td>
</tr>
</tbody>
</table>
<p><strong>data</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;">record</td>
<td style="text-align: left;">List</td>
<td>书本阅读记录的主体</td>
</tr>
<tr>
<td style="text-align: left;">pagination</td>
<td style="text-align: left;">Pagination</td>
<td>分页信息对象</td>
</tr>
</tbody>
</table>
<p><strong>userReadRecordTimeVO</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;">bookId</td>
<td style="text-align: left;">Long</td>
<td>书本资源库Id</td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;">Date</td>
<td>开始阅读时间</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">Date</td>
<td>阅读结束时间</td>
</tr>
<tr>
<td style="text-align: left;">readFinish</td>
<td style="text-align: left;">bool</td>
<td>是否阅读结束</td>
</tr>
<tr>
<td style="text-align: left;">duration</td>
<td style="text-align: left;">long</td>
<td>阅读总时长</td>
</tr>
</tbody>
</table>
<p><strong>book</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;">bookName</td>
<td style="text-align: left;">string</td>
<td>书本名</td>
</tr>
<tr>
<td style="text-align: left;">isbn</td>
<td style="text-align: left;">Object</td>
<td>isbn对象</td>
</tr>
<tr>
<td style="text-align: left;">coverThumbnailUrl</td>
<td style="text-align: left;">String</td>
<td>缩略图URL</td>
</tr>
<tr>
<td style="text-align: left;">author</td>
<td style="text-align: left;">String</td>
<td>作者</td>
</tr>
<tr>
<td style="text-align: left;">publisher</td>
<td style="text-align: left;">String</td>
<td>出版社</td>
</tr>
<tr>
<td style="text-align: left;">labels</td>
<td style="text-align: left;">List</td>
<td>标签</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">String</td>
<td>书本简介</td>
</tr>
</tbody>
</table>