返回首页

喜马拉雅听书

脚本接口（parse($params) 三阶段）

浏览: 45 最后更新: 2026-10-05 13:59:21

接口说明

喜马拉雅 搜索/章节/音频

子接口列表（3 个）

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

子接口1：书籍搜索

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

API地址

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

请求方式

GET

返回格式

JSON

参数说明

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

请求示例

http://127.0.0.1:8080/api/ximalaya/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/ximalaya/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/ximalaya/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/ximalaya/index.php?act=chapters

请求方式

GET

返回格式

JSON

参数说明

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

请求示例

http://127.0.0.1:8080/api/ximalaya/index.php?act=chapters&bookId=97588365

调用示例

http://127.0.0.1:8080/api/ximalaya/index.php?act=chapters&bookId=97588365

http://127.0.0.1:8080/api/ximalaya/index.php?act=chapters&bookId=97588365

返回结果

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/ximalaya/index.php?act=audio

请求方式

GET

返回格式

JSON

参数说明

参数是否必填类型说明示例
act是string固定为 audioaudio
chapterId是string章节ID（来自章节接口返回的 chapter_id）893621625
quality否string音质：0=标准 / 1=高清 / 2=无损，默认00

请求示例

http://127.0.0.1:8080/api/ximalaya/index.php?act=audio&bookId=97588365&chapterId=893621625

调用示例

http://127.0.0.1:8080/api/ximalaya/index.php?act=audio&bookId=97588365&chapterId=893621625

http://127.0.0.1:8080/api/ximalaya/index.php?act=audio&bookId=97588365&chapterId=893621625

返回结果

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