71 lines
2.5 KiB
Markdown
71 lines
2.5 KiB
Markdown
# discover — 发现推荐好书
|
||
|
||
## 接口
|
||
|
||
### `/book/recommend` — 个性化推荐（为你推荐）
|
||
|
||
基于用户阅读记录的个性化推荐，与 App 首页「为你推荐」一致。
|
||
|
||
**请求参数：**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| `count` | int | 否 | 每页数量，默认 12 |
|
||
| `maxIdx` | int | 否 | 翻页偏移，默认 0 |
|
||
|
||
**回包：**
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `books` | 推荐书籍数组 |
|
||
| `books[].bookId` | 书籍 ID |
|
||
| `books[].title` | 书名 |
|
||
| `books[].author` | 作者 |
|
||
| `books[].cover` | 封面图 URL |
|
||
| `books[].intro` | 简介 |
|
||
| `books[].category` | 分类 |
|
||
| `books[].reason` | 推荐理由 |
|
||
| `books[].readingCount` | 在读人数 |
|
||
| `books[].searchIdx` | 结果序号（用于翻页） |
|
||
| `books[].newRating` | 评分（0-100） |
|
||
| `books[].newRatingCount` | 评分人数 |
|
||
| `books[].newRatingDetail.title` | 评分标签（如"神作""力荐"） |
|
||
| `books[].price` | 价格（分） |
|
||
| `books[].payType` | 付费类型 |
|
||
| `books[].type` | 书籍类型（0=电子书） |
|
||
|
||
### `/book/similar` — 相似书推荐
|
||
|
||
基于某本书推荐相似书籍，与 App 书籍详情页「相似推荐」一致。
|
||
|
||
**请求参数：**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| `bookId` | string | 是 | 书籍 ID |
|
||
| `count` | int | 否 | 每页数量，默认 12 |
|
||
| `maxIdx` | int | 否 | 翻页偏移，默认 0 |
|
||
| `sessionId` | string | 否 | 翻页会话 ID（首次不传，后续传回包中的值） |
|
||
|
||
**回包：**
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `booksimilar.sessionId` | 会话 ID（翻页时传入下次请求） |
|
||
| `booksimilar.books` | 推荐书籍数组 |
|
||
| `booksimilar.books[].idx` | 结果序号（下次请求 maxIdx 传最后一条的 idx） |
|
||
| `booksimilar.books[].book.bookInfo` | 书籍信息（bookId, title, author, cover 等） |
|
||
|
||
## 工作流
|
||
|
||
1. **无参数**：调 `/book/recommend` 获取个性化推荐（为你推荐）。
|
||
2. **有 bookId**：调 `/book/similar` 推荐相似书。
|
||
3. **有关键词**：调 `/store/search` 搜索发现。
|
||
4. 用户对推荐的书感兴趣时，调 `/book/info` 获取完整信息。
|
||
5. 翻页（recommend）：用 `searchIdx` 作为下次的 `maxIdx`。
|
||
6. 翻页（similar）：用最后一条的 `idx` 作为 `maxIdx`，带上 `sessionId`。
|
||
|
||
## 输出格式
|
||
- 推荐列表用编号展示，每本书含书名、作者、评分、推荐理由
|
||
- 提示用户可选择编号查看详情或继续推荐更多
|