小枸音乐API - PHP版

基于原JavaScript版本完整重构的PHP音乐搜索API

1. 获取API信息

GET index.php?action=getInfo

返回API的基本信息和支持的功能。

2. 搜索音乐

GET index.php?action=search&keyword=周杰伦&type=music&page=1

参数：

keyword - 搜索关键词（必填）
type - 搜索类型：music/album/sheet（必填）
page - 页码（默认：1）
pageSize - 每页数量（默认：20）

3. 获取播放地址

GET index.php?action=getMediaSource&id=歌曲ID&hash=歌曲hash&quality=standard

参数：

id - 歌曲ID（必填）
hash - 歌曲hash（必填）
quality - 音质：low/standard/high/super（默认：standard）

4. 获取榜单列表

GET index.php?action=getTopLists

获取酷狗音乐的各类榜单列表。

5. 获取榜单详情

GET index.php?action=getTopListDetail&id=榜单ID&title=榜单名称

参数：

id - 榜单ID（必填）
title - 榜单标题
description - 榜单描述
coverImg - 榜单封面

6. 获取歌词

GET index.php?action=getLyric&id=歌曲ID&title=歌曲标题&duration=时长

参数：

id - 歌曲ID（必填）
title - 歌曲标题（必填）
duration - 歌曲时长（毫秒）（必填）

7. 获取专辑信息

GET index.php?action=getAlbumInfo&id=专辑ID&page=1

参数：

id - 专辑ID（必填）
page - 页码（默认：1）
artwork - 专辑封面
title - 专辑标题

8. 导入歌单（酷狗码）

POST index.php?action=importMusicSheet&code=酷狗码

参数：

code - 酷狗码（纯数字）（必填）

注意：仅支持酷狗APP通过酷狗码导入，导入时间和歌单大小有关，请耐心等待。

响应格式示例：

{
    "success": true,
    "code": 200,
    "message": "success",
    "data": { ... },
    "timestamp": 1234567890,
    "platform": "小枸音乐"
}

错误响应示例：

{
    "success": false,
    "code": 400,
    "message": "错误信息",
    "data": null,
    "timestamp": 1234567890,
    "platform": "小枸音乐"
}

CLI测试示例：

// 创建API实例
$api = new XiaoGouMusicAPI();

// 搜索音乐
$result = $api->handleAction('search', [
    'keyword' => '周杰伦',
    'type' => 'music',
    'page' => 1
]);

// 获取榜单列表
$result = $api->handleAction('getTopLists', []);

// 获取歌词
$result = $api->handleAction('getLyric', [
    'id' => '歌曲hash',
    'title' => '歌曲标题',
    'duration' => 240000
]);