🔍 搜索接口

GET

/api/search - 搜索书籍

/api/search
搜索书籍、作者等内容，支持分页加载。

📝 请求参数

参数名类型必填说明
key string 是 搜索关键词
tab_type string 否 搜索类型：3=小说，2=听书，8=漫画，11=短剧，默认为3
offset integer 否 偏移量，用于分页，默认0
🧪 接口测试
输入搜索关键词
搜索内容类型
分页偏移量

📖 详情接口

GET

/api/detail - 获取书籍详情

/api/detail
获取书籍的详细信息，包括书名、作者、简介、封面等元数据。

📝 请求参数

参数名类型必填说明
book_id string 是 书籍ID
🧪 接口测试
输入书籍ID获取详细信息

📑 目录接口

GET

/api/book - 获取书籍目录

/api/book
获取书籍的完整章节目录列表，包括所有卷和章节信息。

📝 请求参数

参数名类型必填说明
book_id string 是 书籍ID（也可使用bookId参数）
🧪 接口测试
输入书籍ID获取章节目录
GET

/api/directory - 获取简化目录

/api/directory
获取书籍的简化目录信息，仅包含章节标题和ID。

📝 请求参数

参数名类型必填说明
fq_id string 是 书籍ID（也可使用bookId参数）
🧪 接口测试
输入书籍ID

📄 内容接口

GET

/api/content - 获取内容（统一接口）

/api/content
统一的内容获取接口，支持小说、听书、短剧、漫画、批量等多种类型的内容获取。根据tab参数决定返回的内容类型。

📝 请求参数

参数名类型必填说明
tab string 是 内容类型：小说、听书、短剧、漫画、批量
item_id string 条件 单个章节/视频/漫画ID（小说、听书、短剧、漫画必填）
item_ids string 条件 多个章节ID，逗号分隔（批量时必填）
book_id string 否 书籍ID（批量获取时需要）
show_html string 否 漫画是否返回HTML格式（0或1，默认0）
tone_id string 否 有声书音色ID（听书时使用，默认0）
async string 否 漫画异步模式（0或1，默认1）
💡 Tab参数说明：

小说 - 获取单个小说章节（需要item_id）

听书 - 获取有声书音频地址（需要item_id，可选tone_id）

短剧 - 获取短剧视频信息（需要item_id）

漫画 - 获取漫画图片（需要item_id）

批量 - 批量获取多个章节内容（需要item_ids和book_id）

🧪 接口测试
选择内容类型
单个章节/视频/漫画ID
GET

/api/chapter - 获取章节（简单接口）

/api/chapter
简化版的章节获取接口，直接返回章节文本内容。
参数名类型必填说明
item_id string 是 章节ID
🧪 接口测试
GET

/api/raw_full - 获取原始内容

/api/raw_full
获取未处理的原始章节内容，包含完整的响应数据。
参数名类型必填说明
item_id string 是 章节ID
🧪 接口测试
GET

/api/manga/progress/:task_id - 查询漫画下载进度

/api/manga/progress/:task_id
查询异步漫画下载任务的进度和状态。
参数名类型必填说明
task_id string 是 任务ID（路径参数）
🧪 接口测试
从漫画接口返回的任务ID
GET

/api/ios/content - 获取iOS内容

/api/ios/content
使用iOS平台的接口获取章节内容，使用8402算法签名。
参数名类型必填说明
item_id string 是 章节ID
💡 iOS接口说明：

此接口使用iOS设备池和8402算法进行签名，适用于需要iOS平台特定功能的场景。

🧪 接口测试
输入章节ID
GET

/api/ios/register - 注册iOS设备

/api/ios/register
注册新的iOS设备到设备池。
🧪 接口测试

💬 评论接口

GET

/api/comment - 获取评论

/api/comment
获取书籍、章节或其他内容的评论列表，支持分页。
参数名类型必填说明
book_id string 是 书籍ID
count integer 否 每页数量，默认20
offset integer 否 偏移量，默认0
🧪 接口测试

📱 设备管理接口

GET

/api/device/pool - 设备池状态

/api/device/pool
查看设备池的整体状态，包括所有注册设备。
🧪 接口测试
GET

/api/device/register - 注册设备

/api/device/register
注册新的设备到设备池。
参数名类型必填说明
platform string 否 平台类型：android或ios，默认android
🧪 接口测试
GET

/api/device/status - 查看设备状态

/api/device/status
查看指定平台的设备状态。
参数名类型必填说明
platform string 否 平台类型：android或ios，默认android
🧪 接口测试

📌 通用说明

🔐 授权验证

除首页、文档页和授权状态接口外，所有API接口都需要通过授权验证。请确保您的域名已在授权列表中。

📊 响应格式

所有接口返回统一的JSON格式：

{ "code": 200, "message": "success", "data": {...}, "elapsed_ms": 150 }

⚠️ 错误码说明

错误码说明
200请求成功
400请求参数错误
403未授权或授权已过期
404资源不存在
500服务器内部错误

🎯 最佳实践

  • 使用批量接口时，建议单次请求不超过100个章节
  • 漫画内容建议使用异步模式（async=1）以获得更快的响应速度
  • 合理使用分页参数，避免一次性加载过多数据
  • 建议对频繁访问的数据进行本地缓存
  • 请妥善保管授权信息，避免泄露

📝 更新日志

  • v2.0 - 新增漫画异步下载功能，支持进度查询
  • v1.5 - 优化批量获取性能，新增原始内容接口
  • v1.0 - 首次发布，支持基本的内容获取功能