返回首页

懒人听书

懒人听书：搜索/章节/音频

浏览: 470 最后更新: 2026-10-05 13:59:32

接口说明

懒人听书有声书三阶段接口（搜索/章节/音频直链）

子接口列表（3 个）

本接口为集合接口，包含以下子接口，依次调用即可完成完整业务链路。每个子接口均可独立调试。

子接口1：书籍搜索

关键词搜索，返回资源列表（ID/标题/封面/简介等）

API地址

http://127.0.0.1:8080/api/lrts/index.php?act=search

请求方式

GET

返回格式

JSON

参数说明

参数是否必填类型说明示例
act是string固定为 searchsearch
keyword否string搜索关键词，如：斗破苍穹斗破苍穹
page否string页码，从1开始1

请求示例

http://127.0.0.1:8080/api/lrts/index.php?act=search&keyword=%E6%96%97%E7%A0%B4%E8%8B%8D%E7%A9%B9&page=1

调用示例

http://127.0.0.1:8080/api/lrts/index.php?act=search&keyword=%E6%96%97%E7%A0%B4%E8%8B%8D%E7%A9%B9&page=1

http://127.0.0.1:8080/api/lrts/index.php?act=search&keyword=%E6%96%97%E7%A0%B4%E8%8B%8D%E7%A9%B9&page=1

返回结果

HTTP 200 OK
{"code":200,"msg":"success","data":{"keyword":"斗破苍穹","total":20,"list":[{"id":"12345","bookTitle":"书名","bookImage":"https://...","bookAnchor":"作者","bookDesc":"简介...","bookLastChapter":"最新章节"}]}}

子接口2：章节列表

按资源ID获取全部章节列表（章节ID/标题/序号，自动翻页拉全量）

API地址

http://127.0.0.1:8080/api/lrts/index.php?act=chapters

请求方式

GET

返回格式

JSON

参数说明

参数是否必填类型说明示例
act是string固定为 chapterschapters
bookId否string资源ID（来自搜索接口返回的 id）23930053
page否string页码，从1开始1

请求示例

http://127.0.0.1:8080/api/lrts/index.php?act=chapters&bookId=23930053

调用示例

http://127.0.0.1:8080/api/lrts/index.php?act=chapters&bookId=23930053

http://127.0.0.1:8080/api/lrts/index.php?act=chapters&bookId=23930053

返回结果

HTTP 200 OK
{"code":200,"msg":"success","data":{"bookId":"5174","total":2000,"chapters":[{"chapter_id":"1001","title":"第1章 开始","order":1}]}}

子接口3：音频直链

按资源ID+章节ID获取音频直链，可直接播放/下载

API地址

http://127.0.0.1:8080/api/lrts/index.php?act=audio

请求方式

GET

返回格式

JSON

参数说明

参数是否必填类型说明示例
act是string固定为 audioaudio
bookId否string资源ID（来自搜索接口返回的 id）23930053
section否string集序号（来自章节列表返回的 index）1
opType否string类型：0=试听 / 1=完整，默认11

请求示例

http://127.0.0.1:8080/api/lrts/index.php?act=audio&bookId=23930053&section=1&opType=1

调用示例

http://127.0.0.1:8080/api/lrts/index.php?act=audio&bookId=23930053&section=1&opType=1

http://127.0.0.1:8080/api/lrts/index.php?act=audio&bookId=23930053&section=1&opType=1

返回结果

HTTP 200 OK
{"code":200,"msg":"success","data":{"url":"https://cdn.example.com/audio.mp3","bookId":"5174","chapterId":"1001"}}