/ 文章
API - 接口更新日志
接口更新记录
📌 本页面用于记录全站接口的变更历史，建议收藏并定期查看。
接口地址：
/api/{分类}/{接口}/index.php（各接口详情见对应 API 详情页）
通用约定：所有请求需携带key=密钥；响应code=0表示成功
目录
📅 2026-10-05
🍅 番茄小说 API（/api/book/fanqie/）
- **修复搜索翻页重复错乱**：`search_tab` 为多 tab 聚合"推荐流"，服务端每次请求都会重新洗牌，此前用其游标翻页会出现大量重复。现推荐改用 `search_page` 会话游标翻页（与 App 协议一致，实测连翻 4 页零重复） - 修复搜索内容不对版、错乱等问题 - 修复 `search_page` 返回结果缺失封面（`thumb_url`）的问题 | action | 说明 | 实测 | | --- | --- | :---: | | `search_page` | 搜索分页（App 真实翻页协议，**推荐翻页统一用它**） | ✅ | | `search_suggest` | 输入框联想词 | ✅ | | `search_cue` | 搜索页默认提示词 | ✅ | | `book_comment` | 书评列表 | ✅ | | `item_comment` | 章节段评列表 | ✅ | | `comment_reply` | 评论回复（`service_id`：0=章评 1=段评 2=书评 4=新版章评 5=话题评） | ✅ | | `urge_update` | 催更信息（只读） | ✅ | | `recommend_book` | 相似书推荐 | ✅ | | `author_book` | 作者作品列表 | ✅ | | `user_basic_info` | 用户公开信息 | ✅ | | `read_progress` | 阅读进度（匿名设备维度） | ✅ | | `rpc` | 通用调试：对任意 `/reading/` 路径发起签名请求 | ✅ | - `search`（旧版单列表）与 `search_tab`（多 tab）均为服务端洗牌列表，**不建议用于翻页**，仅适合首屏浏览 - 需要翻页请使用 `search_page`：第 1 页正常请求，之后把响应中的 `next_offset` + `search_id` + `passback` **原样回传**即可继续翻页，`has_more=false` 时停止 #### 搜索类 ```bash # 多 tab 搜索浏览（综合1 / 听书2 / 书籍3 / 社区4 / 全文5 / 用户6 / 漫画8 / 短剧11 / 买书13 / 漫剧19） ?action=search_tab&q=剑来&tab_type=3 # 搜索翻页（✅ 推荐翻页统一用此接口，会话游标零重复） ?action=search_page&q=剑来&offset=0 # 第 2 页 = 原样回传上一页的 next_offset / search_id / passback（需 URL 编码） ?action=search_page&q=剑来&offset=10&search_id=202610051244...&passback=10 # 旧版单列表搜索（洗牌列表，不建议翻页） ?action=search&q=剑来&limit=10&tab_type=1 # 输入框联想词（返回 words[] 简单词 + items[] 富信息） ?action=search_suggest&q=剑来 # 搜索页默认提示词 ?action=search_cue # 搜索热榜 ?action=hot_search&limit=20 ``` #### 书籍 / 阅读类 ```bash # 书籍详情 ?action=book_detail&book_id=7233717404444920893 # 章节目录（count=0 返回全部） ?action=directory&book_id=7233717404444920893&offset=0&count=50 # 章节正文 ?action=content&book_id=7233717404444920893&item_id=7233717408299655743 # 新版结构化正文 ?action=newfull&book_id=7233717404444920893&item_id=7233717408299655743 # 整本打包下载 ?action=download&book_id=7233717404444920893 # 排行榜 / 分类 / 书城首页 ?action=rank&rank_type=1&category_id=0 ?action=category ?action=homepage ``` #### 社区评论类 ```bash # 书评列表（sort：smart_hot 热门 / time 最新） ?action=book_comment&book_id=7233717404444920893&sort=smart_hot&offset=0 # 章节段评（need_reply=1 同时带回前几条回复） ?action=item_comment&book_id=7233717404444920893&item_id=7233717408299655743 # 评论回复（service_id：0=章评 2=书评；comment_id / group_id 从评论列表取） ?action=comment_reply&book_id=6650096232679083012&comment_id=6821354989014368270&group_id=6650096232679083012&service_id=2 # 催更信息（只读） ?action=urge_update&book_id=6650096232679083012&item_id=6650610303929172493 ``` > 💡 **评论链路**：`book_comment` / `item_comment` 拿到评论的 `comment_id` + `group_id` → `comment_reply` 查回复。翻页均为 `offset` 递增。 #### 推荐 / 用户类 ```bash # 相似书推荐（详情页"还在看"） ?action=recommend_book&book_id=7233717404444920893 # 读完结页推荐（需登录态，匿名返回 100201 属预期） ?action=lastpage_recommend&book_id=7233717404444920893 # 作者作品列表 / 用户公开信息（user_id 从评论列表的 user_info.user_id 获取） ?action=author_book&user_id=xxx ?action=user_basic_info&user_id=xxx # 阅读进度（匿名设备维度） ?action=read_progress ``` #### 音频 / TTS 类 ```bash # 发音人列表（audio 前先取 tone_id） ?action=tones&book_id=7233717404444920893 ?action=tone_info&book_id=7233717404444920893 # TTS 音频播放信息（返回 url + cek 解密密钥；tone_id 留空自动匹配该章节可用音色） ?action=audio&book_id=7233717404444920893&item_ids=7233717408299655743&tone_id=1 # 流式 TTS 分段（返回每段音频 URL + 真实时长 + 句子定位，可用于精确字幕） ?action=streamtts_item&book_id=7233717404444920893&item_id=7233717408299655743 ``` #### 播放 / 下载类 ```bash # 在线播放（流式输出，url/cek 来自 audio/content 返回） ？？？？？？？？？？？？？？？ # 下载保存（filename 可选，指定保存文件名） ？？？？？？？？？？？？？？？ ``` #### 视频短剧类 ```bash # 剧集列表（search_tab tab_type=11/19 结果里的 series_id） ?action=video_detail&series_id=7648239924516244542 # 播放地址（逗号分隔多个 vid） ?action=video_info&vids=7648241885093301272 ``` #### 设备 / 调试类 ```bash # 设备注册（rotate=1 强制换新设备；applog=1 执行 AppLog 注册） ?action=device_register # 通用调试：对任意 /reading/ 开头的番茄路径发起签名请求（探索未封装接口用） ?action=rpc&path=/reading/bookapi/search/page/v:version/&query=剑来&offset=0 ```本次重构番茄小说接口：修复搜索问题，新增 12 个方法。以下内容较多，已折叠分组，点击展开。
📅 历史记录
📅 2026-09-XX
- 待补充
📅 2026-08-XX
- 待补充
更早记录已归档，如需查阅请联系管理员。
📮 反馈与支持
如对本次更新有疑问，可通过以下方式联系我们：
- 📧 邮箱：vsaaapi@qq.com
- 💬 交流群：见首页底部
- 📝 工单：首页 → API 详情 → 接口反馈
本记录最终解释权归本站所有，更新内容以实际线上接口为准。